Skip to content

a11y: Add article and comment roles

Michael Weghorn requested to merge michaelweghorn/gtk:michaelweghorn/a11y_add_article_and_comment_roles into main

Add new accessible roles GTK_ACCESSIBLE_ROLE_ARTICLE and GTK_ACCESSIBLE_ROLE_COMMENT.

ARIA has corresponding roles as well [1] [2], with the article role being the superclass role of the comment role.

Acccording to the ARIA spec, the article role has the document role as superclass role and the name can be set by the author.

For the comment role, the name can be set by the author or come from the content.

The ARIA spec for the comment contains this sentence [2]:

If the author has not explicitly declared aria-level, aria-posinset, or aria-setsize for a comment element, user agents MUST automatically compute the missing values and expose them to assistive technologies.

However, these properties are not listed as "Required States and Properties" in the following table for that role. Potentially the above requirement only applies for the first of the two possible described cases of how the relationship between comments and the commented content can be set, so don't hard-require these attributes in the a11y overlay's check_widget_accessibility_errors either.

[1] https://w3c.github.io/aria/#article [2] https://w3c.github.io/aria/#comment

Merge request reports