Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

:dir() — pseudoclase de direccionalidad

La pseudoclase :dir() selecciona elementos según la direccionalidad establecida por las reglas HTML, no por la propiedad CSS direction. Distingue ltr de rtl y tiene en cuenta la herencia y dir="auto".

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

:dir(ltr)
:dir(rtl)

:dir() coincide con un elemento según su direccionalidad semántica. :dir(ltr) indica una dirección de izquierda a derecha, mientras que :dir(rtl) indica una de derecha a izquierda. En HTML, la direccionalidad sigue las reglas del documento, incluidos el atributo dir, la herencia y la detección automática de la dirección.

El selector [dir="rtl"] solo comprueba el atributo del propio elemento. En cambio, :dir(rtl) también puede coincidir con un descendiente que no tenga ese atributo. Con dir="auto", el elemento coincide con :dir(ltr) o :dir(rtl) según la direccionalidad determinada; :dir(auto) no selecciona esos elementos.

El argumento debe ser un único identificador, no una cadena ni una lista. Se permiten espacios en blanco a su alrededor. En HTML, el argumento se compara con las palabras clave ltr y rtl sin distinguir entre mayúsculas y minúsculas ASCII. Por tanto, :dir(RTL) selecciona los mismos elementos que :dir(rtl). Los identificadores que no coinciden con ninguna de las dos palabras clave en esa comparación son sintácticamente válidos, pero no seleccionan ningún elemento. :dir() vacío no es válido.

La propiedad CSS direction no afecta a la coincidencia. El ejemplo distingue entre herencia, dir="auto" y estilos: styled sigue coincidiendo con :dir(ltr) a pesar de direction: rtl.

Ejemplos

<!doctype html>
<html lang="en" dir="ltr">
<meta charset="utf-8">
<title>:dir() example</title>
<style>
  .sample:dir(ltr) { border-left: 4px solid blue; }
  .sample:dir(rtl) { border-right: 4px solid green; }
</style>
<div dir="rtl">
  <p id="inherited" class="sample">Hello</p>
</div>
<p id="automatic" class="sample" dir="auto">שלום</p>
<p id="styled" class="sample" dir="ltr" style="direction: rtl">Hello</p>
<pre id="result"></pre>
<script>
  const lines = Array.from(document.querySelectorAll('.sample'), element =>
    `${element.id}: ${element.matches(':dir(rtl)') ? 'rtl' : 'ltr'}`
  );
  lines.push(`explicit rtl: ${document.querySelectorAll('.sample[dir="rtl"]').length}`);
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Resultado

inherited: rtl
automatic: rtl
styled: ltr
explicit rtl: 0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes