Skip to content

Updated VoiceOver text according to the feedback #5233

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from

Conversation

anvithagowda098
Copy link

@anvithagowda098 anvithagowda098 commented Mar 28, 2025

Phabricator: https://phabricator.wikimedia.org/T358301

Notes

Refined accessibility labels and VoiceOver text for editor toolbar and buttons.
Ensured VoiceOver correctly describes formatting options, navigation buttons, and editor actions.

@anvithagowda098
Copy link
Author

@mazevedofs can you please review this. Thank you.

@l-olson1214 l-olson1214 self-requested a review April 3, 2025 14:10
@l-olson1214
Copy link
Collaborator

Hi @anvithagowda098 !

Thanks for the PR - I'd love to invite you to look at accessibility traits - these allow you to add the traits like isButton so that it reads out to the user - instead of doing things like [button], this would be a better way.

Thank you!

@anvithagowda098
Copy link
Author

@l-olson1214 Hey, I have made the necessary changes.

public static let editorKeyboardButtonLinkAccessiblityLabel = WMFLocalizedString("editor-keyboard-link-accessibility", value: "Link", comment: "Accessibility label for link keyboard button on the editor.")

public static let editorToolbarButtonTemplateAccessiblityLabel = WMFLocalizedString("editor-toolbar-template-accessibility", value: "Template text formatting", comment: "Accessibility label for template toolbar button on the editor.")
public static let editorToolbarButtonTemplateAccessiblityLabel = WMFLocalizedString("editor-toolbar-template-accessibility", value: "Double tap to add a template to the current node.", comment: "Accessibility label for template toolbar button on the editor.")
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "current node" text doesn't make sense in this context, nor is double tapping needed for this button, so this text is an incorrect instruction.
Ideally, it should be something like "Add template"

public static let editorKeyboardButtonTemplateAccessiblityLabel = WMFLocalizedString("editor-keyboard-template-accessibility", value: "Template", comment: "Accessibility label for template keyboard button on the editor.")

public static let editorToolbarButtonImageAccessiblityLabel = WMFLocalizedString("editor-toolbar-image-accessibility", value: "Image text formatting", comment: "Accessibility label for image toolbar button on the editor.")
public static let editorToolbarButtonImageAccessiblityLabel = WMFLocalizedString("editor-toolbar-image-accessibility", value: "Double tap to add an image to the current node.", comment: "Accessibility label for image toolbar button on the editor.")
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above
The "current node" text doesn't make sense in this context, nor is double-tapping needed for this button, so this text is an incorrect instruction.
Ideally, it should be something like "Add image"

"editor-toolbar-link-accessibility" = "Link text formatting";
"editor-toolbar-list-ordered-accessibility" = "Ordered list text formatting";
"editor-toolbar-list-unordered-accessibility" = "Unordered list text formatting";
"editor-toolbar-image-accessibility" = "Image [button]. Double tap to add an image to the current node.";
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file should update when you build the project and commit the changes in this file and the related binaries.
Please commit the build changes as well.

@mazevedofs
Copy link
Collaborator

Hi @anvithagowda098! I reviewed your last changes, let me know if you need any help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

3 participants