Tooltip component naming is misleading

[danielck]

The Problem

Tooltips are small pieces of information that e.g. explain what a certain button or tool does. They are not themselves focusable and should not contain focusable elements. The contents of the tooltip should be referenced from the tool/control it describes using aria-describedby. This means the text should not be very long. There is also an ARIA role "tooltip", which is specifically for this kind of purpose.

Even though this component does not use the ARIA role, the name itself is misleading, because it is not intended to be used as a "tip" for a "tool", but rather as additional information about some adjacent text of form control. The tip does not concern the info toggle itself but something else. We should avoid using names that match or are similar to existing ARIA roles when the behaviour or structure do not match.

Proposed Solution

Rename to e.g. Toggletip.

Additional Info

Use of term 'toggletip':

• https://inclusive-components.design/tooltips-toggletips/
• https://www.tpgi.com/simple-standalone-toggletip-widget-pattern/
• ARIA tooltip role on MDN: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/tooltip_role