tooltip

Роль структуры документа из WAI-ARIA. Означает, что элемент тултип. Тултипом называют небольшую подсказку к элементу, которая появляется при наведении курсора, фокусе с клавиатуры и тапе на мобильном устройстве.

В HTML нет тега с такой ролью.

        
          
          <button aria-labelledby="tooltip">❤️</button><span  role="tooltip"  id="tooltip">  Поставить отметку «Нравится»</span>
          <button aria-labelledby="tooltip">❤️</button>
<span
  role="tooltip"
  id="tooltip"
>
  Поставить отметку «Нравится»
</span>

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Скринридеры прочтут код примерно так: «Поставить отметку "Нравится", кнопка».

Добавьте к тегу role="tooltip". Лучше добавлять роль к неинтерактивным элементам. Например, к <div> или <span>.

Тултип всегда зависит от другого элемента и должен быть связан с ним с помощью атрибутов aria-describedby или aria-labelledby. aria-describedby подойдёт для случаев, когда в тултипе содержится развёрнутая подсказка. aria-labelledby нужен для краткого видимого названия элемента. Добавьте подходящий атрибут к главному элементу, а id — к тултипу. Если не свяжите тултип с основным элементом, скринридер не прочтёт текст пользователям. Так что, пока роль tooltip ни на что не влияет.

У элемента с role="tooltip" обязательно должно быть имя. Это краткое название элемента. Без имени пользователь скринридера не узнает о подсказке. Проще добавить текст внутрь тега, но можно использовать и другие способы. Например, aria-label.

Пример тултипа в Руководстве по авторским ARIA-практикам (APG).

• Должен быть связан с интерактивным элементом, который описывает. Например, с кнопкой, ссылкой или полем. Так что, связывать тултип с иконкой вопроса рядом с полем не очень хорошая практика.
• На нём нельзя сделать фокус, он не должен быть интерактивным.
• Не содержит интерактивные элементы, только небольшую текстовую подсказку.
• Становится видимым при наведении мыши на элемент, клавиатурном фокусе и тапе.
• Исчезает при убирании курсора и при потере клавиатурного фокуса.
• Закрывается при нажатии на Ctrl (Command, ⌘ на macOS) или Esc.