The keyboard:unreachable rule flags something that behaves like a control – it has a click handler, or a role such as button or tab – but that no Tab press ever lands on and, inside tabs, a radio group or a toolbar, that no arrow key reaches either. A mouse user can use it; a keyboard user never gets there. The fix is almost always to use the real element: a <button> for actions, an <a href> for navigation – or, in a widget with one Tab stop, the arrow-key handling its pattern asks for.
What the rule means
WCAG 2.1.1 requires that everything a page lets you do can be done with a keyboard. Native controls – links with an href, buttons, form fields, <summary> – are in the tab order and respond to Enter or Space without any extra code. A <div> or <span> is neither: it gets no focus, and pressing Enter on it does nothing, however it looks and whatever its click handler does.
A role alone does not change that. role="button" tells assistive technology to announce a button, but it does not put the element in the tab order and does not make Enter or Space work. That is a promise the markup does not keep.
Who is affected
Everyone who operates a page without a mouse: people with motor disabilities using a keyboard, switch or mouth stick, blind people using a screen reader, and people using voice control, which often works through the same focusable elements. When the one control that opens a product, adds to the basket or accepts cookies is unreachable, the task cannot be finished at all.
Why the check fails
- Clickable cards – a
<div onclick>around a teaser or a product, with no link inside. - Icon buttons built from
<span>or<i>with a click handler: close, menu, search. - ARIA widgets half-built:
role="tab",role="menuitem"orrole="option"withouttabindexor keyboard handling. - Tabs, radio groups or toolbars with one Tab stop and no arrow keys: the inactive members are out of the tab order with
tabindex="-1", as the pattern says, but nothing moves focus to them. Native<button>tabs fail this way too. - A widget with no Tab stop at all: every tab, or every radio, has
tabindex="-1", so focus never gets in. tabindex="-1"on a control that was meant to be reachable, often copied from a pattern that manages focus by script.- Cookie banners and chat launchers from third parties that only listen for mouse clicks.
How to fix it
Replace the stand-in with the element that already does the job. You get focus, Enter and Space, and the right role for free.
<!-- Before: a card only a mouse can open -->
<div class="product-card" onclick="location.href = '/products/desk-lamp/'">
<img src="/img/desk-lamp.jpg" alt="">
<h2>Desk lamp</h2>
<p>€49.00</p>
</div>
<!-- After: the heading holds a real link; CSS can stretch it over the card -->
<div class="product-card">
<img src="/img/desk-lamp.jpg" alt="">
<h2><a href="/products/desk-lamp/">Desk lamp</a></h2>
<p>€49.00</p>
</div>
The same for an icon that acts:
<!-- Before: announced as a button, but no Tab reaches it -->
<span class="icon-close" role="button" aria-label="Close" onclick="closePanel()">×</span>
<!-- After: a real button -->
<button type="button" class="icon-close" aria-label="Close" onclick="closePanel()">×</button>
If you really cannot change the element, it needs tabindex="0", a handler for Enter (and Space, for buttons) and the matching role – three things the native element gives you in one.
How to test it manually
- Press Tab from the top of the page and note every control that focus visits.
- Compare with everything you can click: cards, icons, tabs, accordions, sliders, cookie buttons.
- In tabs, radio groups, toolbars, menus and listboxes, Tab reaches one item. Press the arrow keys there and check that focus – or the highlighted option – moves to each of the others.
- For each control focus skipped, you have found this problem. For each one it visited, press Enter (and Space for buttons) and check it works.
- The browser's accessibility tree (developer tools) shows whether an element is focusable and what role it has.
Related WCAG criterion
2.1.1 Keyboard, Level A. Related: 4.1.2 Name, Role, Value, because a clickable <div> also has no role, and 2.4.3 Focus Order.
How Reviseberg reports it
This rule comes from Reviseberg's keyboard agent, not from axe-core. After walking the journey you choose with real key presses, the agent looks for elements that promise to be controls – an onclick attribute, or a role such as button, link, checkbox, radio, tab, menuitem, switch or option – that are visible but neither focusable by nature nor given a tabindex of 0 or more. Each one is reported with the message "This div behaves like a control but cannot be reached with the keyboard", its selector and the reason it looked interactive.
Tabs, radio groups, toolbars, menus and listboxes are built differently on purpose: Tab reaches one member, and the arrow keys move between the rest, which sit out of the tab order with tabindex="-1" or are pointed at with aria-activedescendant. So for a member of a tablist, radiogroup, toolbar, menu, menubar or listbox that is out of the tab order, the agent puts focus on the widget's Tab stop and presses ArrowRight, ArrowDown, ArrowLeft and ArrowUp – real key presses, like the walk:
- A member an arrow key reaches is not reported. The transcript names the key that got there.
- A member no arrow key reaches is reported, with the keys that were tried. That includes a native
<button tabindex="-1">: a button out of the tab order is out of it. - If nothing in the widget is in the tab order, every member is reported without a key being pressed: no Tab gets in, so no arrow key has anywhere to start.
- Where the agent does not press the arrow keys – inside a cookie banner, whose most private choice it is about to take with Enter – the member is reported as a question, not as a failure and never as a pass. It appears with the other open questions, not in the issue list, and costs no score.
What it cannot see: a click handler attached with addEventListener leaves no trace in the page that a script can read afterwards, so a <div> wired up that way is not reported here. On a crawl from an account, a check of our own records such handlers as the page registers them, on one page per template, and reports an element that reacts to a click while no key reaches it as keys:click-only. The agent under-reports on purpose rather than guessing from a pointer cursor, which would flag every styled card. In a widget, it checks that the arrow keys reach each member – not that focus is visible when they do, nor what Enter, Space, Home or End do (on a crawl from an account, keys:no-activation reports a custom control that does nothing on Enter or Space). So a clean result here is not proof, and the manual test above still matters.
Related rules
keyboard:trap– the opposite problem: focus that cannot leave.nested-interactive– a control inside another control.scrollable-region-focusable– a scrolling area the keyboard cannot reach.