Methode toggle
De methode toggle wisselt soepele weergave/verberging
van elementen af. Als een element wordt weergegeven, wordt het verborgen
en omgekeerd.
Syntaxis
Weergave gedurende een opgegeven tijd in milliseconden,
400ms standaard:
.toggle(duur);
Tijd kan niet alleen in milliseconden worden opgegeven,
maar ook met de trefwoorden slow (600ms)
en fast (200ms), hoe hoger de waarde,
hoe langzamer de animatie:
.toggle('slow' of 'fast');
Met de parameter display kan de waarde
true of false worden doorgegeven.
Als true, wordt het element
alleen weergegeven, false - verborgen:
.toggle(display);
Als geen parameters worden opgegeven - animatie zal er niet zijn, elementen worden weergegeven/verborgen onmiddellijk:
.toggle();
Je kunt ook als tweede parameter een easing-functie doorgeven, en als derde een callback-functie - wordt uitgevoerd na voltooiing van de animatie. Beide parameters zijn optioneel:
.toggle(duur, [easing-functie], [callback-functie]);
Je kunt gewoon als tweede optionele parameter een callback-functie doorgeven - wordt uitgevoerd na voltooiing van de animatie:
.toggle(duur, [callback-functie]);
Je kunt verschillende opties aan de methode doorgeven, in de vorm van een JavaScript-object, dat paren sleutel: waarde bevat:
.toggle(opties);
Zo'n object kan de volgende
parameters en functies doorgeven - duration, easing,
queue, specialEasing, step,
progress, complete, start,
done, fail, always. Beschrijving
van deze parameters kun je bekijken voor de methode
animate. Bijvoorbeeld,
laten we de duur en easing-functie instellen:
.toggle( {duration: 800, easing: easeInSine} );
Voorbeeld
Laten we na het klikken op de knop soepel weergeven
een verborgen alinea met de methode toggle. Door het
trefwoord slow door te geven, stellen we de snelheid in
op 600ms. Bij herhaald klikken - verbergen:
<button>toon tekst</button>
<p style="display: none">tekst</p>
$('button').click(function() {
$('p').toggle('slow');
});
Zie ook
-
methode
fadeToggle,
die de transparantie van elementen verandert -
methode
slideToggle,
die soepele weergave/verberging van elementen afwisselt -
methode
show,
die elementen soepel weergeeft -
methode
hide,
die elementen soepel verbergt