Talk:XUL accessibility guidelines

From MDC

While this information is great, I'd strongly suggest some of the subsections on this page be converted into templates so that they can also be included within the relevant pages. It does insufficient good to make people aware of accessibility if the information is not integrated within the rest of the documentation (and which people will more likely be consulting regularly). A link within the templates can also lead back to this page. Brettz9 05:55, 15 January 2008 (PST)

Strongly agree. We need to find someone who is willing to help with that.

I started by making a template out of one of the subsections (I was going to add the toolbarbutton), but then I realized that the section really is a little bit long compared to the format of the reference page--and I wasn't sure how much detail should be added to the tutorial (though I really believe it should be integrated there as well, if in a simpler fashion). Anyhow, what I think is a good approach (and I haven't received feedback yet from the developer documentation mailing list) is, for the reference page on toolbarbuttons, to add something like these lines, maybe at the top after the introduction:

Accessbility Guidelines

• All toolbar functionality should be duplicated elsewhere in the application
  • Where possible, duplicate functionality in a menu item or context menu.
  • Where not possible, make all toolbarbuttons focusable by -moz-user-focus: normal.

A similar approach might be taken for the other sections of this article.

One other item I think is worth adding is linking to the official W3C Accessibility Guidelines, both 2.0 and Techniques for 2.0 (these are apparently almost ready, so I don't think referring to the older 1.0 is necessary now), as these are in many cases language-neutral, and they also refer to HTML, which can also be included inside of XUL. Brettz9 18:41, 15 January 2008 (PST)

I went ahead and added a section at the top of XUL:toolbarbutton... I think it should be at the top as I put it since it is not too obtrusive, and it is basic information about the treatment of the element (not just details). I colored it specially though so that people could notice it at a glance. Brettz9 18:59, 15 January 2008 (PST)