Add utility class for the user-select property (#30035)

* Add utility class for the user-select property

* Docs: Add new page for behavior utility classes - includes user select utility

* Update and rename behaviors.md to interactions.md

* Update sidebar.yml

Co-authored-by: Mark Otto <otto@github.com>
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
Co-authored-by: Martijn Cuppens <martijn.cuppens@gmail.com>

diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index 60ac6dac27418fd8ea795607084ce1f862675b66..dc3bd7238b2795faac0de3767ac327076c4fc158 100644 (file)
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -443,6 +443,10 @@ $utilities: map-merge(
       class: font,
       values: (monospace: $font-family-monospace)
     ),
+    "user-select": (
+      property: user-select,
+      values: all auto none
+    ),
     "rounded": (
       property: border-radius,
       class: rounded,

diff --git a/site/content/docs/4.3/utilities/interactions.md b/site/content/docs/4.3/utilities/interactions.md
new file mode 100644 (file)
index 0000000..13ca4ef
--- /dev/null
+++ b/site/content/docs/4.3/utilities/interactions.md
@@ -0,0 +1,17 @@
+---
+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 >}}

diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml
index dd6a3676ac645fb95a36b6d73303977757ed3f99..c1f9e3cc9f93bddcd73f055a7e600bf904d352c1 100644 (file)
--- a/site/data/sidebar.yml
+++ b/site/data/sidebar.yml
@@ -80,6 +80,7 @@
     - title: Display
     - title: Flex
     - title: Float
+    - title: Interactions
     - title: Overflow
     - title: Position
     - title: Shadows