{"id":"ia.keyboard-navigation","name":"Keyboard navigability","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.keyboard-navigation","expect":null},"fix":{"steps":[{"action":"Replace tabindex values above 0 with 0 or remove them.","order":1,"language":null,"code_example":null},{"action":"Use native button and a elements, or add tabindex=\"0\" and a role to custom controls.","order":2,"language":"html","code_example":"<div role=\"button\" tabindex=\"0\">Open menu</div>"}],"summary":"Remove positive tabindex values and make custom controls focusable.","skill":{"name":"content-semantics","anchor":"ia.keyboard-navigation"}},"category":"semantics","aggregate":null,"references":[{"title":"MDN tabindex","kind":"guide","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex"},{"title":"W3C Focus Order","kind":"spec","url":"https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"standard","evidence_source":{"title":"MDN tabindex","url":"https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex"},"why":"AI agents navigate pages using keyboard-style interactions via the accessibility tree. Positive tabindex values break natural focus order, and missing focusable elements on interactive widgets prevent AI agents from discovering and operating controls.","profiles":["browser_agent_usability"],"score_role":"core","legacy_id":"3.11","i18n":{"nl":{"name":"Toetsenbordnavigatie","steps":["Vervang tabindex-waarden boven 0 door 0 of verwijder ze.","Gebruik native button- en a-elementen, of voeg tabindex=\"0\" en een role toe aan eigen controls."],"why":"AI-agents navigeren via toetsenbordachtige interacties in de accessibility tree. Positieve tabindex-waarden breken de focusvolgorde, en widgets zonder focus zijn onvindbaar.","fix_summary":"Verwijder positieve tabindex-waarden en maak eigen controls focusbaar.","verify_expect":null}},"ar_practice_ids":[],"strength":"SHOULD","ar_mapping":"none","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.keyboard-navigation","maturity":"recommended","applicability":{"mode":"always","condition":null,"surfaces":["website"]}}