Alignment-baseline - Propriété CSS

alignment-baseline

Résumé des caractéristiques de la propriété alignment-baseline

Description rapide
Définit comment un élément est aligné, dans le sens vertical, par rapport à son parent.
Statut
Standard
S'applique à
Balises text, textPath et tspan.
Utilisable sur
SVG
Valeurs prédéfinies
baseline | middle | central | hanging | alphabetic | mathematical | ideographic | text-before-edge | text-after-edge | text-bottom | text-top
Pourcentages
Ne s'appliquent pas.
Valeur initiale
baseline
Héritée par défaut
Non.
Discrète : lors d'une animation, la propriété alignment-baseline passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Mise en page en ligne
Statut du document: WD (document de travail)

Schéma de la syntaxe de alignment-baseline.

alignment-baseline - Syntax DiagramSyntax diagram of the alignment-baseline CSS property. auto auto baseline baseline alphabetic alphabetic ideographic ideographic middle middle central central mathematical mathematical text-bottom text-bottom text-top text-topalignment-baseline:;alignment-baseline:;
Schéma syntaxique de la propriété alignment-baseline.
Cliquez sur les liens du schéma pour plus de précisons sur les valeurs.

Description de la propriété alignment-baseline.

La propriété alignment-baseline définit quelle est la ligne de référence pour l'alignement vertical d'un élément, par rapport à la ligne de référence du parent. Cette propriété ne s'applique que aux élément du type inline

Un écart par rapport à cette ligne de référence peut être défini par baseline-shift.
Consultez également la page sur vertical-align qui est une propriété résumée, et également dominant-baseline.

Valeurs pour alignment-baseline.

Tous les exemples qui suivent sont réalisés en SVG. La propriété alignment-baseline est en effet mieux supportée par les navigateurs en SVG.

  • alignment-baseline: auto;

    Cette valeur est équivalente à baseline.

    SVG
    parent auto
  • alignment-baseline: baseline;

    La ligne de référence de l'élément est la même que celle du parent.

    SVG
    parent baseline
  • alignment-baseline: text-top; alignment-baseline: text-bottom;

    Ces deux valeurs, bien que figurant dans la spécification du W3C, sont très mal reconnues par les navigateurs.

    Aligne le texte sur une ligne correspondant à text-under et text-over.

    SVG
    parent text-top text-bottom
  • alignment-baseline: middle;

    L'alignement se fait sur le milieu des minuscules.

    SVG
    parent middle
  • alignment-baseline: central;

    L'alignement se fait sur le milieu des majuscules.

    SVG
    parent central
  • alignment-baseline: alphabetic;

    Utilise la ligne de base des caractères latin, cyrillique, grec, etc. Est équivalent à normal dans la plupart des cas.

    SVG
    parent alphabetic
  • alignment-baseline: ideographic;

    Utilise le ligne de base des caractères idéographique.

    SVG
    parent ideographic
  • alignment-baseline: mathematical;

    Utilise la ligne de base autour de laquelle les caractères mathématiques sont conçus.

    SVG
    parent mathematical
  • alignment-baseline: hanging;

    Correspond à une ligne de base suspendue à partir de laquelle les caractères en tibétain et en écritures monocamérales avec un bord supérieur fort, semblent suspendus.

    SVG
    parent hanging
  • alignment-baseline: text-before-edge; alignment-baseline: text-after-edge;

    SVG
    parent text-before-edge text-after-edge
  • alignment-baseline: initial; (baseline) alignment-baseline: inherit; alignment-baseline: revert; alignment-baseline: revertLayer; alignment-baseline: unset;

    Consultez les pages suivantes pour plus de détails : initial, inherit, revert, revert-layer, unset.

Accéder à la propriété alignment-baseline par programme.

Modifier la valeur de alignment-baseline en Javascript.

En Javascript, voici comment modifier la valeur de alignment-baseline pour un élément el. La propriété est ajoutée ou modifiée directement sur l'élément lui-même, comme avec l'attribut style du HTML. Deux syntaxes sont possibles, avec le nom de la propriété écrit en kebab-case ou en camel-case.

Javascript
let el = document.getElementById('id'); el.style['alignment-baseline'] = 'middle'; // ou let el = document.getElementById('id'); el.style.alignmentBaseline = 'middle';

Lire en Javascript la valeur de alignment-baseline.

La propriété doit avoir été affectée directement à l'élément lui-même par l'attribut style et non pas en passant par un sélecteur CSS. Ce code est donc le symétrique du précédent.

Javascript
let el = document.getElementById('id'); let value = el.style['alignment-baseline']; // ou let el = document.getElementById('id'); let value = el.style.alignmentBaseline;

Lire la valeur calculée de alignment-baseline en Javascript.

La valeur calculée est celle qui résulte du mécanisme d'héritage en cascade. Ce sera soit la valeur appliquée à l'élément via un sélecteur, soit une valeur héritée, soit encore la valeur initiale de la propriété.

Javascript
let el = document.getElementById('id'); let value = window.getComputedStyle(el).getPropertyValue('alignment-baseline');

Modifier ou relire la valeur de la propriété alignment-baseline avec JQuery.

Dans ces deux exemples de code, le nom de la propriété peut être écrit indifféremment en camel-case ou en kebab-case.

JQuery
let value = $('#id').css('alignment-baseline');
JQuery
let value = $('#id').css('alignment-baseline');

Testez vous-même.

Les boutons ci-dessous appliquent une valeur à la propriété alignment-baseline et affichent ensuite soit la valeur telle qu'elle a été appliquée, soit la valeur calculée. Dans le cas de alignment-baseline ces deux valeurs seront identiques (sauf si votre navigateur ne reconnaît pas la propriété).

Exemple interactif avec la propriété alignment-baseline.

alignment-baseline :
HTML
Texte du parent Texte de l'élément enfant
SVG
Texte en SVG

Compatibilité des navigateurs avec alignment-baseline.

La propriété alignment-baseline est encore mal prise en charge par les navigateurs (2025) en particulier par Firefox  .

Colonne 1
Support de la propriété alignment-baseline.
Colonne 2
Support de la propriété dominant-baseline.
1
Propriété
alignment-baseline
2
Propriété
dominant-baseline
Estimation de la prise en charge globale.
93%
95%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

Baidu Browser

QQ Browser

Opéra Mobile

Firefox

Chrome

Safari

Edge

Opéra

Chrome pour Androïd

Safari sur IOS

Samsung Internet

UC Browser pour Androïd

Androïd Brower

Firefox pour Androïd

KaiOS Browser

Opéra mini

Histoire de la propriété alignment-baseline.

Voir aussi, dans le même module de standardisation que alignment-baseline.

Propriétés :

baseline-shift
baseline-source
Définit si l'alignment vertical d'un élément doit se faire par rapport à sa premère ou sa dernière ligne de texte.
dominant-baseline
Définit la ligne de base utilisée pour les alignements verticaux de textes.
initial-letter
Définit les paramètres des lettrines.
initial-letter-wrap
Définit comment le texte doit contourner les lettrines.
line-height
Définit la hauteur des lignes de texte.
text-box
Permet l'effacement des espacements situés avant et/ou après les lignes de texte.
text-box-edge
Définit le métrique des textes CJK.
text-box-trim
Spécifie comment la réduction des dimensions d'une boîte de texte doit se faire pour se conformer à text-box-edge (langages CJK).
vertical-align
Alignement vertical.