CSS - :dir()

Example

<div dir="rtl">
  <span>test1</span>
  <div dir="ltr">test2
    <div dir="auto">עִבְרִית</div>
  </div>
</div>

Syntax  

:dir( ltr <a href="css/value_definition_syntax#single_bar" title="Single bar">|</a> rtl ) { <var>style properties</var> }

Description  

The :dir CSS pseudo-class matches elements based on the directionality of the text contained in it. In HTML, the direction is determined by the dir attribute. For other document types there may be other document methods for determining the language.

Note that the usage of the pseudo-class :dir() is not equivalent of using the [dir=…] attribute selectors. The latter matches a value of the dir and doesn't match when no attribute is set, even if in that case the element inherits the value of its parent; similarly [dir=rtl] or [dir=ltr] won't match the auto value that can be used on the dir attribute. In the opposite, :dir() will match the value calculated by the UA, being inherited or the auto value.

Also :dir() considers only the semantic value of the directionality, the one defined in the document, most of the time in HTML. It won't consider styling directionality, the one set by CSS properties like direction which are purely stylistic.

Browser Compatibility  

[1]: Microsoft Edge feature request on UserVoice

[2]: WebKit bug #64861

[3]: Chrome issue #576815

See Also  

• Language-related pseudo-classes: :lang, :dir

Specifications  

License