0Pricing
HTML Academy · Lekcja

Obserwowane atrybuty i attributeChangedCallback

Reagowanie na zmiany atrybutów HTML w niestandardowych elementach

Obserwowane atrybuty i attributeChangedCallback to bezpłatna lekcja HTML Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej HTML Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs HTML Academy zawiera 4 lekcji w sumie.

Reagowanie na zmiany atrybutów

Elementy HTML udostępniają swój stan za pomocą atrybutów. Aby reagować na zmianę <my-card name="A"> w name="B", należy zadeklarować listę obserwowanych atrybutów i zaimplementować attributeChangedCallback w klasie.

Statyczne observedAttributes

Należy zadeklarować interesujące Państwa atrybuty za pomocą statycznego gettera: static get observedAttributes() { return ["name", "open"]; }. Tylko atrybuty z tej listy wywołują callback — pozostałe są ignorowane ze względów wydajnościowych.

class MyCard extends HTMLElement {
  static get observedAttributes() { return ["name", "open"]; }
}

Sygnatura callbacka

attributeChangedCallback(name, oldValue, newValue) jest wywoływana przy każdej zmianie obserwowanego atrybutu. Wszystkie trzy parametry są ciągami znaków (lub wartością null, jeśli atrybutu nie ma). Należy użyć ich do aktualizacji stanu wewnętrznego i ponownego renderowania.

attributeChangedCallback(name, oldValue, newValue) {
  if (oldValue === newValue) return;
  if (name === "name") this.render();
  if (name === "open") this.toggle(newValue !== null);
}

Wywołanie dla początkowych atrybutów

Callback jest wywoływany raz dla każdego obserwowanego atrybutu obecnego w chwili upgrade'u elementu. Oznacza to, że renderowanie w attributeChangedCallback obsługuje zarówno pierwsze, jak i kolejne renderowania, bez osobnej ścieżki w connectedCallback.

Refleksja właściwości i atrybutu

W przypadku atrybutów logicznych należy odzwierciedlać właściwość w atrybucie i odwrotnie: ustawienie element.open = true powinno ustawić atrybut open, a usunięcie atrybutu powinno wyczyścić właściwość. Tak samo działają wbudowane elementy, takie jak <details>.

get open() { return this.hasAttribute("open"); }
set open(value) {
  if (value) this.setAttribute("open", "");
  else this.removeAttribute("open");
}

Unikanie nieskończonych pętli

Jeśli attributeChangedCallback ustawia obserwowane przez siebie atrybuty, może rozpocząć się nieskończona pętla. Na początku callbacka należy zawsze zastosować warunek if (oldValue === newValue) return; i unikać zmieniania obserwowanych atrybutów wewnątrz callbacka.

Atrybuty logiczne

Zgodnie z konwencją HTML atrybuty logiczne są „ustawione” przez samą obecność (disabled, open) i „nieustawione” przez brak. Ich wartość jest ignorowana — disabled="false" nadal oznacza stan disabled. Obecność należy sprawdzać za pomocą hasAttribute, nigdy nie porównując ciągu znaków.

JSON w atrybutach

Atrybuty są ciągami znaków. Aby przekazać dane strukturalne, należy użyć JSON.stringify w oznaczeniu HTML i sparsować dane w attributeChangedCallback: <my-chart data-points='[1,2,3]'>. W przypadku dużych ilości danych lepiej przekazywać je przez przypisanie właściwości w JS.

W porównaniu z MutationObserver

Zmiany atrybutów można obserwować za pomocą MutationObserver, ale observedAttributes + attributeChangedCallback jest szybsze (nie wymaga konfigurowania obserwatora), deklaratywne (lista obserwowanych nazw jest widoczna w klasie) i idiomatyczne dla komponentów webowych.

Wydajność: grupowanie renderowań

Wiele atrybutów zmieniających się szybko jeden po drugim wywołałoby wiele callbacków i renderowań. Należy je grupować za pomocą queueMicrotask lub requestAnimationFrame, aby właściwe renderowanie było wykonywane raz na mikrozadanie lub klatkę, niezależnie od liczby zmienionych atrybutów.

Częsty błąd

Pominięcie atrybutu w observedAttributes po cichu wyłącza callback dla tego atrybutu. Jeśli komponent nie reaguje na wywołanie setAttribute, pierwszą rzeczą do sprawdzenia powinna być statyczna lista observedAttributes.

Sprawdzenie wiedzy

Co się stanie, jeśli pośrednio wywołają Państwo attributeChangedCallback, ustawiając obserwowany atrybut wewnątrz callbacka?

Podsumowanie

Za pomocą statycznego gettera observedAttributes należy zadeklarować, które atrybuty mają być śledzone; attributeChangedCallback(name, oldValue, newValue) jest wywoływana przy każdej zmianie, także podczas początkowego parsowania. W przypadku stanu logicznego należy odzwierciedlać właściwości w atrybutach, zabezpieczać się przed nieskończonymi pętlami i grupować renderowania za pomocą requestAnimationFrame, aby zachować wydajność.

Często zadawane pytania

Czy lekcja „Obserwowane atrybuty i attributeChangedCallback” jest bezpłatna?

Tak — pełny tekst „Obserwowane atrybuty i attributeChangedCallback” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu HTML Academy, przejdź na CoddyKit PRO. Kurs HTML Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Obserwowane atrybuty i attributeChangedCallback”?

Reagowanie na zmiany atrybutów HTML w niestandardowych elementach Ćwiczysz HTML Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć HTML Academy?

Nie wymagamy żadnego doświadczenia. HTML Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Obserwowane atrybuty i attributeChangedCallback”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji HTML Academy?

Tak. Każda lekcja HTML Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Definiowanie elementów za pomocą customElements.define
  2. connectedCallback i disconnectedCallback
  3. Obserwowane atrybuty i attributeChangedCallback
  4. Rozszerzanie wbudowanych elementów
← Powrót do HTML Academy