How to try with a screen reader
Open one of the demos, move into the chart, and ask it questions.
What has been checked, all by the author, a sighted developer: the VoiceOver steps with Safari 26.2 on macOS 26.2, in a full pass of 103 steps; the NVDA steps with NVDA 2026.3.1 and Chrome 157 on Windows, in a partial check. The JAWS steps follow how JAWS usually handles web applications; they have not been checked with this extension, and neither has Firefox. No one who uses a screen reader every day has tried it yet. If something does not work as described, that is useful to know.
Everywhere
- Open the dhtmlx-gantt demo. Make sure the switch says the extension is on.
- Move to the chart with Tab, not with a mouse click. Focus lands on the first task row.
- Move between tasks with the up and down arrow keys. Each row says the task's name, dates, duration and progress.
- Press Shift+H for the list of keys, and again within five seconds for the next group.
- Good first questions: on "Launch", Shift+D (what it depends on); on "Testing", Shift+O (what runs at the same time); anywhere, Shift+V (overview).
VoiceOver on a Mac
- Use Safari. Turn VoiceOver on with Command+F5.
- If arrow keys move the VoiceOver cursor instead of the chart's focus, turn Quick Nav off with Left Arrow+Right Arrow pressed together.
- In Safari, Tab may skip buttons; Option+Tab reaches every control.
- Results of jumps and of the task form are heard first, as part of the row; answers to questions and results of keyboard edits come after the row is read.
NVDA on Windows (partial check, NVDA 2026.3.1, Chrome 157)
- Use Chrome (checked with Chrome 157); Firefox not checked.
- Move to the chart with Tab. In the check, NVDA switched to focus mode on its own when focus entered the chart.
- In focus mode the Shift+letter keys reach the extension. Try Shift+H: it reads the list of keys.
- If the keys do nothing, or NVDA moves through the page instead (browse-mode quick keys), NVDA is in browse mode. Press NVDA+Space to switch to focus mode, then try again.
- Known differences from VoiceOver: after Shift+J, K, I or M the new dates are heard twice (first the re-drawn row, then the result); about 5 seconds after a jump or a form result, the row is read again; NVDA says "not selected" and a row position that can change, both from the chart library's own markup.
JAWS on Windows (not yet tested)
- Use Chrome or Edge. Move to the chart with Tab; JAWS should turn on forms mode. If it does not, press Enter on the row, or turn the virtual cursor off with Insert+Z.
Step by step
The repository has a full list of checks with the exact expected texts (TESTING.md), and a helper page that walks through them one by one and collects your answers into a report (demo/manual-test.html; run npm run demo in the repository first).