emilk/egui

egui access_kit API docs

クローズ

#4,396 opened on 2024/04/23

 (2 件のコメント) (0 件のリアクション) (0 人の担当者)Rust (2,093 件のフォーク)batch import
accessibilitydocs and examplesgood first issue

Repository metrics

Stars
 (29,972 個のスター)
PR merge metrics
 (平均マージ 17d 17h) (30d で 41 merged PRs)

説明

Is your feature request related to a problem? Please describe. Is there documentation on how to use access_kit as a ui developer using egui? I looked through both egui and access kit docs and don't see documentation for developers on how to develop accessible apps. I've read a bit of the source code I thought might be relevant but haven't had much luck yet.

From what I can tell enabling access_kit mostly just "works" (about as good as an iOS app using VoiceOver which is pretty impressive), but it wasn't apparent that would be the case until I set everything up and ran VoiceOver with my app.

Describe the solution you'd like I'd like to see documentation explaining to ui-developers using egui:

  • how to create accessible experiences using access kit (high level summary)
  • documentation explaining what gets accessibility labels for free (label text, for example)
  • documentation explaining how to provide accessibility labels to widgets that don't have any. For example, I have a component with a visual, non-textual representation that has an informational component that should be shared with screen reader users. How can I add accessibility labeling to that widget?

In addition to ui-developer docs, I'm also interested to know if the accessibility tree can be accessed at runtime in order to read things like "label_a has text 'wowow'". I'm interested in the possibility of using access kit as a way to drive out ui tests for egui.

Describe alternatives you've considered Reading source code until I understand the capabilities, which I have greater risk misunderstanding without docs

Additional context Thanks for the great library! :)

コントリビューターガイド