{"canonical_url":"https://engineer.company/glossary/accessibility/","content_markdown":"# Accessibility\n\n## What it is\n\nWeb accessibility is how well a website, an app or a tool works for people with disabilities. The\nW3C's Web Accessibility Initiative (WAI) defines it by what people can do: \"perceive, understand,\nnavigate, and interact with the Web\", and contribute to it. The last verb carries weight: a site\nwhere a blind visitor can read every article but cannot post a comment, upload a file or finish a\nsign-up has met half the definition. The usual shorthand, a11y, counts the eleven letters between\nthe a and the y.\n\nThe scope is every disability that affects access to the web. WAI lists auditory, cognitive,\nneurological, physical, speech and visual, and each brings its own barriers: video without captions,\ninstructions that lean on memory, motion that triggers symptoms, controls that need a steady hand\nand a mouse, voice interfaces that expect fluent speech, text that works at one size and one\ncontrast only.\n\nUnderneath the visible page, the browser builds a second structure for assistive technology. The\nARIA specification calls it the accessibility tree: a tree of accessible objects in which each node\nrepresents an element of the interface, such as a push button or a check box, exposed through the\nplatform's accessibility API. Screen readers, voice control, switch devices and braille displays\nwork from that tree rather than from pixels. Each node carries a name, a role and a state, and under\nWCAG's criterion 4.1.2 Name, Role, Value, software must be able to determine them for every\ninterface component. Native HTML controls, the standard notes, already meet 4.1.2 when used\naccording to specification. A `div` with a click handler arrives in the tree as generic text, with\nno role and no place in the keyboard order.\n\nAccessibility depends on several parts working together, WAI notes: web technologies, browsers,\nauthoring tools and the websites themselves. A site owner controls the last of these, which is where\nWCAG sets out in testable terms what content has to do.\n\n## Why it matters\n\nThe web carries education, work, government services, shopping and health care, and WAI points out\nthat the UN Convention on the Rights of Persons with Disabilities defines access to information and\ncommunications technology, the web included, as a basic human right. Accessibility is also required\nby law in many situations, and buyers turn that into a contract line naming WCAG 2.2 Level AA. That\nline decides what the supplier has to build and prove.\n\nThe same work serves people who would never call themselves disabled. WAI's own list includes people\non phones, watches and televisions with small screens and different input modes, older people whose\nabilities change with age, someone with a broken arm or lost glasses, someone in bright sunlight or\nin a place where audio cannot be played, and anyone on a slow or expensive connection. Captions help\non a silent train, and strong contrast helps on a phone at noon.\n\nTiming sets the price. WAI calls it most efficient to build accessibility in from the very start of\na project, so that work does not have to be redone. Choosing a native button costs nothing on the\nfirst day. Replacing a hand-built one after launch means fixing the component, then re-testing every\npage that used it, in every language and theme the site ships.\n\nEvaluation follows the same logic. Tools help, but WAI is plain that no tool alone can determine\nwhether a site meets accessibility guidelines and that knowledgeable human evaluation is required. A\nrule engine reads what the markup says. A person with a keyboard and a screen reader finds out what\nthe page does.\n\n## What it looks like in practice\n\nEleven defects survived on a site that passed its automated accessibility rules, because each was a\nproperty of how the page rendered rather than of what the markup said, and\n[fixing eleven defects the browser called healthy](/portfolio/the-accessibility-faults-your-checker-misses/)\nstarted from that gap. Eight footer links stayed\nin the tab order behind a property that removes pointer interaction and nothing else, so a keyboard\ncould land on links that were invisible on screen. Two defects sat in the guards themselves: every\nwindow the layout check opened was nine hundred pixels tall, so on a landscape phone at 852 by 393\ntwo items sat seven pixels apart with nobody looking, and the rule engine had been running seventy\nof its hundred and five rules. Four rules came out of the work, among them that a guard testing one\naxis defends one axis and that visibility is proved in pixels rather than in the document. Reopened\nproperly, the layout check failed a hundred and twenty-eight times across three languages.\n\nAn application built with SwiftUI needed the same work in another form,\n[naming all seventeen icon-only controls](/portfolio/named-all-17-icons-for-screen-readers/).\nA system symbol with no accessibility\nlabel is read out by its internal name, so the send button announced itself as \"arrow up circle,\nbutton\", and every other icon-only control did the same in its own way: seventeen in all described\ntheir artwork instead of their function. Each now has a label that names the action, and where the\nmeaning depends on state, the label follows the state. A linter requires a label within eight lines\nof any construction that creates an icon-only control, a deliberately crude rule chosen by\nmeasurement, so an eighteenth control cannot be added without one. The rule has a limit of its own:\nit proves a label exists nearby, and whether the label is right still takes someone listening.\n\nThe same structure now serves a newer reader too, the subject of\n[readiness for AI agents](/ai-ready/). Many agents that work a browser read a page the way a screen\nreader does, through its accessibility tree, so the real buttons, labelled forms, headings in order\nand landmarks that make a site usable without a mouse are the same work that lets an agent find a\nform and fill it in.\n\n## Where it goes wrong\n\n**A custom dropdown works with a mouse and traps everyone else.** A `div` with a click handler has\nno role, takes no keyboard focus and reports no open or closed state, so a screen reader announces\nplain text and the Tab key passes it by. Start from the native element, `select`, `button` or\n`details`, which brings role, focus and state with it. When a design truly needs a custom widget,\nfollow its pattern in the ARIA Authoring Practices Guide, then test it with a keyboard and a screen\nreader.\n\n**Alt text describes the picture when the reader needed its job.** 1.1.1 Non-text Content asks for a\ntext alternative that serves the same purpose, and a linked logo described as \"blue hexagon logo\"\ntells a screen reader user nothing about where the link goes. Write the alternative for the image's\nrole: the destination for a linked image, the finding for a chart, the words for an image of text.\nGive purely decorative images an empty `alt=\"\"` so assistive technology passes over them.\n\n**Focus drops to the top of the page after a dialog closes.** Closing a dialog or changing route in\na single-page app removes the element that had focus, focus falls back to the document body, and a\nkeyboard or screen reader user loses their place. Return focus to the control that opened the\ndialog. After a client-side route change, move focus to the new view's main heading, given\n`tabindex=\"-1\"` so it can take focus, and the screen reader announces where the user has arrived.\n\n**Errors appear only as a red border.** 1.4.1 Use of Color requires that colour is not the only\nvisual means of conveying information, and 3.3.1 Error Identification asks that a detected input\nerror is identified and described to the user in text. A red outline does neither for someone who\ncannot tell red from grey or cannot see the field at all. Put a short message beside the field that\nsays what is wrong and how to fix it, connect it with `aria-describedby` so a screen reader reads\nboth together, and keep the colour as a second signal.\n\n## Further reading\n\n- [Introduction to Web Accessibility](https://www.w3.org/WAI/fundamentals/accessibility-intro/) —\n  WAI's definition, who benefits, and why evaluation needs people as well as tools.\n- [How People with Disabilities Use the Web](https://www.w3.org/WAI/people-use-web/) — stories of\n  users, the barriers they meet and the tools and techniques they rely on.\n- [The Business Case for Digital Accessibility](https://www.w3.org/WAI/business-case/) — reach,\n  innovation, brand and legal risk, set out for the people who approve budgets.\n- [Evaluating Web Accessibility Overview](https://www.w3.org/WAI/test-evaluate/) — from easy checks\n  to a full conformance evaluation, with tools and reporting.\n- [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) — patterns for custom widgets,\n  with the roles, states and keyboard behaviour each one needs.\n\n\u003chttps://engineer.company/glossary/accessibility/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"What web accessibility covers, who it serves beyond people with disabilities, how a page reaches assistive technology, and where builds usually break it.","formats":{"gemtext":"https://engineer.company/glossary/accessibility/index.gmi","gopher":"https://engineer.company/glossary/accessibility/gophermap","html":"https://engineer.company/glossary/accessibility/","json":"https://engineer.company/glossary/accessibility/index.json","markdown":"https://engineer.company/glossary/accessibility/index.md","pdf":"https://engineer.company/glossary/accessibility/index.pdf"},"kind":"page","language":"en","title":"What is accessibility?","url":"https://engineer.company/glossary/accessibility/","version":1}