Page MenuHomePhabricator

Section-level images: Accessibility improvements
Open, LowPublic

Description

Review accessibly issues discovered in QA. Fix the noted issues, or create separate tasks for the work if they are related to larger issues or would require significant effort.

User story & summary:

As an individual with a disability, I want to have an accessible experience with the new section-level "add an image" task, so I can fully take advantage of all Wikipedia features and functions.

Description:

List what was checked & tools used:

  • Tools: Chrome Devtools Lighthouse; Firefox Accessibility check
  • What was checked: keyboard navigation, contrast

List the accessibility issues found so that the UX designer can evaluate the readiness of the features for the upcoming release:

IssueElement LocationCriticality / Recommendations
Clickable elements must be focusable and should have interactive semanticsfigcaption class="ve-ce-branchNode ve-ce-activeNode mw-ge-recommendedImageCaption mw-ge-recommendedImageCaption--with-placeholder ve-ce-activeNode-active"
Interactive elements must be focusablediv.mw-ge-recommendedImage-detailsButton

Note:

  • Both issues were reported on the recommended image placeholder:
    Screen Shot 2023-06-07 at 3.09.34 PM.png (730×558 px, 113 KB)
  • Both issues are not specific to section level image suggestions; the same issues exist for Add image
Acceptance Criteria:

Review accessibly issues discovered in QA. Fix the noted issues, or create separate tasks for the work if they are related to larger issues or would require significant effort.

Event Timeline

KStoller-WMF renamed this task from Section-level images: Accessibility check to Section-level images: Accessibility improvements.Jun 12 2023, 4:53 PM
KStoller-WMF removed Etonkovidova as the assignee of this task.
KStoller-WMF lowered the priority of this task from High to Low.
KStoller-WMF updated the task description. (Show Details)
KStoller-WMF added a subscriber: Etonkovidova.

I believe if we fix the focusable element issue, that should unblock T312294: Add image: Create end-to-end test to verify saved content

Regarding the first item:

Clickable elements must be focusable and should have interactive semantics
figcaption class="ve-ce-branchNode ve-ce-activeNode mw-ge-recommendedImageCaption mw-ge-recommendedImageCaption--with-placeholder ve-ce-activeNode-active"

I believe this has something to do with us making a <figcaption> into an editable element. I think the accessibility standards want it to be a textarea?

I'm having a difficult time testing my changes to confirm that theory with either browser's accessibility checker since getting this section visible requires interaction with a fresh page. Anyone have insight?

Change 938963 had a related patch set uploaded (by KMorgan; author: KMorgan):

[mediawiki/extensions/GrowthExperiments@master] Add section image: Accessibility tabindex change

https://gerrit.wikimedia.org/r/938963

Regarding the first item:

Clickable elements must be focusable and should have interactive semantics
figcaption class="ve-ce-branchNode ve-ce-activeNode mw-ge-recommendedImageCaption mw-ge-recommendedImageCaption--with-placeholder ve-ce-activeNode-active"

I believe this has something to do with us making a <figcaption> into an editable element. I think the accessibility standards want it to be a textarea?

In my keyboard tests I can't focus to none of the interactive elements inside the CERecommendedImageNode: the thrash button, (i) View image details link, caption text area or (?) help with writing. Probably due to the fact we set VEs surface in read-only mode (I think at least that adds contenteditable="false" as an html attribute).

I'm having a difficult time testing my changes to confirm that theory with either browser's accessibility checker since getting this section visible requires interaction with a fresh page. Anyone have insight?

I'm able to test the changes in 938963 with FF without a page reload by starting a section image task and using the Accessibility tab once the caption is displayed. Here's an example:

Screenshot 2023-07-18 at 17.37.29.png (2×3 px, 1 MB)

In general I think the keyboard support in this interface is gonna be tricky to achieve if we don't disable the read-only mode which has it's own problems (users can drag chunks of content by accident, specially o mobile). I'm not sure if VE has a way to choose which parts of the content should be disabled for edition or a way of supporting keyboard friendly read-only content 🤔. Not sure if it is worth asking about this use case to the Edit team, or we have prior research work around this cc @Tgr @RHo

Regarding the first item:

Clickable elements must be focusable and should have interactive semantics
figcaption class="ve-ce-branchNode ve-ce-activeNode mw-ge-recommendedImageCaption mw-ge-recommendedImageCaption--with-placeholder ve-ce-activeNode-active"

I believe this has something to do with us making a <figcaption> into an editable element. I think the accessibility standards want it to be a textarea?

In my keyboard tests I can't focus to none of the interactive elements inside the CERecommendedImageNode: the thrash button, (i) View image details link, caption text area or (?) help with writing. Probably due to the fact we set VEs surface in read-only mode (I think at least that adds contenteditable="false" as an html attribute).

I'm having a difficult time testing my changes to confirm that theory with either browser's accessibility checker since getting this section visible requires interaction with a fresh page. Anyone have insight?

I'm able to test the changes in 938963 with FF without a page reload by starting a section image task and using the Accessibility tab once the caption is displayed. Here's an example:

Screenshot 2023-07-18 at 17.37.29.png (2×3 px, 1 MB)

In general I think the keyboard support in this interface is gonna be tricky to achieve if we don't disable the read-only mode which has it's own problems (users can drag chunks of content by accident, specially o mobile). I'm not sure if VE has a way to choose which parts of the content should be disabled for edition or a way of supporting keyboard friendly read-only content 🤔. Not sure if it is worth asking about this use case to the Edit team, or we have prior research work around this cc @Tgr @RHo

I'm unaware of research around this but do think it is worthwhile checking with the Editing team, and perhaps Front End group in general. DST has been conducting an a11y audit of Codex components recently as well (see T341493) so they may have some insight to share.

I just noticed that FF accessibility test argues about the color contrast issues in the RecommendedImageNode texts:

  • View image details
  • Write a short caption describing...

Screenshot 2023-07-19 at 12.11.42.png (1×3 px, 1 MB)

These seem easy to fix if we get some color specification cc @RHo @JFernandez-WMF

Surprisingly the article text content is also yielding the same contrast issue:

Screenshot 2023-07-19 at 12.15.11.png (2×3 px, 1 MB)

I haven't found a VE issue for this, I can file it if we identify this to be an issue cc @RHo and ping editing team.

I just noticed that FF accessibility test argues about the color contrast issues in the RecommendedImageNode texts:

  • View image details
  • Write a short caption describing...

Screenshot 2023-07-19 at 12.11.42.png (1×3 px, 1 MB)

These seem easy to fix if we get some color specification cc @RHo @JFernandez-WMF

Hiya, can we use for the text-colour @color-subtle (#54595d) instead? Thanks!

image.png (790×1 px, 105 KB)

Surprisingly the article text content is also yielding the same contrast issue:

Screenshot 2023-07-19 at 12.15.11.png (2×3 px, 1 MB)

I haven't found a VE issue for this, I can file it if we identify this to be an issue cc @RHo and ping editing team.

@KMorgan-WMF, any update on this work? Will you move this to "In Progress" on the Phabricator Workboard if you are working on this?