Skip to content
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

Add language metadata to AppD for accessibility #622

Closed
Tracked by #657
julianna-ciq opened this issue Mar 11, 2022 · 0 comments · Fixed by #668 or #670
Closed
Tracked by #657

Add language metadata to AppD for accessibility #622

julianna-ciq opened this issue Mar 11, 2022 · 0 comments · Fixed by #668 or #670
Labels
app-directory enhancement New feature or request
Milestone

Comments

@julianna-ciq
Copy link
Contributor

julianna-ciq commented Mar 11, 2022

Enhancement Request

Use Case:

  • An institution has an app that supports multiple languages. They want to include multiple manifest entries, where they have a different version of the app for each language the app supports.
  • Consider an implementation of a desktop agent that contains multiple applications across multiple languages. If an end-user is blind and using a screen reader, the screen reader will be unable to independently determine which applications have which languages. The desktop agent will need to provide that language information, which it must determine for a given application.

For example:

A bank uses a desktop agent to provide a financial application. The application has an English and Chinese version. The bank wants their English-language employees to be able to use the English version of all of the applications, and their Chinese-language employees to be able to use the Chinese version of the applications. The bank could provide those language identifiers in their manifest, and then the desktop agent could surface only certain languages that end-users require.

A bank uses a desktop agent to provide financial applications to users in Canada. They provide copies of their applications in French and in English, and may even have language-specific applications. Let's say one of the users at this bank is blind and uses a screen reader. They are a native English speaker, so their operating system, desktop application, and screen reader are all running in English. Whenever the screen reader encounters the title or contents of the french applications, it pronounces the french words as if they are English, resulting in cognitively-taxing confusion. Further more, let's say this user is also fluent in french. With no metadata provided for the french versus english applications, when the user encounters any of the french apps, the screen reader will pronounce french words using english pronunciation rules. In other words, they become gibberish.

Workflow Description

If the AppD provided metadata for the language of the app (assuming the title of the app and the contents of the app are all in the same language), the desktop agent could surface that language appropriately.

Additional Information

HTML contains the global attribute, lang. This attribute can be used on any HTML element, and would likely be leveraged by any HTML-based desktop agent. The lang attribute typically uses BCP 47, which includes a 2-digit language code (like "en" or "fr") and optionally a 2-digit country code (like "en-US" or "en-GB").
HTML lang attribute

The W3C's Web Application manifest also supports a lang attribute, with alternative manifest URLs or geolocation and targeting being used to deliver the localized version of the manifest.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
app-directory enhancement New feature or request
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants