a11y Updates Requested NPM Resource Changed PR-6.2-dev Pending

User tests: Successful: Unsuccessful:

avatar mbeganyi-a11y
mbeganyi-a11y
6 Oct 2026

Carrying on the work from @AchalShrivastava's PR #48438, I have updated the CSS to target only the .loginsupport module and not the entire wrapper. I have also updated the base branch to target 6.2-dev.

Pull Request resolves #48429.

  • I read the Generative AI policy and my contribution is either not created with the help of AI or is compatible with the policy and GNU/GPL 2 or later.

Summary of Changes

  • Increased the target size of the "Need Support?" links on the Joomla Administrator login page.
  • Set the links to a 24px line-height and inline-block display.
  • Changes are ONLY applied to the .loginsupport module and not the entire wrapper, thus not changing the entire layout of the login page.

Testing Instructions

  1. Open the Joomla Administrator login page.
  2. Inspect the Support Forum, Documentation, and News links using the browser's developer tools/code inspector
  3. Verify that each link has a line-height of 24px and display: inline-block; attributes set within the CSS of each link.
  4. Verify that the links receive keyboard focus indication. This can be done by using the Tab key to reach the links with the keyboard.
  5. If desired, compare this PR's login screen to that of a standard Joomla installation. Note that this PR has only been applied to the "Need Support?" links. No other areas of the login screen are affected.

Actual result BEFORE applying this Pull Request

The "Need Support?" links had a target height of approximately 16.5px, which does not meet the 24px minimum target size requirement of WCAG SC 2.5.8.

Expected result AFTER applying this Pull Request

The "Need Support?" links have a 24px target height in accordance with WCAG SC 2.5.8.

Link to documentations

Please select:

  • Documentation link for guide.joomla.org:

  • No documentation changes for guide.joomla.org needed

  • Pull Request link for manual.joomla.org:

  • No documentation changes for manual.joomla.org needed

avatar mbeganyi-a11y mbeganyi-a11y - open - 6 Oct 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 6 Oct 2026
Status New ⇒ Pending
avatar joomla-cms-bot joomla-cms-bot - change - 6 Oct 2026
Category ⇒ NPM Change
avatar coolcat-creations coolcat-creations - test_item - 6 Oct 2026 - Tested successfully
avatar coolcat-creations
coolcat-creations - comment - 6 Oct 2026

I have tested this item ✅ successfully on c3e460f

Confirmed that the links now have 24px height.


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar coolcat-creations
coolcat-creations - comment - 6 Oct 2026

I have tested this item ✅ successfully on c3e460f

Confirmed that the links now have 24px height.


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar mbeganyi-a11y mbeganyi-a11y - change - 6 Oct 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 6 Oct 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 6 Oct 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 6 Oct 2026
avatar tecpromotion tecpromotion - test_item - 6 Oct 2026 - Tested successfully
avatar tecpromotion
tecpromotion - comment - 6 Oct 2026

I have tested this item ✅ successfully on c3e460f


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar tecpromotion
tecpromotion - comment - 6 Oct 2026

I have tested this item ✅ successfully on c3e460f


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar tecpromotion
tecpromotion - comment - 6 Oct 2026

I have tested this item ✅ successfully on c3e460f


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

Verification

"Need Support?" links Before After
display / line-height inline / 21px inline-block / 24px
Target height (3 links) 16.5px 24.5px
Module height 88.7px 97.7px
  • Same result at 1668px and 375px viewport width; link widths unchanged, no additional horizontal overflow.
  • All three links receive keyboard focus with a visible focus outline.
  • The rule exists once in the compiled template.css / template.min.css; nothing else on the login page is affected.

"Before" was measured on the same page with the new rule's two declarations removed. RTL not tested.

Suggestion (not blocking)

The fixed line-height: 24px no longer scales with the text. With the root font size at 200% (links 28px) the line-height stays 24px, where it was 42px before, so the two links that wrap get tight lines (two-line link: 52.5px instead of 75px).

.com_login .sidebar-wrapper #sidebar .loginsupport a {
  display: inline-block;
  line-height: max(24px, 1.5em);
}

Tested: 24.5px target height at default size, 42px line-height at 200%.

Why it scaled before: the links had no own line-height and inherited the unitless body { line-height: var(--body-line-height) } with --body-line-height: 1.5 (computed 21px at 14px, 42px at 28px, ratio 1.50 on every ancestor up to body).

Screenshots (yellow outline added to show the link box; 200% = root font size 200%, not page zoom):

100% 200% text
Before 1-before-100.png 3-before-200.png
PR 2-pr-100.png 4-pr-200.png
Suggested – 5-suggested-200.png

1-before-100
1-before-100

2-pr-100
2-pr-100

3-before-200
3-before-200

4-pr-200
4-pr-200

5-suggested-200
5-suggested-200

avatar rdeutz rdeutz - change - 6 Oct 2026
Status Pending ⇒ Ready to Commit
avatar rdeutz
rdeutz - comment - 6 Oct 2026

2 successful test -> RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar rdeutz
rdeutz - comment - 6 Oct 2026

2 successful test -> RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar bembelimen
bembelimen - comment - 7 Oct 2026

We should avoid using "px" I guess? We better go for the bootstrap classes: https://getbootstrap.com/docs/5.3/utilities/text/#line-height this also does not increase the css file.

avatar chmst
chmst - comment - 7 Oct 2026

I am not happy with this solution. My Browsers, Firefox and Chrome, increase the icons together with the font
and following the WCAG rules the icons are "accessible".

From css point of view our rule was not mixing realtive values with fix values.
Regarding the KI screens I would reject the PR. Only very small fingers and good eyes can use this icon next to the huge text.

avatar chmst
chmst - comment - 7 Oct 2026

I am not happy with this solution. My Browsers, Firefox and Chrome, increase the icons together with the font
and following the WCAG rules the icons are now "accessible".

From css point of view our rule was not mixing realtive values with fix values.
Regarding the KI screens I would reject the PR. Only very small fingers and good eyes can use this icon next to the huge text.

avatar brianteeman
brianteeman - comment - 7 Oct 2026

even mdn recommends NOT to use units for the line height

line-height: 1.75;

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 7 Oct 2026

I agree with everything that has been brought up here. All I wanted to do with this PR was get the issue resolved that flagged the proximity of the links as a WCAG SC 2.5.8 failure. It's my belief that WCAG is the floor, not the ceiling, so if we all can agree on a better way forward with the spacing, I'm happy to support it and help implement it. Again, I just wanted to correct the failure. However, there's no limit to the UX improvements that go beyond the baseline of WCAG.

avatar brianteeman
brianteeman - comment - 7 Oct 2026

its not enough to put a band aid on something to tick a checkbox

avatar C-Lodder
C-Lodder - comment - 9 Oct 2026

@brianteeman is correct.

Using unit for line-height is poor practice.
Take the following into consideration:

.element {
  font-size: 16px;
  line-height: 24px;
}

This will give decent spacing between the text.

A user with visual impairments has their browser base font-size set to `24px` (or more).

The `line-height` now matches the `font-size`, which isn't acceptable.

The reason we **don't** use units for `line-height` is so that the height dynamically changes when the font-size does.

Better to use `line-height: 1.6`, which is 1.6x the `font-size`.
avatar C-Lodder
C-Lodder - comment - 9 Oct 2026

@brianteeman is correct.

Using unit for line-height is poor practice.
Take the following into consideration:

.element {
  font-size: 16px;
  line-height: 24px;
}

This will give decent spacing between the text.

A user with visual impairments has their browser base font-size set to 24px (or more).

The line-height now matches the font-size, which isn't acceptable.

The reason we don't use units for line-height is so that the height dynamically changes when the font-size does.

Better to use line-height: 1.6, which is 1.6x the font-size.

avatar C-Lodder
C-Lodder - comment - 9 Oct 2026

@brianteeman is correct.

Using units for line-height is poor practice.
Take the following into consideration:

.element {
  font-size: 16px;
  line-height: 24px;
}

This will technically give decent spacing between the text, however if a user with visual impairments has their browser base font-size set to 24px (or more), the line-height will then match the font-size, which isn't acceptable.

The reason we don't use units for line-height is so that the height dynamically changes when the font-size does.

Better to use line-height: 1.6, which is 1.6x the font-size.

avatar brianteeman
brianteeman - comment - 9 Oct 2026

and just for completeness thats exactly what the bootstrap class that @bembelimen does

avatar brianteeman
brianteeman - comment - 9 Oct 2026

and just for completeness thats exactly what the bootstrap class that @bembelimen mentioned does although personally I would use scss and not a class thats just a matter of taste

avatar bembelimen bembelimen - change - 9 Oct 2026
Status Ready to Commit ⇒ Pending
Labels Added: NPM Resource Changed a11y Updates Requested PR-6.2-dev
avatar bembelimen
bembelimen - comment - 9 Oct 2026

Remove RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar bembelimen
bembelimen - comment - 9 Oct 2026

Remove RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48582.

avatar mbeganyi-a11y mbeganyi-a11y - change - 9 Oct 2026
Labels
avatar mbeganyi-a11y
mbeganyi-a11y - comment - 9 Oct 2026

Thanks for the feedback, @C-Lodder. I chose 1.72 as the line height given the default state computed font size is 14px and 1.6 wouldn't quite get us to 24px.

Add a Comment

Login with GitHub to post a comment