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

CKTIS / HTML

onsubmit — gerir uma tentativa de submissão de formulário

O atributo onsubmit especifica o código JavaScript que trata o evento submit. Permite reagir a uma tentativa de submissão do formulário e cancelar a submissão predefinida; não confirma que os dados chegaram ao servidor.

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

Sintaxe

onsubmit="JavaScript statements"
form.onsubmit = function (event) { /* handler */ };

onsubmit é um atributo de tratamento do evento submit. Normalmente, é colocado no elemento form, não no botão de submissão. Embora esteja disponível em todos os elementos HTML, o formulário é o destino deste evento, que se propaga para os elementos antecessores. O valor do atributo é código JavaScript, não o endereço de destino do formulário.

O evento ocorre antes da submissão predefinida, por exemplo, depois de ativar um botão de submissão ou chamar form.requestSubmit(). Se o navegador efetuar a validação de restrições e o formulário não a passar, o evento submit não ocorre. O método form.submit() ignora tanto essa validação como o evento submit.

O código do atributo recebe o parâmetro event. Chamar event.preventDefault() ou executar return false cancela a submissão predefinida. Isto não impede a propagação do evento. Chamar apenas uma função que devolve false, sem transmitir o resultado com return, não cancela a submissão.

JavaScript também pode atribuir uma função a form.onsubmit; uma atribuição posterior substitui a função anterior dessa propriedade. O exemplo usa o atributo, cancela a submissão e altera o texto do estado. É necessário ter JavaScript ativado e uma política de segurança que permita manipuladores de eventos inline.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsubmit demo</title>
<form onsubmit="event.preventDefault(); document.getElementById('result').textContent = 'Submission canceled';">
  <button type="submit">Submit</button>
</form>
<p id="result" role="status">Ready</p>
</html>

Resultado

Submission canceled

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