EnhanceAbility: D&D Beyond a11y

The main goal of this add-on is to stop the D&D Beyond site from being a headache to navigate with a screen reader.

• Status Shortcuts:
  • For now, we have hp: press Alt+H to know your hp from anywhere in the site
  • Press Alt+Shift+H to jump standard focus straight to the HP adjustment input box so you can heal or take damage immediately.
• Table Fixes: The site likes to use divs that look like tables but aren't tables. This script forces correct grid/table semantics onto spell lists, actions, inventory, and extras so your screen reader can actually understand the rows and columns. Instead of having to arrow down through every column, you can now use your table navigation keys to skim a specific column across all your items!
• Ability Scores & Saving Throws: Previously, the saving throws section was extremely annoying, presenting itself as a massive list of headings that slowed down screen reader navigation massively. The ability scores were even worse and had no accessibility roles at all. Now they're all good old semantic tables for screen readers. You can use your table navigation keys to move through your modifiers or trigger a check or save.
• Sidebar Accessibility : This is the biggest boost! Normally, if you want to read what a spell or ability actually does, you have to click it, arrow through everything to get to the sidebar (losing your focus), and by the time you're done, you've lost your place in the main list. It's a massive slowdown.enhanceAbility fixes this. Just Press Alt+S to jump straight into the details sidebar when you open something, read what you need, and Press Escape to snap focus instantly back to the exact item you were looking at in the list.

  It finally lets us glance at information. You can pop into the sidebar, check a saving throw DC or damage type, and pop back to the list in a split second without losing your cursor position. It puts us on par with a sighted player who can just look right, then look left.

  We've also patched how the sidebar is actually built. The site used to mark it as a dialog, which meant that clicking some buttons inside would often kick your focus out into space randomly. It's now correctly identified as an aside (landmark), and the alinement / pinning controls now actually tell your screen reader whether they are toggled or not so you can know where the sidebar is, visually.

• Dice Toolbar: Accessing the custom dice roller is now possible. Proper button roles and labels to the dice menu have been added, so you can actually open it. When you click to open the menu, your focus moves right into the dice setup.

  There is also a shortcut: Press Alt+R to open the dice menu instantly from anywhere.

• Dice Logs: Screen readers always miss the visual popups when you or someone rolls dice, and the log is very inconvenient to navigate, which makes it hard to stay caught up with the action. This adds a log companion that catches every roll and lets you review them without ever losing focus!

  The results of your own rolls are always automatically announced. Previously, the site would actually re-announce the entire visual history every time a new roll happened because of how the ARIA roles were set up. We've removed those properties since we handle the announcements now.

  Press Alt+[ left bracket or Alt+] right bracket to move through the history of rolls. Use Alt+P to toggle "Live Mode" which controls whether new rolls from others that you can see are announced automatically as they happen.

  The visual log itself is a mess to navigate with screen readers and clutters the page because every single line is there near the bottum of the page, so we've turned it into a dialog role. This lets you skip over the whole thing in browse mode if you aren't interested. If you do want to clear it, just use your screen reader to enter the dialog (that is the Enter key with NVDA brows mode) and press the clear button.

• Dropdown Fixes: The site is full of dropdowns that claim to be standard Comboboxes but are actually buttons hiding a list of options. This confuses screen readers into switching to Focus / Forms Mode and often getting you stuck. This has been fixed so that you see an expandable button that opens a list of choices below it.
• And More!