Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Propriété CSS ruby-position

Baseline 2024
Nouvellement disponible
*

Depuis décembre 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La propriété CSS ruby-position définit la position d'un élément ruby par rapport à son élément de base. L'élément ruby peut ainsi être positionné au-dessus de l'élément (over), en-dessous (under) ou entre les caractères, sur leur droite (inter-character).

Exemple interactif

ruby-position: over;
ruby-position: under;
<section id="default-example">
  <ruby id="example-element"> 明日 <rp>(</rp><rt>Ashita</rt><rp>)</rp> </ruby>
</section>
#example-element {
  font-size: 2em;
}

Syntaxe

css
/* Valeurs avec un mot-clé */
ruby-position: over;
ruby-position: under;
ruby-position: alternate;
ruby-position: alternate over;
ruby-position: alternate under;
ruby-position: inter-character;

/* Valeurs globales */
ruby-position: inherit;
ruby-position: initial;
ruby-position: revert;
ruby-position: revert-layer;
ruby-position: unset;

Valeurs

Cette propriété est définie comme l'un des mots-clés suivants :

over

Exemple au-dessus Est un mot-clé indiquant que le ruby doit être placé au-dessus du texte principal pour les scripts horizontaux et à droite pour les scripts verticaux.

under

Exemple en-dessous Est un mot-clé indiquant que le ruby doit être placé sous le texte principal pour les scripts horizontaux et à gauche pour les scripts verticaux.

alternate

Est un mot-clé indiquant que le ruby alterne entre au-dessus et en-dessous, lorsqu'il y a plusieurs niveaux d'annotation.

inter-character

Lorsqu'il est défini, il se comporte comme over dans les modes d'écriture verticale. Sinon, il indique que le ruby doit être placé entre les différents caractères, apparaissant à droite de la base dans le texte horizontal et forçant les enfants du conteneur d'annotation ruby à avoir un mode d'écriture vertical-rl.

Définition formelle

Valeur initialealternate
Applicabilitéannotations ruby des conteneurs
Héritéeoui
Valeur calculéecomme défini
Type d'animationdiscrète

Syntaxe formelle

ruby-position = 
[ alternate || [ over | under ] ] |
inter-character

Exemples

Ruby positionné au-dessus du texte

HTML

html
<ruby>
  <rb>超電磁砲</rb>
  <rp>(</rp><rt>レールガン</rt><rp>)</rp>
</ruby>

CSS

css
ruby {
  ruby-position: over;
}

Résultat

Ruby positionné en-dessous du texte

HTML

html
<ruby>
  <rb>超電磁砲</rb>
  <rp>(</rp><rt>レールガン</rt><rp>)</rp>
</ruby>

CSS

css
ruby {
  ruby-position: under;
}

Résultat

Ruby alterné

HTML

html
<ruby>
  <rb>A</rb><rb>B</rb><rb>C</rb>
  <rtc>Above</rtc>
  <rtc>Below</rtc>
</ruby>

CSS

css
ruby {
  ruby-position: alternate; /* ceci est également la valeur initiale */
}

Résultat

Spécifications

Spécification
CSS Ruby Annotation Layout Module Level 1
# rubypos

Compatibilité des navigateurs

Voir aussi