RTC Language Change a11y PR-6.2-dev a11y-priority-minor (Low) Pending

User tests: Successful: Unsuccessful:

avatar mbeganyi-a11y
mbeganyi-a11y
13 Sep 2026

Updates the default.php of the Extension Installer to allow assistive technology to receive information about the file upload maximum size without needing to move focus away from the "Upload and Install" button.

Pull Request resolves #48393.

  • 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

Associates the maximum extension package upload size with the Upload & Install button in the Extensions Install screen so that the maximum upload file size is conveyed to assistive technology without focus needing to move from the button..

The existing maximum upload size text is given an ID and is referenced by the button using aria-describedby.

Testing Instructions

  1. Log in to the Joomla administrator interface
  2. Navigate to System → Install → Extensions
  3. Open the Upload Package File tab
  4. Confirm the maximum upload-size text remains visibly displayed
  5. Start a screen reader (NVDA, JAWS, VoiceOver) and focus the "Or browse for file" button
  6. Confirm that the maximum upload size information is conveyed to assistive technology without needing to move focus away from the button

Actual result BEFORE applying this Pull Request

  1. The maximum upload size information is visible on screen, but it is not programmatically associated with the Upload & Install button, and
  2. A screen reader user can focus the button without the maximum permitted upload size being conveyed.

Expected result AFTER applying this Pull Request

When the Upload & Install button receives focus, a screen reader announces the maximum upload size information in addition to the button label.

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 - 13 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 13 Sep 2026
Status New ⇒ Pending
avatar joomla-cms-bot joomla-cms-bot - change - 13 Sep 2026
Category ⇒ Front End Plugins
avatar mbeganyi-a11y mbeganyi-a11y - edited - 13 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 13 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 13 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - edited - 13 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 13 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 13 Sep 2026
avatar brianteeman
brianteeman - comment - 13 Sep 2026

@mbeganyi-a11y please check your work to make sure it does what you think it will do before submitting a PR - this can not do what you intend it to do at all - you can not have tested it

avatar tecpromotion
tecpromotion - comment - 14 Sep 2026

@mbeganyi-a11y please check your work to make sure it does what you think it will do before submitting a PR - this can not do what you intend it to do at all - you can not have tested it

I’ve just had a look at it myself, and @brianteeman is right. The code is neither correct nor tested.

What’s more, it’s actually more of a feature than a bug, which means it belongs in 6.3-dev.
I’d recommend that you close the PR and, if necessary, open a new, tested one for 6.3.

avatar rdeutz
rdeutz - comment - 14 Sep 2026

@mbeganyi-a11y yYou made the change for the legacy upload button and not for the usual one. So this is only working in some circumstances.

avatar rdeutz
rdeutz - comment - 14 Sep 2026

@mbeganyi-a11y You made the change for the legacy upload button and not for the usual one. So this is only working in some circumstances.

avatar brianteeman
brianteeman - comment - 14 Sep 2026

not even sure if that code is ever used anywhere

avatar rdeutz
rdeutz - comment - 14 Sep 2026

Look as it is used when upload is in non form context. Seems like a left over from the last century.

avatar brianteeman
brianteeman - comment - 14 Sep 2026

And we never have non form upload do we?

avatar chmst
chmst - comment - 14 Sep 2026

And we never have non form upload do we?

It is a hiden area with a form. This old and unused area should be removed from the layout.

avatar brianteeman
brianteeman - comment - 15 Sep 2026

the code in this layout and the accompanying JS was for support in browsers that do not support FormData which Joomla no longer supports anyway https://caniuse.com/mdn-api_formdata

I would do a PR to remove this code which will never be used but dont know which version to make it for or if this needs to be deprecated first (which seems pointless but the rules might require it)

avatar brianteeman
brianteeman - comment - 15 Sep 2026

the code in this layout and the accompanying JS was for support in browsers that do not support FormData which Joomla no longer supports anyway https://caniuse.com/mdn-api_formdata

I would do a PR to remove this code which will never be used but dont know which version to make it for or if this needs to be deprecated first (which seems pointless but the rules might require it)

avatar brianteeman
brianteeman - comment - 15 Sep 2026

the code in this layout and the accompanying JS was for support in browsers that do not support FormData which Joomla no longer supports anyway https://caniuse.com/mdn-api_formdata

I would do a PR to remove this code which will never be used but dont know which version to make it for or if this needs to be deprecated first (which seems pointless but the rules might require it)

avatar chmst
chmst - comment - 15 Sep 2026

I suggest a PR for 6.3. There is no b/c break and deprecation is pointless.

avatar HLeithner
HLeithner - comment - 15 Sep 2026

please target 7.0, thanks

avatar brianteeman
brianteeman - comment - 15 Sep 2026

ok - I was completely wrong - the code is used.

when you use the install from web option and click on install then this fieldset is displayed and used

thorium_yTivLfO4B0.mp4
avatar brianteeman
brianteeman - comment - 15 Sep 2026

SORRY - I was completely wrong - the code is used.

when you use the install from web option and click on install then this fieldset is displayed and used

thorium_yTivLfO4B0.mp4
avatar brianteeman
brianteeman - comment - 15 Sep 2026

SORRY - I was completely wrong - the code is used.

when you use the install from web option and click on install then this fieldset is displayed and used

thorium_yTivLfO4B0.mp4
avatar chmst
chmst - comment - 15 Sep 2026

You know what I never did in the last 12 years? Install from web ^^

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 16 Sep 2026

OK this is all interesting and I'm glad to have...uh...partially solved something but not what I was aiming to solve.

I will amend this PR to include the primary button and not only the one in the sidebar as Brian's video demonstrates.

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 16 Sep 2026

OK this is all interesting and I'm glad to have..uh..partially solved something but not what I was aiming to solve.

For the maintainers, what's easiest? Should I relabel this PR and create a new one for the intended fix or can I modify this one with additional commits? I was originally thinking a new branch for the intended issue would be best, but please do let me know.

avatar mbeganyi-a11y mbeganyi-a11y - change - 19 Sep 2026
Labels Added: a11y PR-6.1-dev a11y-priority-minor (Low)
avatar brianteeman
brianteeman - comment - 20 Sep 2026

no idea what i was thinking of #48452 (comment) just ignore that comment it was garbage

avatar brianteeman
brianteeman - comment - 20 Sep 2026

irrelevant of my mistaken comment @mbeganyi-a11y you still can not have tested this PR as it would have been impossible for you to have tested the hidden form

avatar brianteeman
brianteeman - comment - 20 Sep 2026

irrelevant of my mistaken comment @mbeganyi-a11y you still can not have tested this PR as it would have been impossible for you to have tested the changes you have made in the hidden form

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 21 Sep 2026

In my haste I forgot to revert the initial commit, which I will do now. Thus this PR will only target the intended "Or browse for file" button in the "Upload Package File" tab of the Extension Installer.

avatar mbeganyi-a11y mbeganyi-a11y - change - 21 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 21 Sep 2026
avatar rdeutz rdeutz - test_item - 21 Sep 2026 - Tested successfully
avatar rdeutz
rdeutz - comment - 21 Sep 2026

I have tested this item ✅ successfully on af181e3

Tested with voice over on mac I can hear the additional information about the upload size.


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

avatar rdeutz
rdeutz - comment - 21 Sep 2026

I have tested this item ✅ successfully on af181e3

Tested with voice over on mac I can hear the additional information about the upload size.


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

avatar coolcat-creations coolcat-creations - test_item - 21 Sep 2026 - Tested successfully
avatar coolcat-creations
coolcat-creations - comment - 21 Sep 2026

I have tested this item ✅ successfully on 5b24ce6

Tested Successfully the download size is now in the voiceover. Tested with VoiceOver on a Mac. Thank you for the PR!


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

avatar coolcat-creations
coolcat-creations - comment - 21 Sep 2026

I have tested this item ✅ successfully on 5b24ce6

Tested Successfully the download size is now in the voiceover. Tested with VoiceOver on a Mac. Thank you for the PR!


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

avatar QuyTon QuyTon - alter_testresult - 21 Sep 2026 - rdeutz: Tested successfully
avatar QuyTon QuyTon - change - 21 Sep 2026
Status Pending ⇒ Ready to Commit
avatar QuyTon
QuyTon - comment - 21 Sep 2026

RTC


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

avatar QuyTon
QuyTon - comment - 21 Sep 2026

RTC


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

avatar mbeganyi-a11y mbeganyi-a11y - change - 25 Sep 2026
Title
…
[6.1] Extensions Install: Upload from File: Associate upload limit with Upload & Install button
[6.2] Extensions Install: Upload from File: Associate upload limit with Upload & Install button
avatar mbeganyi-a11y mbeganyi-a11y - edited - 25 Sep 2026
avatar brianteeman
brianteeman - comment - 2 Oct 2026

Tested with NVDA ✔️
Tested with Windows Narrator ✖️
That may be a narrator issue not a markup issue. Not all screen readers behave the same - tested with all levels of verbosity but the description is never announced.

I wonder if the button should be changed from "Or browse for file" to just "Browse for file"

It only makes sense to have "or" if you can see and read "Drag and drop file here to upload. Or browse for file"

avatar rdeutz
rdeutz - comment - 5 Oct 2026

@brianteeman should we open a new PR/Issue/discussion about the wording, seems to me out of scope of this PR

avatar brianteeman
brianteeman - comment - 5 Oct 2026

To me it's all the same problem. Not even sure if the first sentence should be hidden from screen readers.

avatar mbeganyi-a11y
mbeganyi-a11y - comment - 5 Oct 2026

Tested with NVDA ✔️ Tested with Windows Narrator ✖️ That may be a narrator issue not a markup issue. Not all screen readers behave the same - tested with all levels of verbosity but the description is never announced.

I wonder if the button should be changed from "Or browse for file" to just "Browse for file"

It only makes sense to have "or" if you can see and read "Drag and drop file here to upload. Or browse for file"

Interesting. I tested with Narrator on Windows 10 and got the announcement in Edge, Firefox, and Chrome. Not sure your setup but that's strange. Narrator can be finicky. I'm glad NVDA works though.

Regarding the text change, screen reader users often navigate using the arrow keys, so finding that text above the button isn't impossible. If wanting to change it, moving the "or" from the control to the text preceding the button would be fine. As long as the core meaning of the control isn't affected, we're safe.

avatar brianteeman
brianteeman - comment - 5 Oct 2026

Regarding the text change, screen reader users often navigate using the arrow keys, so finding that text above the button isn't impossible

only if they know there is text present

personally I would remove the OR completely as its redundant text

avatar mbeganyi-a11y mbeganyi-a11y - change - 6 Oct 2026
Labels Added: RTC PR-6.2-dev
avatar joomla-cms-bot joomla-cms-bot - change - 6 Oct 2026
Category Front End Plugins ⇒ Administration Language & Strings Front End Plugins
avatar mbeganyi-a11y
mbeganyi-a11y - comment - 6 Oct 2026

Regarding the text change, screen reader users often navigate using the arrow keys, so finding that text above the button isn't impossible

only if they know there is text present

personally I would remove the OR completely as its redundant text

Screen reader users often explore pages using arrow keys as not everything is revealed when pressing only the Tab key.

I've updated the .ini file to remove the word "Or". This is an English-only change, and given that I'm not intimately familiar with the translation workflow, I'm hoping this is sufficient to cover other languages as well. Please advise if I'm mistaken.

avatar brianteeman
brianteeman - comment - 7 Oct 2026

tested again with windows narrator and it still doesnt announce the aria-described by


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48452.
avatar brianteeman
brianteeman - comment - 7 Oct 2026

tested again with windows narrator and it still doesnt announce the aria-described by


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/48452.
avatar rdeutz rdeutz - change - 19 Oct 2026
Labels Added: Language Change
Removed: PR-6.1-dev

Add a Comment

Login with GitHub to post a comment