CKTIS / CSS
text-indent — avanço do texto
text-indent define o avanço da primeira linha de texto formatada. Não desloca o bloco inteiro como uma margem nem acrescenta espaço a todas as linhas como o padding.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
text-indent: <length-percentage> && hanging? && each-line?;text-indent aplica-se a contentores de bloco e, normalmente, avança apenas a primeira linha formatada. O avanço é aplicado na extremidade inicial lógica da linha (inline-start). A extremidade física correspondente depende da direção da linha no eixo em linha e do modo de escrita, não da direção de um segmento de texto específico. Por exemplo, num parágrafo horizontal com direção da direita para a esquerda, o avanço é feito a partir da direita, mesmo que o texto esteja em inglês. O valor inicial é 0; a propriedade é herdada.
Indique um comprimento, como 2em, ou uma percentagem do tamanho interno do contentor no eixo em linha. São permitidos valores negativos, que podem fazer com que o texto ultrapasse o bloco. A sintaxe exige um comprimento ou uma percentagem; as palavras-chave opcionais podem surgir em qualquer ordem.
each-line inclui a primeira linha e as linhas após quebras forçadas, mas não as linhas criadas por quebra automática. hanging inverte a seleção das linhas. Em conjunto, avançam as continuações resultantes de quebras automáticas, deixando sem avanço a primeira linha e as linhas após quebras forçadas. Uma definição na especificação não comprova o suporte no navegador de destino.
O exemplo utiliza apenas 32px: o deslocamento esperado de Alpha é de 32px e o de Beta é de 0px. Uma quebra forçada normalmente não inicia outro avanço. O exemplo requer verificação local.
Exemplos
<!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.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.