diff --git a/packages/tooltip/README.md b/packages/tooltip/README.md index 00ce86e7c20..7a6882a41d6 100644 --- a/packages/tooltip/README.md +++ b/packages/tooltip/README.md @@ -46,8 +46,7 @@ Tooltips can be top, bottom, left, or right. By default, Tooltip provides styling without behavior. You must combine it with an [Overlay Trigger](https://opensource.adobe.com/spectrum-web-components/components/overlay-trigger/#%22hover%22-content-only) in order to manage its overlay behavior. -You can instead apply the `self-managed` attribute for this common case, -which automaticaly binds to the parent element's hover interaction: +You can use the tooltip as the descendant of an interactive element, such as [Action Button](https://opensource.adobe.com/spectrum-web-components/components/action-button/), by applying the `self-managed` attribute which automatically binds the Tooltip to its first interactive ancestor element's focus/hover interactions: ```html @@ -59,6 +58,21 @@ which automaticaly binds to the parent element's hover interaction: This is especially useful when inserting an intermediate `` would interfere with parent/child relationships, such as between `` and ``. +Note that an interactive element is an element that can receive focus during tab navigation, such as `sp-action-button`, `sp-action-menu`, `sp-field-label` etc. + +Given that tooltip is not focusable by itself, it would not show up during tab navigation. Thus a tooltip would not be accessible if used with a non-interactive element, such as ``. + +The correct way to make it accessible would be to wrap it under an interactive element, such as `sp-action-button`: + +```html + + + + Display something here + + +``` + ## Variants ### Informative