13

O que seria o 'e' que é passado como parâmetro em funções? Ex.:

function nome(e) {
    (instrução);
}

Alguém tem algum material, ou palavra chave para pesquisa que eu possa recorrer para estudar um pouco mais sobre o assunto?

1

2 Respostas 2

20

É comum dar o nome de e como abreviatura de event, para passar uma referência ao objeto Event usado em funções callback de oscultador de eventos. Abrevia-se por comodidade e para poupar bytes.

O objeto Event em sí é util para por exemplo:

etc...

2
  • 1
    Valeu, Sergio! Abs. Commented 4/05/2015 às 13:27
  • 1
    Saquei,,, vlw man...
    – MagicHat
    Commented 21/10/2016 às 17:11
3

Neste caso esse 'e' se trata de um parâmetro específico em funções específicas, como por exemplo, eventos.

É muito comum no jQuery. Por exemplo, quando criamos um evento de onclick em um link:

$('#link-legal').on('click', function(e) {
    alert('Link legal clicado!');
});

Neste caso, esse parâmetro 'e' (que pode na verdade ter qualquer nome, mas é muito utilizado a letra 'e' que é abreviação de 'event') conterá o objeto do link clicado com diversas propriedades e métodos.

Exemplo de aplicação

Digamos que você quer que, ao ser clicado em um link, seja solicitado uma confirmação ao usuário e, dependendo da resposta dele o click seja 'cancelado':

$('a.confirmar').on('click', function(e) {
    var confirmado = confirm('Deseja realmente prosseguir para esse link?');
    if(confirmado == false) {
        e.preventDefault();
        alert('Click cancelado');
    }
});
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<a href="https://www.google.com" target="_blank" class="confirmar">Ir para o Google</a>

Neste exemplo utilizamos o método preventDefault que cancela a ação padrão do elemento, que no caso da tag <a> é o direcionamento para a url indicada na propriedade href.


Geralmente nas documentações você encontra esse tipo de referencia, como pode conferir na documentação oficial do jQuery para o evento click:

https://api.jquery.com/click/

Lá diz (em tradução livre):

.click( handler ) handler Tipo: Function( Event eventObject ) Uma função que será executada em cada disparo do evento.

Pode observar que no tipo ele diz que uma Function na qual é passado um parâmetro objeto do tipo Event.

1
  • 1
    Só lembrando que o objeto passado pelo jQuery não é igual ao evento nativo do JS, e sim uma versão normalizada. Ou pelo menos costumava ser assim, podem ter mudado nas versões mais recentes do jQuery.
    – bfavaretto
    Commented 30/08/2017 às 21:02

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .