# 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

| 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

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.

```js
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

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:

```php
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:

```js
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

- [Lightbox- és szűrőesemények](https://hub.hellowp.io/hu/plugins/wp-grid-builder-learndash/js-esemenyek-lightbox-szuro/)
