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

CKTIS / HTML

type — significado dependente do elemento em HTML

O atributo type não é um atributo global. Consoante o elemento, seleciona o tipo de controlo, o comportamento de um botão, a numeração de uma lista ou o modo de processamento de um script, ou descreve o tipo MIME de um recurso. Os valores válidos e predefinidos dependem do elemento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

type="value"

type usa a sintaxe type="value", mas não tem um significado único em todo o HTML. Não é um atributo global: o seu valor deve ser interpretado consoante o elemento que o contém. Uma palavra-chave como number não é o mesmo que um tipo MIME como image/webp.

Em input, seleciona o tipo de controlo, por exemplo text, number, email ou checkbox, e afeta o tratamento dos valores, a validação e as APIs disponíveis. Se o valor estiver em falta ou for inválido, corresponde ao estado Text. Em button, submit, reset e button determinam a ação. Se o valor estiver em falta ou for inválido, é selecionado o estado Auto: o botão é um botão de submissão se não estiver presente nem command nem commandfor e o elemento pai não for select. O estado submit também o torna um botão de submissão. Usa explicitamente type="button" para botões tratados apenas por scripts.

Em ol, 1, a, A, i e I selecionam, respetivamente, a numeração decimal, letras minúsculas ou maiúsculas e algarismos romanos minúsculos ou maiúsculos; o valor predefinido é 1. Em script, a ausência de type ou um valor vazio significa JavaScript clássico. module seleciona um módulo JavaScript, importmap um mapa de importações e speculationrules regras de carregamento especulativo. Também é selecionado um script clássico quando o valor completo de type coincide com um tipo MIME de JavaScript reconhecido sem os parâmetros (a sua essência), sem distinguir maiúsculas de minúsculas ASCII. Por exemplo, text/javascript satisfaz esta condição, mas text/javascript; charset=utf-8 não, pelo que o script não é executado com este último valor. Um tipo MIME válido que não seja de JavaScript, como application/json, indica um bloco de dados, não JavaScript executável.

Em source, embed e object, o valor é um tipo MIME válido para o recurso. source ajuda o navegador a selecionar uma origem suportada. Em embed, a declaração tem de corresponder aos metadados Content-Type explícitos do recurso quando também é fornecido src. Em object, um tipo declarado não suportado pode levar à utilização do conteúdo alternativo sem obter o recurso.

Em a e area, o tipo MIME é apenas indicativo e não determina o tipo do recurso obtido. Em link, também é uma indicação; para recursos externos, pode impedir a obtenção de um formato não suportado. Não consideres type uma forma universal de substituir o cabeçalho HTTP Content-Type.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>type example</title>
<form>
  <label>Quantity <input id="quantity" type="number" value="2" min="1"></label>
  <button id="check" type="button">Check</button>
</form>
<pre id="result"></pre>
<script>
  const quantity = document.getElementById('quantity');
  const check = document.getElementById('check');
  const result = document.getElementById('result');
  check.addEventListener('click', () => {
    result.textContent = quantity.type + ': ' + quantity.valueAsNumber;
  });
</script>
</html>

Resultado

number: 2

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.

Fontes