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

ruby-position

Baseline 2024 *
Nouvellement disponible

Depuis December 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

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 Expérimental

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