JarCasting
JarCasting JarCasting

onmount

WebJar for onmount

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

onmount
Last Version

Last Version

1.3.0
Release Date

Release Date
Type

Type

jar
Description

Description

onmount
WebJar for onmount
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/rstacruz/onmount

Download onmount

Filename Size
onmount-1.3.0.pom
onmount-1.3.0.jar 28 KB
onmount-1.3.0-sources.jar 22 bytes
onmount-1.3.0-javadoc.jar 22 bytes
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/onmount/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>onmount</artifactId>
    <version>1.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/onmount/
implementation 'org.webjars.npm:onmount:1.3.0'
// https://jarcasting.com/artifacts/org.webjars.npm/onmount/
implementation ("org.webjars.npm:onmount:1.3.0")
'org.webjars.npm:onmount:jar:1.3.0'
<dependency org="org.webjars.npm" name="onmount" rev="1.3.0">
  <artifact name="onmount" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='onmount', version='1.3.0')
)
libraryDependencies += "org.webjars.npm" % "onmount" % "1.3.0"
[org.webjars.npm/onmount "1.3.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

onmount

Run something when a DOM element appears and when it exits.
No dependencies. Legacy IE compatible. 1kb .min.gz.

Status

Overview

Detecting elements

Run something to initialize an element on its first appearance.

onmount = require('onmount')

onmount('.push-button', function() {
  $(this).on('click', function() {
    alert('working...')
  })
})

See: Premise

Using with React

🎉 If you're looking to use Onmount to mount React components, check out Remount instead.

Polling for changes

Call $.onmount() everytime your code changes.

$('<button class="push-button">Do something</button>').appendTo('body')

$.onmount()

$('.push-button').click() //=> 'working...'

See: Idempotency

jQuery integration

jQuery is optional; use it to poll on popular events.

$(document).on('ready show.bs closed.bs load page:change', function() {
  $.onmount()
})

See: API

Cleanups

Supply a 2nd function to onmount() to execute something when the node is first detached.

$.onmount(
  '.push-button',
  function() {
    /*...*/
  },
  function() {
    alert('button was removed')
  }
)

document.body.innerHTML = ''

$.onmount() //=> 'button was removed'

See: Cleanups

What for?

Onmount is a safe, reliable, idempotent, and testable way to attach JavaScript behaviors to DOM nodes. It's great for common websites that are not Single-Page Apps. Read more on its premise and motivation.

rsjs (Reasonable System for JavaScript Structure) is a great standard that onmount fits perfectly into.

Usage

Onmount is available via npm and Bower.

npm install onmount
bower install onmount

It can be used as a CommonJS module or on its own. It doesn't require jQuery, but if jQuery is found, it'll attach itself to it as $.onmount.

onmount = require('onmount') // With CommonJS (ie, Browserify)
window.onmount // with no module loaders:
$.onmount // with jQuery

API

See: API

Browser compatibility

All modern browsers and IE8+. For legacy IE, use it with jQuery 1.x.

Examples

Examples are available in the source repo. See examples →

Thanks

onmount © 2015+, Rico Sta. Cruz. Released under the MIT License.
Authored and maintained by Rico Sta. Cruz with help from contributors (list).

ricostacruz.com  ·  GitHub @rstacruz  ·  Twitter @rstacruz

Versions

Version
1.3.0