Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Volby MutationObserver: typy změn, podstrom, filtr a předchozí hodnoty

Pomocí `observe()` nastav sledování změn potomků, atributů nebo znakových dat. Zvol rozsah sledování a urči, kdy má záznam obsahovat hodnotu před změnou.

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

Syntaxe

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) vytvoří pozorovatele; observer.observe(target, options) spustí sledování uzlu DOM. Zpětné volání dostane pole objektů MutationRecord a pozorovatele. Jde o rozhraní DOM webové platformy, nikoli o součást ECMAScriptu 2024; dostupnost závisí na běhovém prostředí.

childList hlásí přidání či odebrání přímých potomků sledovaného uzlu (addedNodes, removedNodes). attributes hlásí přidání, změnu či odebrání atributů prvku. characterData hlásí úpravy existujícího uzlu CharacterData, například změnu text.data. Přiřazení do textContent prvku nahradí jeho potomky. Pokud se jejich seznam změní, změna se ohlásí jako childList, nikoli jako characterData. subtree: true rozšíří sledování vybraných typů změn i na potomky; ve výchozím nastavení se sleduje jen target.

attributeFilter je seznam místních názvů atributů, nikoli selektorů CSS. S filtrem vyhoví jen uvedené atributy bez jmenného prostoru; bez filtru se berou v úvahu všechny atributy. attributeOldValue: true a characterDataOldValue: true uloží hodnotu před odpovídající změnou do vlastnosti record.oldValue určené pouze ke čtení. Volba oldValue ani pole newValue neexistují. oldValue je null u childList, pokud se o předchozí hodnotu nežádalo nebo pokud atribut dříve neexistoval.

childList má výchozí hodnotu false. Vynechané attributes se nastaví na true, pokud je uvedeno attributeFilter nebo attributeOldValue; vynechané characterData se nastaví na true, pokud je uvedeno characterDataOldValue. U volby předchozí hodnoty stačí její přítomnost, i s hodnotou false. Jinak jsou oba typy ve výchozím nastavení vypnuté. observe() vyvolá TypeError, pokud není zapnutý žádný typ, při kombinaci attributes: false s filtrem nebo s attributeOldValue: true či při kombinaci characterData: false s characterDataOldValue: true.

Záznamy se předávají zpětnému volání po dávkách v mikroúloze, nikoli během samotné změny DOM. Při subtree: true umožňují dočasné registrace dál sledovat podstrom odebraného potomka. Oznamovací mikroúloha tyto registrace při zpracování pozorovatele odstraní, a to před případným zpětným voláním. Odstranění registrací není podmíněno doručením záznamu o odebrání: childList může být vypnuté nebo už mohlo frontu vyprázdnit takeRecords(). disconnect() ukončí sledování a zahodí čekající záznamy; pokud je potřebuješ, nejprve je vyzvedni pomocí takeRecords(), které frontu vyprázdní.

Pří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ýsledek

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

Ulož celý příklad jako soubor `.html` a otevři ho v prohlížeči. Otevři vývojářskou konzoli a načti stránku znovu. Uzly se nevkládají do stránky. Filtr vynechá `title` a volby předchozích hodnot zapnou neuvedené volby `attributes` a `characterData`. Zpětné volání vypíše tři záznamy v pořadí změn a poté sledování ukončí.

Související lekce

  • JavaScript · Lekce 31 · Středně pokročilá · Verze: 3

Zdroje