Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Voľby MutationObserver: typy zmien, podstrom, filter a predchádzajúce hodnoty

Pomocou `observe()` nastav sledovanie zmien potomkov, atribútov alebo znakových údajov. Vyber rozsah sledovania a urči, kedy má záznam obsahovať hodnotu pred zmenou.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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) vytvorí pozorovateľa; observer.observe(target, options) spustí sledovanie uzla DOM. Funkcia spätného volania dostane pole objektov MutationRecord a pozorovateľa. Ide o rozhranie DOM webovej platformy, nie o súčasť ECMAScriptu 2024; dostupnosť závisí od prostredia vykonávania.

childList hlási pridanie alebo odstránenie priamych potomkov sledovaného uzla (addedNodes, removedNodes). attributes hlási pridanie, zmenu alebo odstránenie atribútov prvku. characterData hlási úpravy existujúceho uzla CharacterData, napríklad zmenu text.data. Priradenie do textContent prvku nahradí jeho potomkov. Ak sa ich zoznam zmení, zmena sa hlási ako childList, nie ako characterData. subtree: true rozšíri sledovanie vybraných typov zmien na potomkov; predvolene sa sleduje iba target.

attributeFilter uvádza lokálne názvy atribútov, nie selektory CSS. S filtrom vyhovujú iba uvedené atribúty bez menného priestoru; bez filtra sa zohľadňujú všetky atribúty. attributeOldValue: true a characterDataOldValue: true uložia hodnotu pred príslušnou zmenou do vlastnosti record.oldValue určenej len na čítanie. Voľba oldValue ani pole newValue neexistujú. oldValue je null pri childList, keď sa predchádzajúca hodnota nevyžiadala alebo keď atribút predtým neexistoval.

childList má predvolenú hodnotu false. Ak sa attributes vynechá, nastaví sa na true pri zadaní attributeFilter alebo attributeOldValue; ak sa vynechá characterData, nastaví sa na true pri zadaní characterDataOldValue. Pri voľbe predchádzajúcej hodnoty stačí, že je zadaná, aj s hodnotou false. Inak sú oba typy predvolene vypnuté. observe() vyvolá TypeError, keď nie je zapnutý žiadny typ, pri kombinácii attributes: false s filtrom alebo s attributeOldValue: true, alebo pri kombinácii characterData: false s characterDataOldValue: true.

Záznamy dostáva funkcia spätného volania po dávkach v mikroúlohe, nie počas samotnej zmeny DOM. Pri subtree: true dočasné registrácie umožňujú ďalej sledovať podstrom odstráneného potomka. Oznamovacia mikroúloha tieto registrácie odstráni pri spracovaní pozorovateľa, ešte pred prípadným spätným volaním. Na odstránenie registrácií netreba doručiť záznam o odstránení uzla: childList môže byť vypnuté alebo takeRecords() už mohlo vyprázdniť front. disconnect() ukončí sledovanie a zahodí čakajúce záznamy; ak ich potrebuješ, najprv ich vyzdvihni cez takeRecords(), ktoré vyprázdni front.

Príklady

<!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>

Výsledok

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

Ulož celý príklad ako súbor `.html` a otvor ho v prehliadači. Otvor vývojársku konzolu a načítaj stránku znova. Uzly sa nevkladajú do stránky. Filter vylúči `title` a voľby predchádzajúcich hodnôt zapnú vynechané voľby `attributes` a `characterData`. Funkcia spätného volania vypíše tri záznamy v poradí zmien a potom sledovanie ukončí.

Súvisiace lekcie

  • JavaScript · Lekcia 31 · Stredne pokročilá · Verzia: 3

Zdroje