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?
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?
É 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:
e.preventDefault();
(exemplo)e.type
e.target
etc...
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.
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
:
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
.