From 1c779da13a36a8aabb9b5e6f76d0419651f07b74 Mon Sep 17 00:00:00 2001
From: isabella3412 <40362506+isabella3412@users.noreply.github.com>
Date: Thu, 20 Aug 2026 20:12:58 +0000
Subject: [PATCH] Updated accessibility help page
---
.../Accessibility/AccessibilityOverview.html | 59 ++++++++++++++++---
1 file changed, 51 insertions(+), 8 deletions(-)
diff --git a/Ghidra/Features/Base/src/main/help/help/topics/Accessibility/AccessibilityOverview.html b/Ghidra/Features/Base/src/main/help/help/topics/Accessibility/AccessibilityOverview.html
index d8cf3e4500..e2a26a0fbb 100644
--- a/Ghidra/Features/Base/src/main/help/help/topics/Accessibility/AccessibilityOverview.html
+++ b/Ghidra/Features/Base/src/main/help/help/topics/Accessibility/AccessibilityOverview.html
@@ -11,17 +11,60 @@
-
+
Ghidra Accessibility
+ Ghidra strives to be as accessible as possible to all users, including those relying on keyboard-only operation and screen readers. This document summarizes built-in accessibility features, recommended usage patterns, and known limitations.
- Header 2
- Header 3
- Paragraph
-
- Related Topics
-
+ Screen-Reader Guidance
+ Most of Ghidra's UI is built in Java/Swing, so screen reader behavior may differ from a web browser. To get the best results:
-
+ - Use a modern Java-aware screen reader (e.g. NVDA on Windows).
+ - Enable "focus following caret" or "announce focus changes" so you hear when UI components gain keyboard focus.
+ - Pause briefly after opening new dialogs or views, as Swing can sometimes batch events.
+
+
+ Keyboard Navigation
+ Ghidra provides comprehensive keyboard navigation support to traverse UI components, windows, and providers. For full details, including focus traversal and navigation shortcuts, see the Keyboard Navigation topic.
+
+ Quick Action Dialog (Ctrl + 3)
+ Ghidra's Quick Action dialog provides a fast, keyboard-first way to find and run any action. Press Ctrl + 3 to open it, then:
+
+ - Begin typing any portion of an action name
+ - Use Up/Down arrows to navigate the list.
+ - Press Enter to execute the selected command.
+ - Repeat Ctrl + 3 to expand from local to global actions.
+ - The dialog remembers recent commands across sessions for quick recall.
+
+ This dialog is invaluable for screen-reader users or anyone who prefers keyboard navigation over menus.
+
+ Script Launcher (Ctrl + Shift + S)
+ A quick launcher exists for Ghidra scripts. For details, see the Script Manager topic: Script Manager.
+
+ - Press Ctrl + Shift + S.
+ - Begin typing your script's name (wildcards and substrings allowed).
+ - Navigate the filtered list with Up/Down, then Enter to run.
+ - Recently run scripts float to the top automatically.
+
+
+ Other Accessibility-Focused Enhancements
+
+ - Customizable Key Bindings: Assign or modify keyboard shortcuts via Edit -> Tool Options -> Key Bindings, or press F4 while hovering over a toolbar icon or menu item to set a shortcut (see Key Bindings).
+ - Accessible Names and Roles: Most dialogs now expose meaningful AccessibleName and AccessibleRole fields.
+ - Dialog Checkbox Improvements: Spacebar toggles and arrow keys navigate checkbox groups reliably.
+ - Decompilation View: Reduced redundant reads when moving the caret.
+ - Filter Dialogs: Improved focus order and announceable fields in filter dialogs (e.g., Analyze -> Filters).
+
+
+ Known Limitations
+
+ - Swing's accessibility support is not as mature as HTML/ARIA; you may encounter missing or stale descriptions, focus swapping, or limited screen-reader gestures.
+ - Browser-style reporting (tabular UI state summaries) is not available.
+
+
+ Related Topics
+