diff options
author | Julien Déramond <juderamond@gmail.com> | 2022-10-10 22:15:43 +0300 |
---|---|---|
committer | Mark Otto <otto@github.com> | 2022-10-12 21:45:46 +0300 |
commit | 137c932e473d5b14c79c6b143a3ea344aa108612 (patch) | |
tree | d13462ad3cd3e0bab678e03b49b261eafaf58b10 /site/content/docs/5.2/components/popovers.md | |
parent | 7a2f7b06ce082c0a2c11add9f8d5d6a3e18cb275 (diff) |
Docs: standardize usage of `<kbd>`
Diffstat (limited to 'site/content/docs/5.2/components/popovers.md')
-rw-r--r-- | site/content/docs/5.2/components/popovers.md | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/site/content/docs/5.2/components/popovers.md b/site/content/docs/5.2/components/popovers.md index 9726c30342..bbcd938ac4 100644 --- a/site/content/docs/5.2/components/popovers.md +++ b/site/content/docs/5.2/components/popovers.md @@ -171,7 +171,7 @@ To allow keyboard users to activate your popovers, you should only add them to H While you can insert rich, structured HTML in popovers with the `html` option, we strongly recommend that you avoid adding an excessive amount of content. The way popovers currently work is that, once displayed, their content is tied to the trigger element with the `aria-describedby` attribute. As a result, the entirety of the popover's content will be announced to assistive technology users as one long, uninterrupted stream. -Additionally, while it is possible to also include interactive controls (such as form elements or links) in your popover (by adding these elements to the `allowList` of allowed attributes and tags), be aware that currently the popover does not manage keyboard focus order. When a keyboard user opens a popover, focus remains on the triggering element, and as the popover usually does not immediately follow the trigger in the document's structure, there is no guarantee that moving forward/pressing <kbd>TAB</kbd> will move a keyboard user into the popover itself. In short, simply adding interactive controls to a popover is likely to make these controls unreachable/unusable for keyboard users and users of assistive technologies, or at the very least make for an illogical overall focus order. In these cases, consider using a modal dialog instead. +Additionally, while it is possible to also include interactive controls (such as form elements or links) in your popover (by adding these elements to the `allowList` of allowed attributes and tags), be aware that currently the popover does not manage keyboard focus order. When a keyboard user opens a popover, focus remains on the triggering element, and as the popover usually does not immediately follow the trigger in the document's structure, there is no guarantee that moving forward/pressing <kbd>Tab</kbd> will move a keyboard user into the popover itself. In short, simply adding interactive controls to a popover is likely to make these controls unreachable/unusable for keyboard users and users of assistive technologies, or at the very least make for an illogical overall focus order. In these cases, consider using a modal dialog instead. {{< /callout >}} ### Options |