Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Možnosti MutationObserver: vrste sprememb, poddrevo, filter in prejšnje vrednosti

Z `observe()` nastavi spremljanje sprememb otroških vozlišč, atributov ali znakovnih podatkov. Izberi obseg spremljanja in določi, kdaj naj zapis vsebuje vrednost pred spremembo.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const observer = new MutationObserver((records, observer) => {
  for (const record of records) {
    // Read record.type, record.target, or record.oldValue.
  }
});

observer.observe(target, {
  childList: true,
  attributes: true,
  characterData: true,
  subtree: true,
  attributeFilter: ["data-state"],
  attributeOldValue: true,
  characterDataOldValue: true,
});

new MutationObserver(callback) ustvari opazovalnika; observer.observe(target, options) začne spremljati vozlišče DOM. Povratna funkcija prejme tabelo objektov MutationRecord in opazovalnika. To je vmesnik DOM spletne platforme, ne del ECMAScripta 2024; razpoložljivost je odvisna od izvajalnega okolja.

childList sporoča dodajanje ali odstranjevanje neposrednih otrok spremljanega vozlišča (addedNodes, removedNodes). attributes sporoča dodajanje, spreminjanje ali odstranjevanje atributov elementa. characterData sporoča spremembe obstoječega vozlišča CharacterData, na primer spremembo text.data. Prireditev vrednosti lastnosti textContent elementa nadomesti njegove otroke. Če se njihov seznam spremeni, je vrsta spremembe childList, ne characterData. subtree: true razširi spremljanje izbranih vrst sprememb na potomce; privzeto se spremlja samo target.

attributeFilter vsebuje lokalna imena atributov, ne izbirnikov CSS. S filtrom se ujemajo samo navedeni atributi brez imenskega prostora; brez filtra se upoštevajo vsi atributi. attributeOldValue: true in characterDataOldValue: true shranita vrednost pred ustrezno spremembo v lastnost record.oldValue, ki je samo za branje. Možnosti oldValue in polja newValue ni. oldValue je null pri childList, kadar prejšnja vrednost ni bila zahtevana ali kadar atribut prej ni obstajal.

childList je privzeto false. Če attributes izpustiš, postane true, ko navedeš attributeFilter ali attributeOldValue; če izpustiš characterData, postane true, ko navedeš characterDataOldValue. Pri možnostih za prejšnjo vrednost zadošča že njihova prisotnost, tudi z vrednostjo false. Sicer sta obe vrsti privzeto izklopljeni. observe() sproži TypeError, če ni vklopljena nobena vrsta, če attributes: false združiš s filtrom ali z attributeOldValue: true ali če characterData: false združiš z characterDataOldValue: true.

Povratna funkcija prejme zapise v skupinah v mikroopravilu, ne med samo spremembo DOM. Pri subtree: true začasne registracije omogočajo nadaljnje spremljanje poddrevesa odstranjenega potomca. Mikroopravilo za obveščanje odstrani te registracije, ko obravnava opazovalnika, pred morebitnim klicem povratne funkcije. Za odstranitev registracij ni treba dostaviti zapisa o odstranitvi vozlišča: childList je lahko izklopljen ali pa je takeRecords() že izpraznil čakalno vrsto. disconnect() ustavi spremljanje in zavrže čakajoče zapise. Če jih potrebuješ, jih prej pridobi s takeRecords(), ki izprazni čakalno vrsto.

Primeri

<!doctype html>
<meta charset="utf-8">
<title>MutationObserver options</title>
<script>
  const root = document.createElement("div");
  const item = document.createElement("span");
  const text = document.createTextNode("before");
  item.setAttribute("data-state", "idle");
  item.append(text);
  root.append(item);

  const observer = new MutationObserver((records, self) => {
    for (const record of records) {
      console.log(JSON.stringify([record.type, record.attributeName, record.oldValue]));
    }
    self.disconnect();
  });

  observer.observe(root, {
    childList: true,
    subtree: true,
    attributeFilter: ["data-state"],
    attributeOldValue: true,
    characterDataOldValue: true,
  });

  item.setAttribute("data-state", "ready");
  item.setAttribute("title", "ignored");
  text.data = "after";
  item.append(document.createElement("em"));
</script>

Rezultat

["attributes","data-state","idle"]
["characterData",null,"before"]
["childList",null,null]

Shrani celoten primer kot datoteko `.html` in jo odpri v brskalniku. Odpri razvojno konzolo in znova naloži stran. Vozlišča niso dodana na stran. Filter izloči `title`, možnosti za prejšnje vrednosti pa vklopijo izpuščeni možnosti `attributes` in `characterData`. Povratna funkcija izpiše tri zapise po vrstnem redu sprememb in nato ustavi spremljanje.

Povezane lekcije

  • JavaScript · Lekcija 31 · Srednja · Različica: 3

Viri