element.dir

« Référence du DOM

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 de caractères représentant la direction d'écriture du texte pour l'élément courant. NouvelleDirection est une variable chaîne de caractères 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.

Gecko 7.0 note
(Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)

Avant Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), il était possible que la valeur renvoyée ne soit pas toujours en minuscule. A partir de Gecko 7.0, la valeur renvoyée est toujours en minuscule, comme défini dans la spécification.

Spécification

Spécification Statut Commentaire
Document Object Model (DOM) Level 2 HTML Specification traduction (non normative) Recommendation  

 

Étiquettes et contributeurs liés au document

Contributeurs ayant participé à cette page : BenoitL, dextra, tregagnon
Dernière mise à jour par : tregagnon,