Вебсправочник
Справочник HTML

Тег <ruby>: пояснение произношения рядом с текстом

Ruby связывает основной фрагмент с короткой аннотацией, например чтением иероглифа. Это смысловая разметка для пояснения, а не универсальный способ поставить мелкую подпись над любым словом.

Назначение

Ruby связывает основной фрагмент с короткой аннотацией, например чтением иероглифа. Это смысловая разметка для пояснения, а не универсальный способ поставить мелкую подпись над любым словом.

Как это работает

Основной текст размещается в ruby, аннотация — в rt. Элементы rp дают запасные скобки для представления без поддержки ruby. Отображение зависит от браузера, шрифта и направления письма.

Пример

<p>Пример японского слова: <ruby lang="ja">山<rp>(</rp><rt>やま</rt><rp>)</rp></ruby></p>
<p>В учебном примере аннотация показывает чтение слова «гора».</p>

Что должно получиться

При поддержке ruby чтение располагается рядом с основным знаком в специальном формате. В запасном представлении скобки помогают отделить пояснение от исходного текста.

Граница применения и частая ошибка

Не используйте ruby вместо подсказки для важного интерфейсного действия: мелкая аннотация может плохо читаться. Указывайте язык именно того фрагмента, к которому он относится, и проверяйте произношение текста со специалистом при подготовке языкового материала.

Самостоятельная проверка

Увеличьте масштаб, попробуйте другой шрифт и проверьте выделение текста. Сравните страницу с обычной записью «山 (やま)». Убедитесь, что смысл не зависит от точного положения аннотации.

HTML и CSS можно изменить в песочнице ниже. Она изолирована: JavaScript, внешние ресурсы и отправка форм отключены. Проверки печати, загрузки файлов и сетевых ответов выполняйте в отдельном учебном проекте.

Попробуйте сами

HTML + CSS песочница
РЕЗУЛЬТАТ · ИЗОЛИРОВАННЫЙ ПРЕДПРОСМОТР
Измените код и нажмите «Запустить». JavaScript и внешние запросы отключены.
Самостоятельный учебный материал. Техническая документация: первоисточник по теме ↗. Если результат отличается, проверьте код и версию браузера.