Metoden toggle

Metoden toggle veksler mellom jevn visning og skjuling av elementer. Hvis elementet er synlig, vil det bli skjult og omvendt.

Syntaks

Visning over en gitt varighet i millisekunder, 400ms som standard:

.toggle(varighet);

Tiden kan angis ikke bare i millisekunder, men også med nøkkelordene slow (600ms) og fast (200ms), jo høyere verdi, desto saktere animasjon:

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

Man kan med parameteren display sende verdi true eller false. Hvis true, vil elementet bare vises, false - skjules:

.toggle(display);

Hvis ingen parametere angis - vil det ikke være noen animasjon, elementer vil vises/skjules øyeblikkelig:

.toggle();

Man kan også som andre parameter sende en easing-funksjon, og som tredje parameter en callback-funksjon - som utløses etter animasjonen er fullført. Begge parameterne er valgfrie:

.toggle(varighet, [easing-funksjon], [callback-funksjon]);

Man kan ganske enkelt som andre valgfrie parameter sende en callback-funksjon - som utløses etter animasjonen er fullført:

.toggle(varighet, [callback-funksjon]);

Man kan sende metoden ulike alternativer, i form av et JavaScript-objekt som inneholder par med nøkkel: verdi:

.toggle(alternativer);

Et slikt objekt kan sende følgende parametere og funksjoner - duration, easing, queue, specialEasing, step, progress, complete, start, done, fail, always. Beskrivelse av disse parameterne kan du se for metoden animate. For eksempel, la oss sette varighet og easing-funksjon:

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

Eksempel

La oss etter å ha trykket på knappen, jevnt vise et skjult avsnitt ved hjelp av metoden toggle. Ved å sende nøkkelordet slow, setter vi hastigheten til 600ms. Ved å trykke på nytt - skjule:

<button>vis tekst</button>
<p style="display: none">tekst</p>

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

Se også

metoden fadeToggle,
som endrer gjennomsiktigheten til elementer
metoden slideToggle,
som veksler mellom jevn visning/skjuling av elementer
metoden show,
som jevnt viser elementer
metoden hide,
som jevnt skjuler elementer