Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
O método Event.initEvent()
é usado para inicializar o valor de um event
criado usando Document.createEvent()
.
Eventos inicializados desta maneira precisam ter sido criados com o método Document.createEvent()
. Este método precisar ser chamado para definir o evento antes de ser despachado, usando EventTarget.dispatchEvent()
. Uma vez despachado, não faz mais nada.
Não use esse método mais, pois está depreciado.
Ao invés, use construtores de eventos específicos, como Event()
. A página sobre Criando e disparando eventos detalha mais informações sobre o uso desses eventos.
Syntax
event.initEvent(tipo, bubbles, cancelable);
tipo
- É um
DOMString
definido o tipo do evento. bolhas
- É um
Boolean
decidindo se o evento precisa ser enviado para cima, na cadeia de eventos ou não. Uma vez definido, a propriedade read-onlyEvent.bubbles
irá informar o seu valor. cancelable
- É um
Boolean
definindo se o evento pode ser cancelado. Uma vez definido, a propriedade read-onlyEvent.cancelable
will irá informar o seu valor.
Exemplo
// Cria o evento. var event = document.createEvent('Event');
// Cria um evento de clique que borbulha e // não pode ser canceladoevent.initEvent('click', true, false); // Escuta este evento. elem.addEventListener('click', function (e) { // e.target matches elem }, false); elem.dispatchEvent(event);
Especificações
Especificação | Estado | Comentário |
---|---|---|
DOM The definition of 'Event.initEvent()' in that specification. |
Padrão em tempo real | From Document Object Model (DOM) Level 2 Events Specification, deprecated it, superseded by event constructors. |
Document Object Model (DOM) Level 2 Events Specification The definition of 'Event.initEvent()' in that specification. |
Obsoleto | Initial definition. |
Compatibilidade com navegadores
Feature | Firefox (Gecko) | Chrome | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes) [1] | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Firefox Mobile (Gecko) | Android | Edge | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? [1] | ? | (Yes) | ? | ? | ? |
[1] Antes do Firefox 17, uma chamada a este método depois de despachar o evento gerava uma exceção ao invés de não fazer nada.
Veja também
- O construtor para usar ao invés deste método descontinuado:
Event()
. Construtores mais específicos também podem ser usados.