Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

cols: sugerir a largura em carateres de uma área de texto

Controla a largura de apresentação predefinida sem estabelecer um limite de comprimento do texto.

Versão: HTML Living Standard

Sintaxe

<textarea cols="30"></textarea>

O atributo cols indica o número esperado de carateres por linha numa área de texto. Aceita um inteiro positivo; se estiver ausente ou for inválido, a largura em carateres é 20 por predefinição. Os navegadores podem usá-lo para dimensionar o controlo, mas a largura real em píxeis depende dos tipos de letra, contornos e estilos. Não garante que cada linha tenha exatamente esse número de carateres visíveis.

A largura CSS pode substituir a dimensão de apresentação, e este atributo não limita o comprimento total do texto. Isso é tratado separadamente por maxlength e pela validação da aplicação. Com wrap="hard", o número de colunas é obrigatório e o envio pode incluir quebras de linha inseridas pelo navegador; a mudança visual de linha suave predefinida não insere essas quebras só porque a linha muda no ecrã.

O exemplo compara dois controlos com o mesmo tipo de letra e diferentes números de colunas. Guarda quarenta carateres no campo mais estreito e depois atribui a ambos a mesma largura CSS. A medição confirma a diferença inicial, a ausência de truncagem do valor atribuído e a igualdade após a substituição explícita do estilo.

Exemplos

<!doctype html><meta charset="utf-8">
<style>textarea { font: 16px monospace; box-sizing: border-box; }</style>
<label>Narrow <textarea id="narrow" cols="10"></textarea></label>
<label>Wide <textarea id="wide" cols="30"></textarea></label><output id="result"></output>
<script>
const narrow = document.querySelector('#narrow'), wide = document.querySelector('#wide');
narrow.value = 'x'.repeat(40);
const wider = wide.getBoundingClientRect().width > narrow.getBoundingClientRect().width;
narrow.style.width = wide.style.width = '100px';
document.querySelector('#result').textContent = 'wider=' + wider + '; valueLength=' + narrow.value.length + '; equalAfterCSS=' + (wide.getBoundingClientRect().width === narrow.getBoundingClientRect().width);
</script>

Resultado

wider=true; valueLength=40; equalAfterCSS=true

O teste compara dimensões, em vez de afirmar uma proporção fixa de píxeis por caráter em todos os sistemas.

Fontes