Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ruby — courtes annotations de texte

L’élément `ruby` associe un texte de base à une courte annotation, par exemple un guide de prononciation pour des caractères japonais.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<ruby>base text<rp>(</rp><rt>annotation</rt><rp>)</rp></ruby>

ruby marque un texte de base accompagné d’annotations, souvent utilisées dans la typographie d’Asie de l’Est. rt contient l’annotation ; les éléments rp, facultatifs, l’entourent de caractères de remplacement pour les navigateurs qui ne prennent pas en charge ruby. Ces caractères ne font pas partie de l’annotation.

Utilisez ruby là où le contenu phrasé est autorisé. Faites suivre le texte de base par rt ; ces paires peuvent être répétées. Les balises ouvrante et fermante ruby sont toutes deux obligatoires. L’élément prend en charge les attributs globaux. Il sert à marquer la relation entre un texte et une annotation, et non simplement à réduire la taille de la police.

Exemples

<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <title>Ruby</title>
</head>
<body>
  <p><ruby>漢字<rp>(</rp><rt>かんじ</rt><rp>)</rp></ruby></p>
</body>
</html>

Résultat

Base: 漢字; annotation: かんじ; fallback: 漢字(かんじ).

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources