Metoden toggle
Metoden toggle veksler mellem jævn visning/skjuling
af elementer. Hvis et element vises, vil det blive skjult
og omvendt.
Syntaks
Visning over en given varighed i millisekunder,
400ms som standard:
.toggle(varighed);
Tid kan angives ikke kun i millisekunder,
men også med nøgleordene slow (600ms)
og fast (200ms), jo højere værdi,
jo langsommere animation:
.toggle('slow' eller 'fast');
Man kan med parameteren display overføre værdien
true eller false. Hvis true, vil elementet
kun blive vist, false - skjules:
.toggle(display);
Hvis parametre ikke angives - vil der ikke være animation, elementer vil blive vist/skjult med det samme:
.toggle();
Man kan også som anden parameter overføre en funktion for easing, og som tredje parameter en callback-funktion - udføres efter animationen er fuldført. Begge parametre er valgfrie:
.toggle(varighed, [easing-funktion], [callback-funktion]);
Man kan blot som anden valgfri parameter overføre en callback-funktion - udføres efter animationen er fuldført:
.toggle(varighed, [callback-funktion]);
Man kan overføre metoden forskellige indstillinger, i form af et JavaScript objekt, der indeholder par nøgle: værdi:
.toggle(indstillinger);
Sådan et objekt kan overføre følgende
parametre og funktioner - duration, easing,
queue, specialEasing, step,
progress, complete, start,
done, fail, always. Beskrivelse
af disse parametre kan du se for metoden
animate. For eksempel,
lad os indstille varighed og easing-funktion:
.toggle( {duration: 800, easing: easeInSine} );
Eksempel
Lad os efter et klik på en knap, jævnt vise
et skjult afsnit med metoden toggle. Ved at overføre
nøgleordet slow, indstiller vi hastigheden
til 600ms. Ved gentaget klik - skjule:
<button>vis tekst</button>
<p style="display: none">tekst</p>
$('button').click(function() {
$('p').toggle('slow');
});
Se også
-
metoden
fadeToggle,
som ændrer elementers gennemsigtighed -
metoden
slideToggle,
som veksler mellem jævn visning/skjuling af elementer -
metoden
show,
som jævnt viser elementer -
metoden
hide,
som jævnt skjuler elementer