GNOME Bugzilla – Bug 650310
Need to improve AtkRelation docs
Last modified: 2021-06-10 11:26:51 UTC
A developer indicated via IRC that documentation regarding accessible relations was not especially clear. Based on the discussion and looking at the docs [1], it seems what might be needed are some concrete examples and/or best practices. [1] http://developer.gnome.org/atk/unstable/AtkRelation.html
[Mass-reassigning open atk bug reports for better trackability as requested in https://bugzilla.gnome.org/show_bug.cgi?id=653179 . PLEASE NOTE: If you have watched the previous assignee of this bug report as a workaround for actually getting notified of changes in atk bugs, you yourself will now have to add atk-maint@gnome.bugs to your watchlist at the bottom of https://bugzilla.gnome.org/userprefs.cgi?tab=email to keep watching atk bug reports in GNOME Bugzilla. Sorry for the noise: Feel free to filter for this comment in order to mass-delete the triggered bugmail.]
I was reminded of this during a meeting today, when the question of what CONTROLLED_BY/CONTROLLER_FOR were appropriate for. And the docs failed to answer that question. I think we should steal what the ARIA spec says for this AtkRelationType (and possibly others). And, yes, "we" almost certainly means "me." So this is mostly a note/ping to self. In the meantime, here's the ARIA spec text for aria-controls: =================== Identifies the element (or elements) whose contents or presence are controlled by the current element. See related aria-owns. For example: A table of contents tree view may control the content of a neighboring document pane. A group of checkboxes may control what commodity prices are tracked live in a table or graph. A tab controls the display of its associated tab panel. =================== https://rawgit.com/w3c/aria/master/aria/aria.html#aria-controls
GNOME is going to shut down bugzilla.gnome.org in favor of gitlab.gnome.org. As part of that, we are mass-closing older open tickets in bugzilla.gnome.org which have not seen updates for a longer time (resources are unfortunately quite limited so not every ticket can get handled). If you can still reproduce the situation described in this ticket in a recent and supported software version of atk, then please follow https://wiki.gnome.org/GettingInTouch/BugReportingGuidelines and create a ticket at https://gitlab.gnome.org/GNOME/atk/-/issues/ Thank you for your understanding and your help.