Metody v EventListener

Metody umístěné ve jmenném prostoru EventListener.


Metoda add

Přidá posluchače události.

typ: method; celé jméno: COMEX.HTML.EventListener.add;


Parametry:

$function

● hodnota typu Function

handler volané funkce

$id

● hodnota typu String (výchozí: undefined)

id, pod kterým bude posluchač zaregistrovaný

$priority

● hodnota typu Integer (výchozí: undefined)

priorita spouštění handlerů


Vrací:

bez návratové hodnoty

example
var $rslt = document.on("contextmenu");
$rslt.suppress();
$rslt.add(function(){alert('event alert 01')}, 'alert01');
$rslt.add(function(){alert('event alert 02')}, 'alert02');

( umístěno v souboru /comex/scripts/comex.js )


Metoda enabled

Vrátí příznak, zda je posluchač události aktivní a pokud je předána hodnota, nastaví příznak na tuto hodnotu.

typ: method; celé jméno: COMEX.HTML.EventListener.enabled;


Parametry:

$enable

● hodnota typu Boolean (výchozí: undefined)

true, pokud má být posluchač události aktivní, jinak false


Vrací:

true, pokud je posluchač události aktivní, jinak false

example
var $e = document.on("contextmenu", function(){alert('event alert 01')});
$e.suppress();
$e.enabled(false);
var $rslt = "<button onclick=\"document.on('contextmenu').enabled(true)\">click to enable</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda fire

Spustí událost.

typ: method; celé jméno: COMEX.HTML.EventListener.fire;


Parametry:

$event

● hodnota typu Event (výchozí: undefined)

objekt události

$forced

● hodnota typu boolean (výchozí: false)

true, pokud má být událost vyvolána i na neaktivním elementu, jinak false


Vrací:

bez návratové hodnoty

example
var $e = document.on("contextmenu", function(){alert('event alert 01')});
var $rslt = "<button onclick=\"document.on('contextmenu').fire()\">click to fire</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda get

Vrátí posluchače události.

typ: method; celé jméno: COMEX.HTML.EventListener.get;


Parametry:

$id

● hodnota typu String

id, pod kterým je posluchač zaregistrovaný


Vrací:

handler volané funkce

( umístěno v souboru /comex/scripts/comex.js )


Metoda prevent

Zamezí provedení defaultní akce události.

typ: method; celé jméno: COMEX.HTML.EventListener.prevent;


Vrací:

bez návratové hodnoty

example
var $e = document.on("contextmenu", function(){alert('event alert 01')});
$e.prevent();
var $rslt = "<button onclick=\"document.on('contextmenu').fire()\">click to test</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda rem

Odebere posluchače události.

typ: method; celé jméno: COMEX.HTML.EventListener.rem;


Parametry:

$id

● hodnota typu String (výchozí: undefined)

id, pod kterým má být posluchač zaregistrovaný (nedefinované id znamená vymazání všech posluchačů)


Vrací:

bez návratové hodnoty

example
var $rslt = document.on("contextmenu");
$rslt.suppress();
$rslt.add(function(){ alert('event alert 01'); document.on('contextmenu').rem('alert01'); }, 'alert01');

( umístěno v souboru /comex/scripts/comex.js )


Metoda stop

Zamezí předání události nadřazenému elementu.

typ: method; celé jméno: COMEX.HTML.EventListener.stop;


Vrací:

bez návratové hodnoty

example
var $e = document.on("contextmenu", function(){alert('event alert 01')});
$e.stop();
var $rslt = "<button onclick=\"document.on('contextmenu').fire()\">click to test</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda suppress

Zamezí předání události nadřazenému elementu a provedení defaultní akce události.

typ: method; celé jméno: COMEX.HTML.EventListener.suppress;


Vrací:

bez návratové hodnoty

example
var $e = document.on("contextmenu", function(){alert('event alert 01')});
$e.suppress();
var $rslt = "<button onclick=\"document.on('contextmenu').fire()\">click to test</button>";

( umístěno v souboru /comex/scripts/comex.js )