Skip to content

Keyboard behavior

Every EVK action can be done from the keyboard. No action needs hover, drag or a pointer. Controls are native buttons, inputs and links, so Tab, Shift+Tab, Enter and Space behave as the browser defines them. The keys below are the additions. In RTL layouts, left and right arrows follow reading direction.

WhereKeyEffect
Text inputDown / UpOpen suggestions and move the active suggestion (announced through aria-activedescendant).
Text inputEnterAdd the active suggestion as an exact-ID tag, or submit the search when no suggestion is active.
Text inputEscapeClose suggestions.
Text inputTabClose suggestions and move on.
Empty text inputBackspaceFocus the last tag (it is not removed yet).
Focused tagBackspace or DeleteRemove that tag. Focus moves to a neighbor, or back to the input.
Focused tagLeft / Right, Home / EndMove between tags.
Focused tagEscapeReturn to the input.

While an input method is composing text, Enter never submits. That holds during the composition and for a short guard afterwards.

WhereKeyEffect
Mention in a passageEnter or SpaceActivate it. A mention with several entities opens the candidate chooser.
Candidate chooserEscapeClose it and return focus to the mention.
Detail sheet or panel (DetailContainer)EscapeClose it and return focus to the control that opened it.
Modal sheetTab / Shift+TabFocus stays inside the sheet until it closes.
WhereKeyEffect
Graph stageArrow keysPan.
Graph stage+ / -Zoom in or out.
Graph stageHomeFit everything.
Expanded (full-screen) graphEscapeLeave full screen.
Expanded (full-screen) graphTab / Shift+TabFocus stays inside the graph.

Selecting, inspecting, pinning and adding to search are done with buttons: the toolbar, the selection panel (including pinning by world coordinates) and the accessible graph navigator. The navigator lists every entity and relation, with search and pagination. It opens automatically when graphics are unavailable. Focus is preserved across re-renders by a stable key.

WhereKeyEffect
SeparatorLeft / RightResize by a small step; hold Shift for a larger step.
SeparatorHome / EndJump to the minimum size of either pane.
SeparatorEnterCollapse or restore the details pane.
View tabsLeft / RightMove between Results and Connections (ARIA tabs).
  • Live page. The page’s own keyboard behavior is never intercepted. Highlights are paint, not focusable elements. Reach mentions through the sidebar’s mention navigator. Locate scrolls to a mention and selects it. The sidebar’s Add and Inspect buttons act on a mention’s entities directly. A host with its own UI can call activateMention(mentionId) to emit the same bounded activation a click would.
  • Extensions. Alt+Shift+E (the _execute_action command in both manifests) opens the panel and grants one-time access to the current tab. You can change the shortcut in the browser’s extension shortcut settings.

Operator controls are ordinary buttons plus a range input for audience scale. The audience display has no controls at all: it is view-only by design.

Automated tests cover the keyboard-only routes listed in testing. Screen-reader and switch-access behavior still needs the manual script in docs/checklists/assistive-technology.md.