Skip to main content

Utilities

Interactions

Utility classes that change how users interact with the contents of a website.

Text selection

Change the way in which the content is selected when the user interacts with it. Three values cover every case: select it all in one click, let the browser decide, or block selection outright.

This paragraph will be entirely selected when clicked by the user — handy for a ticket code or a share link.

This paragraph has default select behavior.

This paragraph will not be selectable when clicked by the user.

HTML
<p class="user-select-all">This paragraph will be entirely selected when clicked by the user — handy for a ticket code or a share link.</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>
  • .user-select-all — user-select: all
  • .user-select-auto — user-select: auto
  • .user-select-none — user-select: none
.user-select-none only stops mouse and touch selection. It does not hide content, protect it from copying, or change what a screen reader reads. Do not use it on body copy.

Pointer events

Bootstrap provides .pe-none and .pe-auto classes to prevent or add element interactions.

This link can not be clicked.

This link can be clicked (this is default behavior).

This link can not be clicked because the pointer-events property is inherited from its parent. However, this link has a pe-auto class and can be clicked.

HTML
<p><a href="#pointer-events" class="pe-none" tabindex="-1" aria-disabled="true">This link</a> can not be clicked.</p>
<p><a href="#pointer-events" class="pe-auto">This link</a> can be clicked (this is default behavior).</p>
<p class="pe-none"><a href="#pointer-events" 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="#pointer-events" class="pe-auto">this link</a> has a <code>pe-auto</code> class and can be clicked.</p>

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 — which this theme does not ship. 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.
Name clash to watch. .pe-0 through .pe-8 are padding-end classes from the spacing scale. Only .pe-none and .pe-auto touch pointer-events. This is inherited from stock Bootstrap.

In this theme

Because every component is native HTML, "disabled" is usually a real attribute rather than a pointer-events trick. A <button disabled> is skipped by the keyboard, announced correctly, and styled by Buttons without any extra class. Reach for .pe-none only on decorative layers — an overlay that should let clicks fall through, or a badge sitting over a card's stretched link.

Buy tickets Sold out
HTML
<div class="position-relative d-inline-block">
  <a href="#in-this-theme" class="btn btn-primary">Buy tickets</a>
  <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill text-bg-danger pe-none">Sold out</span>
</div>

CSS

"user-select": (
  property: user-select,
  values: all auto none
),
"pointer-events": (
  property: pointer-events,
  class: pe,
  values: none auto,
),