Tovább a tartalomhoz

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.

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.

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.

  1. Nyisd meg a rácsot: WP Grid Builder → Összes rács, majd a rács szerkesztőjét.
  2. Válaszd a Haladó fület.
  3. Az Egyéni JavaScript szakaszban írd a kódot az Add meg a JS-kódodat: feliratú mezőbe.
  4. 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.

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 );
} );
} );

Készült:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások