From 7076d7286e72312c372322e35d61cca1fcacfdd7 Mon Sep 17 00:00:00 2001 From: Estelle Weyl Date: Thu, 20 Jun 2024 20:26:03 -0700 Subject: [PATCH] #33034: accessible description (#33929) * #33034: accessible description fixes #33034 * Apply suggestions from code review Co-authored-by: Hoarfroster * see also * rework the suggested edits * Update files/en-us/glossary/accessible_description/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * layout * Update files/en-us/glossary/accessible_description/index.md Co-authored-by: Hoarfroster * combine svg and html computations * Apply suggestions from code review Co-authored-by: Vadim Makeev --------- Co-authored-by: Hoarfroster Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Vadim Makeev --- .../glossary/accessible_description/index.md | 45 +++++++++++++++---- 1 file changed, 36 insertions(+), 9 deletions(-) diff --git a/files/en-us/glossary/accessible_description/index.md b/files/en-us/glossary/accessible_description/index.md index c42ef0e3bf6e701..cd002f3d0a1c428 100644 --- a/files/en-us/glossary/accessible_description/index.md +++ b/files/en-us/glossary/accessible_description/index.md @@ -6,22 +6,49 @@ page-type: glossary-definition {{GlossarySidebar}} -An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It is a text description associated with an HTML element that provides users of assistive technology with a description for the element beyond what is provided by the element's {{glossary("accessible name")}}. +An **accessible description** is the description of a user interface element that provides additional information to help users of assistive technology understand the UI element and its context. It's associated with an HTML or SVG element and gives users additional context about its purpose beyond what is provided by the element's {{glossary("accessible name")}}. This is particularly important for users who rely on assistive technologies like {{glossary("Screen_reader", "screen readers")}}. An element's accessible description is part of the {{glossary("accessibility tree")}}. -An element's accessible description is part of the {{glossary("accessibility tree")}} that makes web content available to {{glossary("Screen_reader", "screen readers")}} and other assistive technologies, which, in turn, make that content available to the users of those technologies. +For example, the accessible name of a {{htmlelement("table")}} is provided by its first {{htmlelement("caption")}}. In the case of complex data tables, a sentence or two describing the table can provide a description. This can be a paragraph right before or after the table, both visually and in source code order. If elsewhere in source order, or to make the associate explicit, the [`aria-describedby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-describedby) attribute can be used to associate the table with its description. -The accessible description for a {{htmlelement("table")}} is its first {{htmlelement("caption")}}, for the {{htmlelement("figure")}}, is the {{htmlelement("figcaption")}}, for the {{htmlelement("summary")}}, is the content of the {{htmlelement("details")}} it is nested in, and for the button {{htmlelement("input")}} elements, it is the `value` attribute's value, unless the element also has a `aria-describedby` or `aria-description` attribute, which takes precedence. +Similarly, when a user is asked to create a password, the `