diff options
| author | Bobby <[email protected]> | 2024-08-16 20:47:33 -0400 |
|---|---|---|
| committer | GitHub <[email protected]> | 2024-08-16 20:47:33 -0400 |
| commit | 6b28433d9cfde435be8ec2bd6cf91e6324d08865 (patch) | |
| tree | 8343c27b8b95ff5639233e81cf157f92e5688466 /site/content/docs/5.1/utilities/interactions.md | |
| parent | d53094ec16ba385faae2973ddee648698b32ab24 (diff) | |
| parent | 048f56f51460df75e92a2f7b472e1c56baeb68f7 (diff) | |
| download | bootstrap-main.tar.xz bootstrap-main.zip | |
Diffstat (limited to 'site/content/docs/5.1/utilities/interactions.md')
| -rw-r--r-- | site/content/docs/5.1/utilities/interactions.md | 42 |
1 files changed, 0 insertions, 42 deletions
diff --git a/site/content/docs/5.1/utilities/interactions.md b/site/content/docs/5.1/utilities/interactions.md deleted file mode 100644 index 35ea2b995..000000000 --- a/site/content/docs/5.1/utilities/interactions.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -layout: docs -title: Interactions -description: Utility classes that change how users interact with contents of a website. -group: utilities -toc: false ---- - -## Text selection - -Change the way in which the content is selected when the user interacts with it. - -{{< example >}} -<p class="user-select-all">This paragraph will be entirely selected when clicked by the user.</p> -<p class="user-select-auto">This paragraph has default select behavior.</p> -<p class="user-select-none">This paragraph will not be selectable when clicked by the user.</p> -{{< /example >}} - -## Pointer events - -Bootstrap provides `.pe-none` and `.pe-auto` classes to prevent or add element interactions. - -{{< example >}} -<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 behavior).</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 >}} - -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. - -If possible, the simpler solution is: - -- For form controls, add the `disabled` HTML attribute. -* For links, remove the `href` attribute, making it a non-interactive anchor or placeholder link. - -## Sass - -### Utilities API - -Interaction utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}}) - -{{< scss-docs name="utils-interaction" file="scss/_utilities.scss" >}} |
