Skip to content

Commit 8c1e07e

Browse files
jelbournjosephperrott
authored andcommitted
docs(tooltip): expand a11y section with guidance on interactions (#11141)
1 parent 71ac0ae commit 8c1e07e

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

src/lib/tooltip/tooltip.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,4 +66,10 @@ shown.
6666
Elements with the `matTooltip` will add an `aria-describedby` label that provides a reference
6767
to a visually hidden element containing the tooltip's message. This provides screenreaders the
6868
information needed to read out the tooltip's contents when the end-user focuses on the element
69-
triggering the tooltip.
69+
triggering the tooltip. The element referenced via `aria-describedby` is not the tooltip itself,
70+
but instead an invisible copy of the tooltip content that is always present in the DOM.
71+
72+
If a tooltip will only be shown manually via click, keypress, etc., then extra care should be taken
73+
such that the action behaves similarly for screen-reader users. One possible approach would be
74+
to use the `LiveAnnouncer` from the `cdk/a11y` package to announce the tooltip content on such
75+
an interaction.

0 commit comments

Comments
 (0)