From 0362deda3ebee1257e3e16da6f914eccf209caa7 Mon Sep 17 00:00:00 2001 From: Tabitha Hsia Date: Mon, 25 Sep 2023 12:35:55 -0700 Subject: [PATCH 1/2] Updated TooltipBestPractices --- .../src/react/Tooltip/docs/TooltipBestPractices.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md b/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md index 69d23c3c96320..009788f350430 100644 --- a/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md +++ b/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md @@ -16,3 +16,7 @@ For a truncated label or a label that’s likely to truncate in some langua - Provide the untruncated label in the tooltip. - Don't provide a tooltip if the untruncated info is provided elsewhere on the page or flow. - Optional: On another line, provide a clarifying description, but only if needed. + +### Accessibility + +- Don't add tooltips to unfocusable or disabled controls. Screen readers can't consistently access or read tooltips associated with elements that can't receive focus or are disabled. Consider having the information statically available on the page or through a "help"-style toggle button. From 3f7c1ec5300afe810b373c4422da541ddf3cc84c Mon Sep 17 00:00:00 2001 From: Tabitha Date: Mon, 25 Sep 2023 13:27:23 -0700 Subject: [PATCH 2/2] Update packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md Co-authored-by: Sarah Higley --- .../src/react/Tooltip/docs/TooltipBestPractices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md b/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md index 009788f350430..05f9f06784a11 100644 --- a/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md +++ b/packages/react-examples/src/react/Tooltip/docs/TooltipBestPractices.md @@ -19,4 +19,4 @@ For a truncated label or a label that’s likely to truncate in some langua ### Accessibility -- Don't add tooltips to unfocusable or disabled controls. Screen readers can't consistently access or read tooltips associated with elements that can't receive focus or are disabled. Consider having the information statically available on the page or through a "help"-style toggle button. +- Don't add tooltips to unfocusable or disabled controls. People using the keyboard or screen readers can't consistently access or read tooltips associated with elements that can't receive focus or are disabled. Consider having the information statically available on the page or through a "help"-style toggle button.