Currently this is just a prototype. There are several more aspect of the UX that need to be developed and combined to test the full experience. Once the prototypes are accepted, then the work can be polished and made ready for alpha.

Link to issue number:

Partial fix for #13940

Summary of the issue:

When encountering an annotation, "has details" is reported.
The summary of the annotation can be reported with NVDA+d
However, if the annotation contains complex structure, or can be interacted with (E.G. a comment thread), there is no easy way for the user to navigate to the annotation.
Additionally, some locations may have multiple annotation targets.

Description of user facing changes

Please note, the shortcuts used are not final, and not intended to be the focus of this prototype.

• This provides a UX for interacting with multiple annotation targets.
• Provide navigate (down) to a annotation target.
• Provide navigation (up) to the last annotation origin.
• Cycles are not automatically detected, users need to observe this themselves.

Overview:

• Repeatedly press NVDA+d to select the annotation they are interested in (based on the reported summary).
• The summaries loop back to the start. It's expected to be uncommon to have many annotations starting for a single origin.
• Pressing NVDA+alt+d will navigate to the annotation target last summarized. After navigation, NVDA will 'read line' for the location.
  • If no summary has been announced, navigate to the first.
• The user can then navigate around the annotation target.
• Pressing NVDA+alt+shift+d will navigate back to the annotation origin.

Description of development approach

• To navigate to the target, the implementation for quick nav was used as an example.
• Extracted Annotation origin and Annotation Target concepts.
• Keep track of the last reported annotation origin / annotation target index using new classes in globalCommands.py

Testing strategy:

• Used https://mdn.github.io/html-examples/aria-annotations/
• https://codepen.io/reefturner/pen/poKLQyj?editors=1100
• With Firefox and Edge
• Exploratory testing.

Known issues with pull request:

Max 10 targets are fetched, this should be dynamic, however there is a bug preventing this, requiring investigation.

Change log entries:

New features
Changes
Bug fixes
For Developers

Code Review Checklist:

• Pull Request description:
  • description is up to date
  • change log entries
• Testing:
  • Unit tests
  • System (end to end) tests
  • Manual testing
• API is compatible with existing add-ons.
• Documentation:
  • User Documentation
  • Developer / Technical Documentation
  • Context sensitive help for GUI changes
• UX of all users considered:
  • Speech
  • Braille
  • Low Vision
  • Different web browsers
  • Localization in other languages / culture than English
• Security precautions taken.