Elementele vor fi afișate sau ascunse imediat, fără animație, prin schimbarea proprietății CSS a ecranului. Dacă elementul a fost afișat inițial, acesta va fi ascuns, altfel acesta va fi afișat. Proprietatea de afișare este păstrată sau restaurată după cum este necesar. Dacă elementul are valoarea proprietății afișate este în linie. atunci după ascunderea și afișarea valorii acestei proprietăți va fi setată din nou în linie.
Atunci când unul dintre următoarele argumente este trecut la metoda (durata, obiectul cu opțiuni sau funcția completă), metodele .toggle () sunt executate cu animație. Metoda .toggle () animă în același timp lățimea, înălțimea și transparența. Când aceste proprietăți ating 0 după terminarea animației, valoarea proprietății stilului de afișare nu va fi setată la niciuna pentru a vă asigura că elementul nu afectează aspectul paginii.
Durata este specificată în milisecunde. Valorile mai mari înseamnă animație mai lentă, nu mai rapidă. Valoarea implicită este de 400 milisecunde. Liniile "rapide" și "lent" pot fi folosite pentru a specifica o durată de 200 și, respectiv, 600 de milisecunde.
Începând cu jQuery versiunea 1.4.3, poate fi folosit un șir suplimentar care conține numele funcției de relaxare. Funcția de relaxare determină viteza cu care progresează animația în diverse puncte ale animației. În funcția jQuery de bază există două astfel de funcții: leagăn. utilizat în mod implicit și liniar cu schimbare uniformă a animației. Mai multe funcții de relaxare sunt disponibile atunci când se utilizează pluginuri, în primul rând suita jQuery UI.
Funcția de apel invers, dacă este specificată, va fi apelată o dată după terminarea animației. Acest lucru poate fi folosit pentru a construi o secvență specifică de animație. Această funcție nu are argumente, dar se referă la un element DOM animat. Dacă sunt animate simultan mai multe elemente, este important să înțelegeți că funcția de apel invers va fi executată o dată pentru fiecare dintre aceste elemente și nu o singură dată pentru întreaga animație.
Putem anima orice element, de exemplu o imagine simpla:
Putem anima cu .toggle () după ce faceți clic pe un alt element:
Cu elementul afișat inițial, îl putem ascunde încet după primul clic:
Al doilea clic va afișa elementul din nou:
A doua versiune a metodei ia un parametru boolean. Dacă acest parametru este adevărat. atunci elementul va apărea dacă elementul fals este ascuns. În esență, expresia:
Notă suplimentară:
- Toate efectele jQuery, inclusiv .toggle (). poate fi dezactivat la nivel global prin setarea jQuery.fx.off = true. care stabilește durata animației la 0. Aceasta este descrisă mai detaliat în pagina jQuery.fx.off.