Home

Awesome

NgxMutationObserver

Angular 19.x library to monitor changes to elements. Uses MutationObserver to do the work.

If you're only looking for a way to see if elements are visible, I suggest checking out ngx-visibility instead. This doesn't notice everything - for instance, an element whose width is set to "50%" will not report a mutation when the window is resized or when a scrollbar is visible. Instead, a mutation is reported when the width is changed from "50%" to "75%" or to "128px".

If you only care about when elements are resized, including resize events due to browser window size changing, look at ngx-resize-observer.

Demonstration

There's a live demo over at CodeSandbox.io.

Installation

Install like other Angular libraries. First run a command to download the module.

npm install ngx-mutation-observer

Next, add the module to your project.

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';

// Import the module
import { NgxMutationObserverModule } from 'ngx-mutation-observer';

import { AppComponent } from './app.component';

@NgModule({
    declarations: [AppComponent, ItemComponent],

    // Include the module.
    imports: [BrowserModule, FormsModule, NgxMutationObserverModule],
    providers: [],
    bootstrap: [AppComponent]
})
export class AppModule {}

Finally, you leverage the service directly or use some directives for common uses.

NgxMutationObserverDirective

Emits MutationRecord[] when a mutation is detected.

<div (onMutation)="handleMutation($event)"></div>

Configuration is allowed through the mutationConfig directive. When not specified, this defaults to {attributes: true, characterData: true, childList: true }. You are allowed to specify anything allowed in the interface. For instance, if you only care about the size of an element changing, you would only watch its attributes.

<div (onMutation)="attributesChanged($event)" [mutationConfig]="{attributes: true}"></div>

License

This project is licensed under an MIT license.