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

CKTIS / HTML

accept — indicação para selecionar ficheiros

`accept` indica ao seletor os formatos esperados por `input type="file"`; não constitui uma proteção de segurança do carregamento.

Versão: HTML Living Standard

Sintaxe

<input type="file" accept=".png,image/png" required>

Fornece extensões iniciadas por ponto, tipos MIME sem parâmetros ou image/*, audio/*, video/*, separados por vírgulas. Para um formato, combina extensão e MIME, como .png,image/png. Os tokens devem ser distintos numa comparação sem distinguir maiúsculas ASCII.

Isto orienta a interface, sem analisar o conteúdo. O nome ou MIME declarado pode estar errado e o cliente pode enviar outro ficheiro. O servidor continua a ter de verificar formato, tamanho e armazenamento. multiple regula separadamente a quantidade; required exige uma seleção.

O exemplo atribui um ficheiro de texto em memória apesar de esperar PNG. O campo obrigatório vazio é inválido, mas depois checkValidity() devolve true: accept não cria um erro de validade do tipo do ficheiro.

Exemplos

<!doctype html><meta charset="utf-8">
<label>Picture <input id="file" type="file" accept=".png,image/png" required></label>
<output id="result"></output>
<script>
const input = document.querySelector('#file');
const emptyValid = input.checkValidity();
const files = new DataTransfer();
files.items.add(new File(['not an image'], 'notes.txt', { type: 'text/plain' }));
input.files = files.files;
document.querySelector('#result').textContent =
  'empty=' + emptyValid + '; selected=' + input.files[0].name +
  '; valid=' + input.checkValidity();
</script>

Resultado

empty=false; selected=notes.txt; valid=true

O ficheiro existe apenas em memória. Testa-se o limite da validação, não o seletor nativo nem a segurança do servidor.

Fontes