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

CKTIS / CSS

text-indent — sangría de texto

text-indent establece la sangría de la primera línea de texto formateada. No desplaza todo el bloque como un margen ni añade espacio a todas las líneas como el padding.

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

Sintaxis

text-indent: <length-percentage> && hanging? && each-line?;

text-indent se aplica a los contenedores de bloque y normalmente sangra solo la primera línea formateada. La sangría se aplica en el borde inicial lógico de la línea (inline-start). El borde físico correspondiente depende de la dirección de la línea en el eje en línea y del modo de escritura, no de la dirección de un fragmento de texto concreto. Por ejemplo, en un párrafo horizontal con dirección de derecha a izquierda, la sangría queda a la derecha aunque el texto esté en inglés. Su valor inicial es 0; la propiedad se hereda.

Indica una longitud, como 2em, o un porcentaje del tamaño interior del contenedor en el eje en línea. Se permiten valores negativos, que pueden hacer que el texto sobresalga del bloque. La sintaxis requiere una longitud o un porcentaje; las palabras clave opcionales pueden aparecer en cualquier orden.

each-line incluye la primera línea y las líneas posteriores a saltos forzados, pero no las que siguen a un ajuste automático de línea. hanging invierte la selección de líneas. Juntas, estas opciones sangran las continuaciones ajustadas automáticamente, y dejan sin sangría la primera línea y las líneas posteriores a saltos forzados. Una definición en la especificación no demuestra que el navegador de destino admita la función.

El ejemplo usa únicamente 32px: el desplazamiento esperado de Alpha es de 32px y el de Beta, de 0px. Un salto forzado normalmente no inicia otra sangría. El ejemplo requiere una verificación local.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>text-indent</title>
<style>
  p {
    margin: 0;
    padding: 0;
    border: 1px solid;
    width: 320px;
    font: 16px/24px monospace;
    direction: ltr;
    text-align: start;
    text-indent: 32px;
  }
</style>
<p><span id="first">Alpha</span><br><span id="second">Beta</span></p>

Resultado

Alpha: 32px inline-start offset; Beta: 0px inline-start offset, measured from the paragraph content edge.

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