diff options
| author | Patrick H. Lauke <[email protected]> | 2020-07-03 12:23:28 +0100 |
|---|---|---|
| committer | GitHub <[email protected]> | 2020-07-03 12:23:28 +0100 |
| commit | 386f9e327e93d98a8b160e5f3a60c2eb70f3c569 (patch) | |
| tree | bffd73aac3ffbc36c854967bffc684b25947c155 | |
| parent | dca5ad0288acb5317c559fbe2b599c64c29c74b1 (diff) | |
| download | bootstrap-386f9e327e93d98a8b160e5f3a60c2eb70f3c569.tar.xz bootstrap-386f9e327e93d98a8b160e5f3a60c2eb70f3c569.zip | |
Docs: clarify that pointer events classes don't affect keyboard interaction (#31134)
* Docs: clarify that pointer events classes don't affect keyboard interaction
* Neutralise example links that are `pe-none`
| -rw-r--r-- | site/content/docs/5.0/utilities/interactions.md | 10 |
1 files changed, 7 insertions, 3 deletions
diff --git a/site/content/docs/5.0/utilities/interactions.md b/site/content/docs/5.0/utilities/interactions.md index 4c0c71f1b..8909e8558 100644 --- a/site/content/docs/5.0/utilities/interactions.md +++ b/site/content/docs/5.0/utilities/interactions.md @@ -18,10 +18,14 @@ Change the way in which the content is selected when the user interacts with it. ## Pointer events -Bootstrap provides `pe-none` and `pe-auto` classes to prevent or add element interactions. +Bootstrap provides `.pe-none` and `.pe-auto` classes to prevent or add element interactions. {{< example >}} -<p><a href="#" class="pe-none">This link</a> can not be clicked.</p> +<p><a href="#" class="pe-none" tabindex="-1" aria-disabled="true">This link</a> can not be clicked.</p> <p><a href="#" class="pe-auto">This link</a> can be clicked (this is default behaviour).</p> -<p class="pe-none"><a href="#">This link</a> can not be clicked because the <code>pointer-events</code> property is inherited from its parent. However, <a href="#" class="pe-auto">this link</a> has a <code>pe-auto</code> class and can be clicked.</p> +<p class="pe-none"><a href="#" tabindex="-1" aria-disabled="true">This link</a> can not be clicked because the <code>pointer-events</code> property is inherited from its parent. However, <a href="#" class="pe-auto">this link</a> has a <code>pe-auto</code> class and can be clicked.</p> {{< /example >}} + +{{< callout warning >}} +The `.pe-none` class (and the `pointer-events` CSS property it sets) only prevents interactions with a pointer (mouse, stylus, touch). Links and controls with `.pe-none` are, by default, still focusable and actionable for keyboard users. To ensure that they are completely neutralized even for keyboard users, you may need to add further attributes such as `tabindex="-1"` (to prevent them from receiving keyboard focus) and `aria-disabled="true"` (to convey the fact they are effectively disabled to assistive technologies), and possibly use JavaScript to completely prevent them from being actionable. For form controls, consider using the `disabled` HTML attribute instead. +{{< /callout >}}
\ No newline at end of file |