Kwalifikacja: INF.04 - Projektowanie, programowanie i testowanie aplikacji

Wybór innej funkcji niż .toggleClass() może wynikać z mylnego założenia, że mechanizm zmiany klas w jQuery działa intuicyjnie jak w czystym JavaScripcie, albo z braku doświadczenia z dokumentacją jQuery. Przykładowo, .switchClass() faktycznie istnieje w bibliotece jQuery UI (a nie w podstawowej wersji jQuery), lecz jej zadaniem jest płynne przejście z jednej klasy do drugiej, często z animacją. Nie obsługuje ona jednak naprzemiennego dodawania i usuwania pojedynczej klasy. .changeClass() oraz .bingClass() to natomiast funkcje wymyślone — w oficjalnej dokumentacji jQuery nie występują i ich użycie zakończyłoby się błędem w konsoli przeglądarki. Zdarza się, że osoby początkujące szukają metody z nazwą „change”, bo wydaje się to logiczne w języku angielskim, jednak w jQuery składnia i konwencje opierają się na słowach typu add, remove, a w tym przypadku toggle. Typowym błędem jest też mieszanie funkcjonalności jQuery z czystym JavaScriptem, gdzie operacje na klasach odbywają się przez classList.toggle(), co może wprowadzać w błąd podczas nauki. Dobra praktyka w branży polega na wykorzystywaniu wyłącznie udokumentowanych metod i czytaniu oficjalnych materiałów — w ten sposób łatwiej uniknąć nieporozumień i zyskać pewność, że kod będzie działał poprawnie we wszystkich przeglądarkach wspieranych przez jQuery. Moim zdaniem najwięcej zamieszania wprowadza podobieństwo nazw metod oraz chęć uproszczenia kodu, co czasami prowadzi do nieświadomego wybierania nieistniejących funkcji. Warto więc regularnie zaglądać do dokumentacji, bo nawet jeśli coś wydaje się logiczne, to nie zawsze jest zaimplementowane w bibliotece.