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

Should Role::GenericContainer translate to AT-SPI's Panel role? #455

Open
Tropix126 opened this issue Sep 29, 2024 · 1 comment
Open

Should Role::GenericContainer translate to AT-SPI's Panel role? #455

Tropix126 opened this issue Sep 29, 2024 · 1 comment

Comments

@Tropix126
Copy link

Tropix126 commented Sep 29, 2024

Currently Role::GenericContainer is treated as an AT-SPI Role::Section, which is described as such:

The object is a containing instance of document content which constitutes a particular ‘logical’ section of the document. The type of content within a section, and the nature of the section division itself, may be obtained by querying the object’s attributes. Sections may be nested.

| Role::Ruby => AtspiRole::Section,

This seems to imply that the section role at least could have some semantic meaning to consumers (being a "logical section of the document"). While digging through what a GenericContainer actually entails (it seems like it's possibly useful to magnifiers due to providing layout information about a node), I came across ATSPI's Panel role which, based on the description, seems to fit the purpose of GenericContainer much better.

A generic container that is often used to group objects.

Any thoughts on this? I have no experience using AT-SPI or any platform-native a11y API directly, but it seemed to be worth bringing up here.

@DataTriny
Copy link
Member

Hello @Tropix126,

In practice, nodes with Role::GenericContainer are filtered out, and don't end up in the platform's accessibility tree. Unlike nodes with Role::Group or Role::Pane for instance, which are mapped to the AT-SPI Panel role.

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

No branches or pull requests

2 participants