<ruby>

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

Сам элемент <ruby> выступает контейнером для <rt>, он и формирует аннотацию к тексту, после которого идёт; а также <rp>, этот элемент предназначен для браузеров, которые не поддерживают <ruby>.

Название происходит от слова «рубин», которым в типографии обозначается небольшой шрифт.

Синтаксис

<ruby>
 текст
 <rt>аннотация</rt>
</ruby>

Атрибуты

Для этого элемента доступны универсальные атрибуты и события.

Пример

<!DOCTYPE html> <html lang="ru"> <head> <meta charset="utf-8"> <title>ruby</title> <style> p:lang(zh-CN) { font-size: 2em; } </style> </head> <body> <p lang="zh-CN"> <ruby> 汉<rt>hàn</rt> 字<rt>zì</rt> </ruby> </p> </body> </html>

Результат примера показан на рис. 1.

Иероглифы, оформленные с помощью тега ruby

Рис. 1. Иероглифы, оформленные с помощью <ruby>

Примечание

Браузеры, которые не поддерживают этот элемент, отобразят текст рядом по горизонтали и без изменения его размеров (рис. 2).

Вид текста в браузерах, не поддерживающих тег ruby

Рис. 2. Вид текста в браузерах, не поддерживающих <ruby>

Спецификация

Спецификация Статус
HTML Living Standard Живой стандарт

Браузеры

9 12 5 15 5 38
4.4 38 15 4.2

В таблице браузеров применяются следующие обозначения.

  • — элемент полностью поддерживается браузером;
  • — элемент браузером не воспринимается и игнорируется;
  • — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.

Число указывает версию браузреа, начиная с которой элемент поддерживается.

См. также