A toggle metódus

A toggle metódus váltakozva jelenít meg és rejt el elemeket simán. Ha egy elem látható, akkor el lesz rejtve, és fordítva.

Szintaxis

Megjelenítés megadott idő alatt milliszekundumban, alapértelmezetten 400ms:

.toggle(időtartam);

Az idő nem csak milliszekundumban adható meg, hanem kulcsszavakkal is: slow (600ms) és fast (200ms), minél nagyobb az érték, annál lassabb az animáció:

.toggle('slow' vagy 'fast');

A display paraméterrel átadható az true vagy false érték. Ha true, akkor az elem csak megjelenik, false - elrejtődik:

.toggle(display);

Ha nincs paraméter megadva - nem lesz animáció, az elemek azonnal megjelennek/elrejtőznek:

.toggle();

Második paraméterként átadható egy simasági függvény is, valamint harmadikként egy callback függvény - amely az animáció befejezése után fut le. Mindkét paraméter opcionális:

.toggle(időtartam, [simasági függvény], [callback függvény]);

Egyszerűen második, opcionális paraméterként is átadható egy callback függvény - az animáció befejezése után fut le:

.toggle(időtartam, [callback függvény]);

A metódusnak különböző opciók is átadhatók, JavaScript objektum formájában, amely kulcs: érték párokat tartalmaz:

.toggle(options);

Egy ilyen objektum a következő paramétereket és függvényeket adhatja át - duration, easing, queue, specialEasing, step, progress, complete, start, done, fail, always. Ezen paraméterek leírását a animate metódusnál találja. Például, állítsuk be az időtartamot és a simasági függvényt:

.toggle( {duration: 800, easing: easeInSine} );

Példa

Egy gomb megnyomása után jelenítsük meg simán az elrejtett bekezdést a toggle metódussal. A slow kulcsszó átadásával a sebességet 600ms-ra állítjuk. Újabb megnyomásra - rejtse el:

<button>szöveg megjelenítése</button>
<p style="display: none">szöveg</p>

$('button').click(function() {
	$('p').toggle('slow');
});

Lásd még

a fadeToggle metódus,
amely az elemek átlátszóságát változtatja
a slideToggle metódus,
amely váltakozva jelenít meg és rejt el elemeket simán
a show metódus,
amely simán megjeleníti az elemeket
a hide metódus,
amely simán elrejti az elemeket