Skip to content

⚡ A lightweight JavaScript library that allows developers to keep track of changes to JavaScript objects and/or DOM elements.

License

Notifications You must be signed in to change notification settings

williamtroup/Observe.js

Repository files navigation

Observe.js

Tweet npm nuget license discussions Welcome coded by William Troup

A lightweight JavaScript library that allows developers to keep track of changes to JavaScript objects and/or DOM elements.

v1.1.0



What features does Observe.js have?

  • 😏 Zero-dependencies and extremely lightweight!
  • 🦾 Written in TypeScript, allowing greater support for React, Angular, and other libraries!
  • 💻 Full API available via public functions.
  • 🎥 JS Object and HTML DOM Element watching!
  • 🔍 Watch for specific property changes!
  • 🚀 Cancel, Pause, and Resume support!
  • ☑️ Fully configurable!
  • ☑️ Fully configurable per watch!
  • ❓ Custom triggers for actions (when changes are detected, on cancellation, etc).


What browsers are supported?

All modern browsers (such as Google Chrome, FireFox, and Opera) are fully supported.

What are the most recent changes?

To see a list of all the most recent changes, click here.

How do I install Observe.js?

You can install the library with npm into your local modules directory using the following command:

npm install jobserve.js


How do I get started?

To get started using Observe.js, do the following steps:

1. Prerequisites:

Make sure you include the "DOCTYPE html" tag at the top of your HTML, as follows:

<!DOCTYPE html>

2. Include Files:

<script src="dist/observe.js"></script>

3. DOM Element Binding / Object Watching:

<div data-observe-js="{ 'onChange': yourCustomJsFunction }">
    Your HTML.
</div>
<script> 
    var id = $observe.watch( yourObject, {
        onChange: yourCustomJsFunction
    } );
</script>

To see a list of all the available binding options you can use for "data-observe-js", and "watch()", click here.

To see a list of all the available custom triggers you can use for "data-observe-js", and "watch()", click here.


4. Finishing Up:

That's it! Nice and simple. Please refer to the code if you need more help (fully documented).

How do I go about customizing Observe.js?

To customize, and get more out of Observe.js, please read through the following documentation.

1. Public Functions:

To see a list of all the public functions available, click here.

2. Configuration:

Configuration options allow you to customize how Observe.js will function. You can set them as follows:

<script> 
  $observe.setConfiguration( {
      safeMode: false
  } );
</script>

To see a list of all the available configuration options you can use, click here.