element.dir

Résumé

L'attribut dir obtient ou définit la direction d'écriture du texte pour le contenu de l'élément courant.

Syntaxe et valeurs

var DirectionActuelle = referenceElement.dir;
referenceElement.dir = NouvelleDirection;

DirectionActuelle est une variable chaîne représentant la direction d'écriture du texte pour l'élément courant. NouvelleDirection est une variable chaîne représentant la nouvelle direction d'écriture du texte souhaitée pour l'élément.

Les valeurs possibles pour dir sont ltr, pour de gauche à droite (left-to-right), et rtl, pour de droite à gauche (right-to-left).

Exemple

var para = document.getElementById("para1"); 
para.dir = "rtl"; 
// change la direction du texte sur un paragraphe identifié par "para1"

Notes

La direction d'écriture du texte sur un élément est celle dans laquelle le texte est disposé (pour permettre le support de systèmes multilingues). Les langues arabes et l'hébreu sont des exemples typiques de langues qui utiliseront la direction « rtl » (de droite à gauche).

Une image peut avoir sont attribut dir positionné à « rtl », auquel cas les attributs title et alt seront formatés et définis comme allant de droite à gauche.

Lorsqu'un tableau a sa direction définie comme « rtl », l'ordre des colonnes va de droite à gauche.

Spécification

• W3C DOM Level 2 HTML: dir — traduction (non normative)