102 of 119 menu

Método submit

O método submit nos permite trabalhar com o evento JavaScript submit. Ele nos permite vincular um manipulador ao evento JavaScript submit ou acionar esse evento em um elemento.

Sintaxe

Podemos passar ao método uma função de manipulador, que será executada sempre que o evento ocorrer, e na qual pode ser passado o objeto de evento:

.submit(função-manipuladora);

Neste caso, o método funcionará de forma análoga à construção .on('submit', handler) do método on.

Também podemos passar opcionalmente ao método um objeto com dados, que serão passados para a função de manipulador:

.submit([dados do evento], função-manipuladora);

Ou podemos não passar nenhum parâmetro, então o método funcionará de forma análoga a .trigger('submit') do método trigger:

.submit();

O evento submit ocorre em um elemento quando o usuário, por exemplo, clica em um botão 'submit' em um formulário. Este evento pode ser anexado apenas a elementos da tag form. O evento submit ocorre em um elemento quando o usuário, por exemplo, clica em um botão 'submit' em um formulário. Este evento pode ser anexado apenas a elementos da tag form.

Exemplo

No exemplo a seguir, temos um formulário simples, ao qual vincularemos um manipulador de eventos usando o método submit, com um campo de texto e um botão - um input do tipo submit. Vamos digitar texto no campo de texto e, ao clicar no botão, verificar esse texto. Se digitarmos 'jQuery', então no span mostraremos o texto 'Good!', usando os métodos text e show, e se for algo diferente, então - 'Bad...':

<p>jQuery</p> <form action="/"> <div> <input type="text"> <input type="submit"> </div> </form> <span></span> $('form').submit(function(event) { event.preventDefault(); if ($('input').first().val() === 'jQuery') { $('span').text('Good!').show(); return; } $('span').text('Bad...').show(); });

Veja também

  • método trigger,
    que permite acionar todos os manipuladores de eventos vinculados ao elemento para eventos de um tipo especificado
  • método on,
    que permite vincular um manipulador de eventos a um elemento
azbydeenesfrkakkptruuz