bootstrap/site/content/docs/5.1
Patrick H. Lauke aa06dffdf6
Disabled link cleanup (#34886)
* Disabled link cleanup

per https://www.w3.org/TR/html-aria/#docconformance

> It is NOT RECOMMENDED to use `aria-disabled="true"` on an `a` element with an `href` attribute.
>
>NOTE
>If a link needs to be "disabled", remove the `href` attribute.

This PR removes the unnecessary `href="#"`, `tabindex="-1"`, and `aria-disabled="true"` from disabled links in both docs pages and examples. `aria-disabled="true"` *is* kept for disabled link-based buttons (that have `role="button"`) as there it's appropriate to use (you *want* to convey to assistive technologies that this thing you're claiming is a button is also disabled at the moment)

Further, the PR extends the "Link functionality caveat" to show the "proper" way (removing `href` and adding `.disabled` class only) to disable a link, but then explains what to do if that's not possible (and then keeps an example with all the traditional `href="#" tabindex="-1" aria-disabled="true"`, but explains clearly that it's not ideal). Same sort of explanation is also added to the pointer event utilities page

* Turn big note into actual normal doc text

Co-authored-by: Mark Otto <markd.otto@gmail.com>

Co-authored-by: Mark Otto <markd.otto@gmail.com>
Co-authored-by: XhmikosR <xhmikosr@gmail.com>
2021-09-06 22:14:21 +03:00
..
about Prepare v5.1.0. (#34674) 2021-08-04 18:41:51 +03:00
components Disabled link cleanup (#34886) 2021-09-06 22:14:21 +03:00
content Include root.scss in all dist builds (#34773) 2021-09-02 08:41:58 +03:00
customize docs: add `$enable-smooth-scroll` to Sass options page (#34877) 2021-09-03 00:14:20 +03:00
examples Disabled link cleanup (#34886) 2021-09-06 22:14:21 +03:00
extend docs: fix typos in approach and placeholders (#34781) 2021-08-20 18:25:03 +03:00
forms Use `path.Join` when joining paths 2021-08-31 17:24:38 +03:00
getting-started clarify importing all vs specific plugins (#34840) 2021-08-30 15:36:53 +03:00
helpers Docs: Add Callout to Stacks Helper page about limited flexbox gap support (#34910) 2021-09-06 21:48:35 +03:00
layout Prepare v5.1.0. (#34674) 2021-08-04 18:41:51 +03:00
utilities Disabled link cleanup (#34886) 2021-09-06 22:14:21 +03:00
_index.html Prepare v5.1.0. (#34674) 2021-08-04 18:41:51 +03:00
migration.md Prepare v5.1.0. (#34674) 2021-08-04 18:41:51 +03:00