Merge pull request #18679 from patrickhlauke/docs-button-disabled1

Docs: add aria-disabled to disabled link example and description

1 files changed, 3 insertions, 3 deletions

diff --git a/docs/components/buttons.md b/docs/components/buttons.md
index 10fdd4e60..4e8d58ab3 100644
--- a/docs/components/buttons.md
+++ b/docs/components/buttons.md
@@ -115,11 +115,11 @@ Make buttons look inactive by adding the `disabled` boolean attribute to any `<b
 <button type="button" class="btn btn-secondary btn-lg" disabled>Button</button>
 {% endexample %}
 
-As `<a>` elements don't support the `disabled` attribute, you must add the `.disabled` class to fake it.
+As `<a>` elements don't support the `disabled` attribute, you must add the `.disabled` class to fake it. In addition, include the `aria-disabled="true"` attribute, to indicate the state of the element to assistive technologies.
 
 {% example html %}
-<a href="#" class="btn btn-primary btn-lg disabled" role="button">Primary link</a>
-<a href="#" class="btn btn-secondary btn-lg disabled" role="button">Link</a>
+<a href="#" class="btn btn-primary btn-lg disabled" role="button" aria-disabled="true">Primary link</a>
+<a href="#" class="btn btn-secondary btn-lg disabled" role="button" aria-disabled="true">Link</a>
 {% endexample %}
 
 {% callout warning %}