Output ARIA live regions in Braille#15078
Conversation
|
I think there should be a toggle, as raised in #7756 (comment) and below. Perhaps an option: "Update braille with live messages: ". With 3 options: off (default), all (polite), high priority (assertive). I think a feature flag is a good idea, as assertive might be a sensible default at some point |
|
@seanbudd I agree that a toggle may be a good idea, but right now NVDA doesn't offer that level of granularity for speech. We can disable the announcement of polite updates by turning off the reporting of dynamic changes, but there is no way to ignore aria-live ="assertive" even for speech. This PR extends the Braille support that already exist for all other live updates. If I want Braille to ignore aria-live updates, I just need to disable Braille messages like I would for UIA based notifications, for example. what about adding this basic level of support now, and work on a more comprehensive filter of aria-live updates that encompasses speech and Braille for 2024.1? this PR resolves the biggest shortcoming that exists right now for me in terms of Braille support in NVDA. |
|
We wish to improve aria live polite behaviour as discussed in #13915. Polite behaviour for braille which matches #13915 could be configured via an idle timeout setting, e.g. after braille hasn't been updated for 30sec, update the display with the polite notification. Proposed ideal options when considering #13915
|
|
I think I would change the report dynamic content changes option to a four state option. Both speech and braille, braille, speech and off. |
@LeonarddeR I agree (and actually thought of this), but that's a config spec breaking change that I'd prefer to save for a larger ARIA refactor (especially if one is planned). @seanbudd suppression of live regions in Braille is inconsistent with the user experience of many other popular screen readers, such as VoiceOver on iOS/MacOS. Additionally, live regions are currently completely inaccessible to deafblind users or those who otherwise use NVDA only via Braille, as indicated in #7756 (comment). As @rperez030 suggests, we shouldn't let the perfect be the enemy of the good: merging this pR now makes this information accessible in Braille, and we can always refine the experience later. Similar to HID Braille support, I'll put this behind a feature flag (enabled by default, but can be disabled if problematic) for now. As a longer term plan, this flag should be removed and merged into "report dynamic content changes" during a config spec upgrade. |
See test results for failed build of commit e793d65988 |
I guess that's a product decision that is best to be taken by NV Access. I think this pr is too late for 2023.2. Personally I'd rather have the config change all settled instead of introducing a feature flag and then removing that in a follow up. |
|
What if ARIA live regions would be inaccessible with speech, and there would be pr solving this. Should it be merged or not? |
That is a great question. That is an example I often use when discussing accessibility issues related to visual content not being accessible to screen reader users. For someone that doesn't use Braille, or is a very ocasional user, this may feel secundary. For someone that depends primarily on Braille output, this is a limitation that should have been fixed years ago. |
|
This new config setting seems appropriate - but can it be moved out of advanced settings into general braille settings? |
|
The placement in advanced is because this feels more like a feature flag to me (something someone might disable in case of issues) rather than a user-facing setting. From the user perspective, you can disable Braille messages which will block both live region updates and any other flash messages that might be similarly disruptive. |
seanbudd
left a comment
There was a problem hiding this comment.
Given that, the plans outlined in #15078 (comment) and #15078 (comment) seem appropriate
|
Is there an official way of testing this for braille displays? The reason why I ask is because I am not getting incoming chat alerts for either Zoom or Teams (desktop apps), but they are voiced without issue. The same goes for mute/unmute notifications in Zoom, but I am unsure if they are specifically outputted via live regions or not. |
|
Update: With a portable copy of NVDA, live regions are brailled, but not with my installed copy. I even restarted with add-ons disabled and no difference. In NVDA.ini, reportLiveRegions is set to DEFAULT. And yes, I even uninstalled and reinstalled NVDA. Log fragment below: |
Link to issue number:
Closes #7756.
Summary of the issue:
NVDA does not output ARIA live regions in Braille, making them completely inaccessible in Braille-only usage scenarios (for instance, @rperez030 would like to read incoming MS Teams messages in Braille during meetings).
Description of user facing changes
ARIA live region updates are now displayed as Braille messages, similarly to UIA notification events.
Description of development approach
Call
brailleHandler.messageon live region updates.Testing strategy:
Tested by @Simon818 and @rperez030 for their use cases.
Known issues with pull request:
None known
Change log entries:
Something along the lines of:
== Changes ==
Code Review Checklist: