Re: New add-on: enhancedAnnotations #addonrequestreview

Rui Fontes


License and copyright pass.

User experience  Pass with comments

You have used the NVDA core translation to the message of moveToRelatedDetails, but all other translatable messages are not possible to translate!


The code, for me, seems good and it works as advertised...

 Best regards,

Rui Fontes
NVDA portuguese team

Às 14:51 de 24/07/2022, Noelia Ruiz escreveu:


My intention is to send this addon to addonFiles to be included on the
website and registered in the translation system while NVDA issue
13940 is not addressed in NVDA's code.

I'll wait for a week or so waiting for feedback.

Enhanced Annotations
• Authors: George Kerscher, Noelia Ruiz Martínez
• (compatible with NVDA 2022.1 and beyond)
In the DAISY Consortium, best practices are developed for publishers
and authors for providing extended (long) descriptions.
The best practices use the HTML details element that follows the
image, or a link to another file that contains the extended
In both options, the user would need to move to the details or the
link and activate it.
Having a keystroke to put focus on the details or the link is ideal.
Our best practices recommend that the details or the link immediately
follows the image, and if the link is followed, a back link to the
exact location must be provided. This makes it certain that the user
will not get lost.
However it is probable that authors in the wild will place the
extended (long) description almost anywhere. In these cases, the user
would want to return to the image and hence the need for a way to
return to the original image.
This add-on provides both features, in support of this issue opened in
NVDA's repository.
• NVDA+alt+d: moves the cursor to the element identified with aria-details.
• NVDA+alt+shift+d: moves the cursor to the original element, for
example, an image with furter details like a long description.
The above commands can be modified from NVDA's menu, Preferences
submenu, Input gestures dialog,

Webpage for info about related good practices and samples for testing
the add-on:

Related issue:

Add-on repo:

Download version 1.0-dev:

1. I use skipTranslation module, thanks to Alberto Buffolino.
2. George Kerscher is Chief Innovation at DAISY Consortium. I've
created this add-on in private conversations with DAISY people, and
George has requested this feature for NVDA, and has tested previous
versions of the plugin of this add-on.
3. The readme is based almost completely in the explanation provided
by George in the related issue of NVDA.

I think this is important to be included in NVDA. Reviews and tests
are appreciated.


Join to automatically receive all group messages.