search

w3c / aria

Accessible Rich Internet Applications (WAI-ARIA)
https://w3c.github.io/aria/
Other
645 stars 125 forks source link

improve sentence on braille patterns #1232

Closed pkra closed 3 years ago

pkra commented 4 years ago

This continues leftover work from #923 and #1097.

Both aria-brailleroledescriptions and aria-braillelabel contain the following complicated SHOULD NOT for authors:

The value of aria-brailleroledescription does not contain any characters in Unicode Braille Patterns (U+2800..U+28FF) or consists of only characters in Unicode Braille Patterns (U+2800..U+28FF) while not only containing Braille Pattern dots-0 (U+2800).

As discussed on the PRs and telcos, this sentence is complicated and duplicated, risking changes in only one copy.

pkra commented 4 years ago

I'd propose to add a term for Unicode Braille Patterns (in aria-commons) along the following lines:

Unicode Braille Patterns. In Unicode, braille is represented in a block called Braille Patterns (U+2800..U+28FF). The block contains all 256 possible patterns of an 8-dot braille cell, thereby including the complete 6-dot cell range.

Then we can shorten the sentence to link to the term and remove the Unicode range along the following lines:

The value of aria-brailleXXX does not contain any characters in Unicode Braille Patterns or contains only characters in Unicode Braille Patterns; the value does not only contain Braille Pattern dots-0 (U+2800).

I'd love to remove the part on dots-0 if it was subsumed under whitespace considerations. I'm not sure where to file an issue for this; @michael-n-cooper would you have a suggestion? For the record, this old and short thread on the unicode mailing list seems to agree with the idea.

pkra commented 4 years ago

First part is https://github.com/w3c/aria-common/pull/45