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.