Тег <ruby>


Описание

Тег <ruby> используется для добавления фонетических аннотаций (руби-текста) к основному тексту, преимущественно в восточноазиатских языках (японском, китайском, корейском). Создает семантическую связь между базовым текстом и его пояснением.

Базовый синтаксис:
<ruby> 漢字 <rt>かんじ</rt> </ruby>

Ключевые особенности:

  • Контейнер для ruby-разметки (базовый текст + аннотация)
  • Поддерживает вложенные <rb>, <rt>, <rp>, <rtc>
  • По умолчанию аннотация отображается мелким шрифтом сверху
  • Позиционирование можно изменить через CSS (ruby-position)
  • Полная поддержка в современных браузерах
Примеры использования:
<!-- Японский пример (фуригана) --> <ruby> 日本語 <rt>にほんご</rt> </ruby> <!-- Китайский пример (пиньинь) --> <ruby> 北京 <rt>Běijīng</rt> </ruby> <!-- Сложный пример с группировкой --> <ruby> <rb>漢</rb><rt>かん</rt> <rb>字</rb><rt>じ</rt> </ruby> <!-- С fallback для старых браузеров --> <ruby> 漢字 <rp>(</rp><rt>かんじ</rt><rp>)</rp> </ruby>

Стилизация через CSS:

<style> ruby { font-size: 24px; ruby-position: under; /* over (по умолчанию) или under */ } rt { font-size: 0.5em; color: #e74c3c; } rp { display: none; /* Скрываем скобки в современных браузерах */ } </style> <ruby> 東京 <rp>(</rp><rt>とうきょう</rt><rp>)</rp> </ruby>

Рекомендации по использованию:

  • Используйте для восточноазиатских языков и лингвистических целей
  • Всегда добавляйте <rp> для совместимости
  • Для сложных иероглифов применяйте группировку с <rb>
  • Тестируйте отображение на разных устройствах
  • Не используйте для обычных надстрочных/подстрочных индексов

Тег <ruby> предоставляет стандартизированный способ добавления фонетических аннотаций, критически важный для правильного отображения и изучения восточноазиатских письменностей в вебе.


Атрибуты

accesskey Горячая клавиша для активации элемента
class CSS-классы для стилизации элемента
contenteditable Разрешает редактирование содержимого
data-* Пользовательские данные элемента
dir Направление текста (ltr|rtl)
hidden Скрывает элемент от отображения
id Уникальный идентификатор элемента
lang Язык содержимого элемента
spellcheck Включает проверку орфографии
style Инлайновые CSS-стили элемента
tabindex Порядок перехода при навигации по Tab
title Всплывающая подсказка для элемента
translate Определяет возможность перевода содержимого

Поддержка браузерами

5.5 5.0 15.0 38.0 5.0