emilk/egui

egui access_kit API docs

Open

#4,396 创建于 2024年4月23日

在 GitHub 查看
 (2 评论) (0 反应) (0 负责人)Rust (2,037 fork)batch import
accessibilitydocs and examplesgood first issue

仓库指标

Star
 (29,051 star)
PR 合并指标
 (平均合并 11天 20小时) (30 天内合并 47 个 PR)

描述

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! :)

贡献者指南