diff --git a/site/content/docs/5.1/components/buttons.md b/site/content/docs/5.1/components/buttons.md
index d62d6e2b6506..5752615a958f 100644
--- a/site/content/docs/5.1/components/buttons.md
+++ b/site/content/docs/5.1/components/buttons.md
@@ -85,18 +85,22 @@ Disabled buttons using the `` element behave a bit different:
- ` `s don't support the `disabled` attribute, so you must add the `.disabled` class to make it visually appear disabled.
- Some future-friendly styles are included to disable all `pointer-events` on anchor buttons.
-- Disabled buttons should include the `aria-disabled="true"` attribute to indicate the state of the element to assistive technologies.
+- Disabled buttons using ` ` should include the `aria-disabled="true"` attribute to indicate the state of the element to assistive technologies.
+- Disabled buttons using ` ` *should not* include the `href` attribute.
{{< example >}}
- Primary link
-Link
+Primary link
+Link
{{< /example >}}
-{{< callout warning >}}
-##### Link functionality caveat
+### Link functionality caveat
-The `.disabled` class uses `pointer-events: none` to try to disable the link functionality of ``s, but that CSS property is not yet standardized. In addition, even in browsers that do support `pointer-events: none`, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, in addition to `aria-disabled="true"`, also include a `tabindex="-1"` attribute on these links to prevent them from receiving keyboard focus, and use custom JavaScript to disable their functionality altogether.
-{{< /callout >}}
+To cover cases where you have to keep the `href` attribute on a disabled link, the `.disabled` class uses `pointer-events: none` to try to disable the link functionality of ` `s. Note that this CSS property is not yet standardized for HTML, but all modern browsers support it. In addition, even in browsers that do support `pointer-events: none`, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, in addition to `aria-disabled="true"`, also include a `tabindex="-1"` attribute on these links to prevent them from receiving keyboard focus, and use custom JavaScript to disable their functionality altogether.
+
+{{< example >}}
+ Primary link
+Link
+{{< /example >}}
## Block buttons
@@ -157,7 +161,7 @@ Add `data-bs-toggle="button"` to toggle a button's `active` state. If you're pre
{{< example >}}
Toggle link
Active toggle link
-Disabled toggle link
+Disabled toggle link
{{< /example >}}
### Methods
diff --git a/site/content/docs/5.1/components/card.md b/site/content/docs/5.1/components/card.md
index 97bcf77d51db..3effb21d003e 100644
--- a/site/content/docs/5.1/components/card.md
+++ b/site/content/docs/5.1/components/card.md
@@ -309,7 +309,7 @@ Add some navigation to a card's header (or block) with Bootstrap's [nav componen
Link
- Disabled
+ Disabled
@@ -332,7 +332,7 @@ Add some navigation to a card's header (or block) with Bootstrap's [nav componen
Link
- Disabled
+ Disabled
diff --git a/site/content/docs/5.1/components/dropdowns.md b/site/content/docs/5.1/components/dropdowns.md
index 1668ae7bd79c..b388fb376529 100644
--- a/site/content/docs/5.1/components/dropdowns.md
+++ b/site/content/docs/5.1/components/dropdowns.md
@@ -628,7 +628,7 @@ Add `.disabled` to items in the dropdown to **style them as disabled**.
{{< example >}}
{{< /example >}}
diff --git a/site/content/docs/5.1/components/list-group.md b/site/content/docs/5.1/components/list-group.md
index c49541bdba22..cf6b06be9064 100644
--- a/site/content/docs/5.1/components/list-group.md
+++ b/site/content/docs/5.1/components/list-group.md
@@ -62,7 +62,7 @@ Be sure to **not use the standard `.btn` classes here**.
A second link item
A third link item
A fourth link item
- A disabled link item
+ A disabled link item
{{< /example >}}
diff --git a/site/content/docs/5.1/components/navbar.md b/site/content/docs/5.1/components/navbar.md
index 1abfcd16c2bd..f6dbb8e612da 100644
--- a/site/content/docs/5.1/components/navbar.md
+++ b/site/content/docs/5.1/components/navbar.md
@@ -62,7 +62,7 @@ Here's an example of all the sub-components included in a responsive light-theme
- Disabled
+ Disabled
@@ -1276,7 +1276,7 @@ شريط التنقل
- معطل
+ معطل
@@ -1332,7 +1332,7 @@ ترقيم الصفحات
{{< /example >}}
@@ -1193,7 +1193,7 @@ Navs
Link
- Disabled
+ Disabled
{{< /example >}}
@@ -1236,7 +1236,7 @@ Navbar
- Disabled
+ Disabled
@@ -1275,7 +1275,7 @@ Navbar
- Disabled
+ Disabled
@@ -1331,7 +1331,7 @@ Pagination
diff --git a/site/content/docs/5.1/examples/navbar-static/index.html b/site/content/docs/5.1/examples/navbar-static/index.html
index fe95dab47e6e..63c54c9f2495 100644
--- a/site/content/docs/5.1/examples/navbar-static/index.html
+++ b/site/content/docs/5.1/examples/navbar-static/index.html
@@ -20,7 +20,7 @@
Link
- Disabled
+ Disabled
diff --git a/site/content/docs/5.1/examples/navbars/index.html b/site/content/docs/5.1/examples/navbars/index.html
index 38281f3dd9d6..04d6ab623d0b 100644
--- a/site/content/docs/5.1/examples/navbars/index.html
+++ b/site/content/docs/5.1/examples/navbars/index.html
@@ -22,7 +22,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -79,7 +79,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -113,7 +113,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -147,7 +147,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -181,7 +181,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -215,7 +215,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -249,7 +249,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -283,7 +283,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -320,7 +320,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -352,7 +352,7 @@
Link
- Disabled
+ Disabled
Dropdown
@@ -385,7 +385,7 @@
Link
- Disabled
+ Disabled
Dropdown
diff --git a/site/content/docs/5.1/examples/sticky-footer-navbar/index.html b/site/content/docs/5.1/examples/sticky-footer-navbar/index.html
index ce036dc09cba..cd72aa778c7b 100644
--- a/site/content/docs/5.1/examples/sticky-footer-navbar/index.html
+++ b/site/content/docs/5.1/examples/sticky-footer-navbar/index.html
@@ -24,7 +24,7 @@
Link
- Disabled
+ Disabled
diff --git a/site/content/docs/5.1/utilities/interactions.md b/site/content/docs/5.1/utilities/interactions.md
index b95b98a103d2..35ea2b9959af 100644
--- a/site/content/docs/5.1/utilities/interactions.md
+++ b/site/content/docs/5.1/utilities/interactions.md
@@ -26,9 +26,12 @@ Bootstrap provides `.pe-none` and `.pe-auto` classes to prevent or add element i
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.
{{< /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 >}}
+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