Элемент <ruby>


9	12	5	15	5	38


4.4	38	15	4.2

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

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

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

Синтаксис

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

	Описание	Пример
<тип>	Указывает тип значения.	<размер>
A && B	Значения должны выводиться в указанном порядке.	<размер> && <цвет>
A \| B	Указывает, что надо выбрать только одно значение из предложенных (A или B).	normal \| small-caps
A \|\| B	Каждое значение может использоваться самостоятельно или совместно с другими в произвольном порядке.	width \|\| count
[ ]	Группирует значения.	[ crop \|\| cross ]
*	Повторять ноль или больше раз.	[,<время>]*
+	Повторять один или больше раз.	<число>+
?	Указанный тип, слово или группа не является обязательным.	inset?
{A, B}	Повторять не менее A, но не более B раз.	<радиус>{1,4}
#	Повторять один или больше раз через запятую.	<время>#

Атрибуты

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

Пример

<!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).

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

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

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