@squarespace/darwin
v1.0.4
Published
MutationObserver implementation for convenience
Downloads
15
Maintainers
Keywords
Readme
Squarespace Darwin
Passthrough implementation of MutationObserver designed to make it easier to use, handling DOM querying, browser compatibility, and other stuff like that for you.
NOTICE: This code is licensed to you pursuant to Squarespace’s Developer Terms of Use. See license section below.
Usage
npm install @squarespace/darwin;
import Darwin from '@squarespace/darwin';
const instance = new Darwin({
callback: () => {
console.log('Mutation observed!');
},
targets: [
'.my-mutating-node'
]
});
Using ES6
If you prefer to handle transpiling and polyfilling on your own, you can import ES6 from Darwin:
import darwin from '@squarespace/darwin/src';
Alternately, Darwin specifies a module
property in package.json
that points to the uncompiled src/index.js
, so you may be able to simply import @squarespace/darwin
if you're using one of the following bundlers:
Reference
new Darwin(config)
Params
- config
Object
- Config object - config.callback
Array
- Callback function to run when mutations occur - config.targets
Boolean
- Selectors of targets to observe
Darwin.init()
Create a new MutationObserver and instruct it to observe the targets you gave it.
Darwin.destroy()
Unbind all event listeners, disconnect the MutationObserver and null it out.
License
Portions Copyright © 2016 Squarespace, Inc. This code is licensed to you pursuant to Squarespace’s Developer Terms of Use, available at http://developers.squarespace.com/developer-terms-of-use (the “Developer Terms”). You may only use this code on websites hosted by Squarespace, and in compliance with the Developer Terms. TO THE FULLEST EXTENT PERMITTED BY LAW, SQUARESPACE PROVIDES ITS CODE TO YOU ON AN “AS IS” BASIS WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED.