Add support for Word footnote and endnote reference navigation#19310
Conversation
There was a problem hiding this comment.
Pull request overview
This pull request adds support for navigating footnote references in Microsoft Word documents, addressing issue #19300. The implementation works for both UIA and non-UIA modes.
- Adds "reference" as a new element type in Word's elements list dialog
- Implements quick navigation commands for jumping between footnote references
- Uses Word's footnotes collection in the object model and UIA's footnote annotation attribute
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| user_docs/en/changes.md | Documents the new feature in the changelog for version 2026.1 |
| source/browseMode.py | Adds unassigned quick navigation command definition for references |
| source/NVDAObjects/window/winword.py | Implements footnote reference navigation using Word's object model, adds "References" to elements list |
| source/NVDAObjects/UIA/wordDocument.py | Implements footnote reference navigation using UIA annotation attributes, adds "References" to elements list |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.
|
@LeonarddeR Thanks for this. Does it also cover endnotes? Like footnotes, NVDA cann't navigate around endnotes in the virtual mode either. |
|
End notes don't work yet, but I guess I can add them pretty easily. |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 5 out of 5 changed files in this pull request and generated 7 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
|
Endnotes are now covered too. |
Co-authored-by: Sean Budd <seanbudd123@gmail.com>
|
Thanks @LeonarddeR |
Link to issue number:
Closes #19300
Summary of the issue:
There is no way to navigate between footnote and endnote references in Word. IN UIA, they are reported as links but quick navigation to links does not work.
Description of user facing changes:
I chose the word reference here because footnotes/endnotes might be misleading, i.e. you're not navigating between the notes or towards them, you are navigating to the references that point at the foot/endnotes.
Description of developer facing changes:
N/a
Description of development approach:
Use the footnote/endnote annotation for UIA and the footnotes/endnotes collection in the object model.
Testing strategy:
Tested creating and navigating to footnotes and endnotes in Word with and without UIA.
Known issues with pull request:
None
Code Review Checklist: