Przycisk „Dodaj do koszyka” wygląda dobrze, ale po kliknięciu nic się nie dzieje? W większości prostych stron wystarczy połączyć HTML z krótkim skryptem JavaScript, choć sposób wczytania pliku może zdecydować, czy kod w ogóle znajdzie przycisk.
HTML tworzy strukturę, a JavaScript nadaje jej zachowanie
- HTML opisuje elementy strony, takie jak przyciski, formularze i nagłówki.
- JavaScript reaguje na zdarzenia i może aktualizować widok strony.
- defer to bezpieczny wybór dla zewnętrznego skryptu zależnego od elementów HTML.
- Moduły porządkują większy kod, a przeglądarka odracza ich wykonanie domyślnie.
- Framework pomaga przy rozbudowanym interfejsie, ale do pojedynczej interakcji często wystarczy zwykły JavaScript.
JavaScript zmienia zachowanie elementów opisanych w HTML
HTML dostarcza stronie strukturę, a JavaScript pozwala zareagować, gdy ktoś kliknie przycisk, wpisze tekst lub wyśle formularz. Przeglądarka udostępnia skryptowi model DOM, czyli obiektową reprezentację dokumentu, przez którą można odszukać element i zmienić jego treść albo zachowanie.
Przykładowo przycisk może zwiększyć licznik produktów w koszyku, a formularz może wyświetlić komunikat po wysłaniu danych. Uważam, że dobry punkt wyjścia to mała interakcja, która rozwiązuje jeden widoczny problem, zamiast dodawać skrypt „na zapas”.
Atrybut defer zapobiega typowemu błędowi z pustym elementem
Skrypt uruchomiony przed odczytaniem przycisku przez przeglądarkę może nie znaleźć elementu w DOM. W zewnętrznym pliku najprościej uniknąć tego problemu, dodając defer:
W pliku app.js można obsłużyć kliknięcie tak:
const button = document.querySelector("#cart-button");
const message = document.querySelector("#cart-message");
button.addEventListener("click", () => {
message.textContent = "Produkt dodany do koszyka.";
});
Atrybut defer sprawia, że zewnętrzny klasyczny skrypt wykona się po przetworzeniu dokumentu HTML, a kolejność takich skryptów pozostanie zgodna z kolejnością w kodzie. Z kolei async nie gwarantuje kolejności wykonania, więc pasuje raczej do niezależnych skryptów, na przykład zewnętrznych narzędzi analitycznych. Te różnice opisuje dokumentacja elementu script w MDN.
Gdy kliknięcie nic nie robi, sprawdź trzy miejsca
Brak reakcji często wynika z drobiazgu: literówki w ścieżce pliku, innego identyfikatora elementu albo skryptu uruchomionego przed zbudowaniem DOM. Zamiast przepisywać cały kod, sprawdź najpierw, na którym z tych etapów pojawia się problem.
| Sytuacja | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| W konsoli widnieje błąd pobrania pliku | Nieprawidłowa ścieżka w atrybucie src |
Sprawdź położenie pliku względem dokumentu HTML i wielkość liter w nazwie. |
Komunikat mówi o odczycie właściwości wartości null |
Selektor nie znalazł elementu albo skrypt wystartował zbyt wcześnie | Porównaj identyfikator w HTML z selektorem i dodaj defer do zewnętrznego skryptu. |
| Przycisk działa, ale treść się nie zmienia | Listener podpięto do innego elementu lub wskazano zły cel aktualizacji | Sprawdź oba selektory w konsoli i upewnij się, że wskazują istniejące elementy. |
| Import w pliku JavaScript kończy się błędem | Plik korzysta z modułów, ale HTML ładuje go jak skrypt klasyczny | Dodaj type="module" w tagu skryptu i sprawdź ścieżki importów. |
Przy większym projekcie zwykle wygodniej rozdzielić kod na moduły ES, które udostępniają funkcje przez export i pobierają je przez import. Skrypt oznaczony type="module" jest odraczany domyślnie, więc nie trzeba dopisywać mu defer; szczegóły opisuje przewodnik MDN o modułach JavaScript.
Framework wybierz dopiero wtedy, gdy zwykły skrypt zaczyna przeszkadzać
Jedno menu, walidacja formularza albo przełącznik motywu nie wymagają frameworka. Przy wielu powtarzalnych komponentach, złożonym stanie interfejsu i rozbudowanych widokach framework może uporządkować pracę, ale dokłada też narzędzia i konwencje, których trzeba się nauczyć.
| Rozwiązanie | Kiedy pasuje | O czym pamiętać |
|---|---|---|
| Czysty JavaScript | Pojedyncze zachowania na stronie lub mały serwis | Prosty start, ale przy rozroście interfejsu trzeba samodzielnie pilnować organizacji kodu. |
| Vue | Stopniowe dodawanie reaktywnych fragmentów do istniejącej strony | Można zacząć bez procesu budowania, lecz taki wariant nie obsługuje składni komponentów jednoplikowych. |
| React | Interfejs oparty na wielokrotnie używanych komponentach, także w istniejącej stronie | Do wygodnej pracy z JSX i modułami zwykle potrzebne jest środowisko programistyczne; React można wdrażać stopniowo. |
| Angular | Większa aplikacja, w której przydaje się rozbudowany zestaw narzędzi i wspólna architektura | To szerszy framework, więc próg wejścia jest wyższy niż przy dopisaniu krótkiego skryptu. |
Vue dokumentuje zarówno uruchomienie bezpośrednio z CDN, jak i konfigurację projektu z narzędziami, a dokumentacja Reacta opisuje dodawanie komponentów do istniejącej strony. Przy pojedynczej funkcji postawiłbym na czysty JavaScript; gdy widok składa się z wielu współdzielonych komponentów i często zmienia stan, rozważyłbym framework. Informacje o stopniowej integracji Reacta znajdziesz w dokumentacji Reacta, a wariantach użycia Vue w przewodniku szybkiego startu Vue.
Najpierw dopasuj narzędzie do skali interakcji
Najprostszy test wyboru brzmi: czy kod obsługuje kilka niezależnych zdarzeń, czy zarządza całym, zmiennym interfejsem? Jeśli chodzi o pojedynczy przycisk, formularz lub rozwijane menu, zacznij od HTML i JavaScriptu. Gdy pojawiają się współdzielone komponenty, wiele stanów i powtarzające się aktualizacje widoku, framework może ułatwić utrzymanie całości.
Najpierw dopilnuj, by HTML miał sens także bez skryptu, a JavaScript dodawał do niego potrzebne zachowanie. Taki porządek ułatwia diagnozowanie błędów, a ekran przycisku, który początkowo milczał, przestaje być zagadką.