Mutation Observer

<wa-mutation-observer> Stable Since 2.0

Mutation observers watch for changes to an element's DOM tree and emit an event when they occur. Provides a thin, declarative interface to the browser's MutationObserver API.

The mutation observer will report changes to the content it wraps through the wa-mutation event. When emitted, a collection of MutationRecord objects will be attached to event.detail that contains information about how it changed.

Click to mutate
👆 Click the button and watch the console

When you create a mutation observer, you must indicate what changes it should respond to by including at least one of attr, child-list, or char-data. If you don't specify at least one of these attributes, no mutation events will be emitted.

Examples

Link to This Section

Child List

Link to This Section

Use the child-list attribute to watch for new child elements that are added or removed.

Add button
👆 Add and remove buttons and watch the console

Importing

Link to This Section

If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick a component manually, use one of the following snippets.

CDN npm Self-Hosted React

Import this component directly from the CDN:

import 'https://ka-f.webawesome.com/[email protected]/components/mutation-observer/mutation-observer.js';

After installing Web Awesome via npm, import this component:

import '@awesome.me/webawesome/dist/components/mutation-observer/mutation-observer.js';

If you're self-hosting Web Awesome, import this component from your server:

import './webawesome/dist/components/mutation-observer/mutation-observer.js';

To import this component for React 18 or below, use the following code:

import WaMutationObserver from '@awesome.me/webawesome/dist/react/mutation-observer/index.js';

Slots

Link to This Section

Learn more about using slots.

Attributes & Properties

Link to This Section

Learn more about attributes and properties.

Events

Link to This Section

Learn more about events.

Need a hand? Report a bug Ask for help
    No results