JavaScript-események: bevezetés
Hogyan figyelheted a bővítmény JavaScript-eseményeit a rács beállításaiban vagy saját szkriptben.
A bővítmény JavaScript-eseményt küld, valahányszor valami megváltozik. Ezt kiválthatja a látogató egy művelete, vagy egy programból indított módosítás. Az események meghatározott sorrendben követik egymást.
Az eseményeket a rács beállításaiban vagy saját szkriptben figyelheted.
Az eseményfigyelők három típusa
Szekció neve “Az eseményfigyelők három típusa”| Metódus | Mit csinál |
|---|---|
.on |
Az esemény minden előfordulásakor lefut. |
.once |
Az esemény csak első előfordulásakor fut le. |
.off |
Leválaszt, vagyis eltávolít egy eseményfigyelőt. |
Események a rács beállításaiban
Szekció neve “Események a rács beállításaiban”A fejezetekben szereplő példák mind beírhatók a rács beállításai közé, és csak az adott rács eseményeire fognak lefutni. A wpgb változó a bővítmény főpéldánya, amely az adott rács összes alpéldányát tartalmazza.
- Nyisd meg a rácsot: WP Grid Builder → Összes rács, majd a rács szerkesztőjét.
- Válaszd a Haladó fület.
- Az Egyéni JavaScript szakaszban írd a kódot az Add meg a JS-kódodat: feliratú mezőbe.
- Mentsd a rácsot.
console.dir( wpgb );
wpgb.instanceName.on( 'eventName', function( args ) {
console.log( 'eventName', args );
} );Az instanceName a példány neve (grid, lightbox, facets), az eventName az esemény neve, az args pedig az esemény argumentumai.
Események külső szkriptben
Szekció neve “Események külső szkriptben”Saját .js fájlból való figyeléshez előbb regisztrálnod kell a szkriptet a wp_grid_builder/frontend/register_scripts PHP-szűrővel. Tedd például a téma functions.php fájljába:
function prefix_register_script( $scripts ) {
$scripts[] = [ 'handle' => 'my-script', 'source' => 'my-url/script.js', 'version' => '1.0.0', ];
return $scripts;
}
add_filter( 'wp_grid_builder/frontend/register_scripts', 'prefix_register_script' );Egy oldalon több rács és hozzájuk tartozó szűrő is lehet, ezért minden rács, sablon vagy tartalom inicializálását meg kell várnod. Erre a window objektum WP_Grid_Builder tulajdonságában lévő globális eseménykezelő szolgál. Az init eseményre feliratkozva megkapod az adott rács wpgb példányát:
window.WP_Grid_Builder && WP_Grid_Builder.on( 'init', function( wpgb ) {
console.dir( wpgb );
wpgb.instanceName.on( 'eventName', function( args ) {
console.log( 'eventName', args );
} );
} );Az elérhető események
Szekció neve “Az elérhető események”Készült: