Наши волонтёры ещё не перевели данную статью на Русский. Присоединяйтесь к нам и помогите сделать эту работу!
Вы можете также прочитать эту статью на English (US).
The HTMLElement.dir
property gets or sets the text writing directionality of the content of the current element.
The text writing directionality of an element is which direction that text goes (for support of different language systems). Arabic languages and Hebrew are typical languages using the RTL directionality.
An image can have its dir
property set to "rtl"
in which case the HTML attributes title
and alt
will be formatted and defined as "rtl"
.
When a table has its dir
set to "rtl"
, the column order is arranged from right to left.
When an element has its dir set to "auto"
, the direction of the element is determined based on its first strong directionality character, or default to the directionality of its parent element.
Syntax
var currentWritingDirection = elementNodeReference.dir; elementNodeReference.dir = newWritingDirection;
currentWritingDirection
is a string variable representing the text writing direction of the current element.newWritingDirection
is a string variable representing the text writing direction value.
Possible values for dir
are ltr
, for left-to-right, rtl
, for right-to-left, and auto
for specifying that the direction of the element must be determined based on the contents of the element.
Example
var parg = document.getElementById("para1"); parg.dir = "rtl"; // change the text direction on a paragraph identified as "para1"
Specification
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'dir' in that specification. |
Living Standard | No change from Document Object Model (DOM) Level 2 HTML Specification. |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'dir' in that specification. |
Obsolete | No change from Document Object Model (DOM) Level 1 Specification. |
Document Object Model (DOM) Level 1 Specification The definition of 'dir' in that specification. |
Obsolete | Initial definition. |
Browser compatibility
Desktop | Mobile | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Basic support | Chrome ? | Edge Full support Yes | Firefox Full support 1 | IE ? | Opera ? | Safari ? | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
See also
document.dir
- HTML
<dir>
element and the HTML dir global attribute. - CSS
direction
property - CSS
:dir
pseudo-class