Eldom NPM | npm.io

elDom.js

v1.1.0 - A super-micro framework for adding and removing classes to elements.

Install

Download elDom.min.js and include it in your project.

elDom is used with the $ variable, and follows a very familiar syntax.
$('.selector') returns a new instance of elDom, allowing you to access
methods directly via chaining.

$('.active').remove('active');

Methods

`$el.is(classname)`

Checks if $el has classname.
The boolean result is saved to the object,
if you want to return the boolean, call $el._hasClass(classname)

`$el.isnt(classname)`

I feel like this one explains itself.

`$el.holds(classname)`

Checks if the element has a child with classname.

`$el.add(classname)`

Adds classname to $el.

`$el.remove(classname)`

Removes classname from $el.

`$el.delete(callback)`

Deletes the element, optionally returns callback.

`$el.then(callback(el){})`

Simply fires the callback if it's allowed to.
el is the selector. See chaining below.

`$el.tick(classname, time)`

Automatically toggles classname on $el every time seconds.
Example use case for this is breathing animations.

Chaining

Since elDom always returns itself, you can chain methods together:
$('.selector').add('someclass').remove('otherclass')

Chaining can be combined with has() and hasnt() to allow for if/then:
$('nav a').has('active').remove('active').add('link');

So, with every link in the chain, the state gets reset to null.
The first link, has(), sets the state to a boolean value and returns itself.
The next step looks at the state, and only processes if state != false.

That means in the second example above, if .has('active') returns false, then .remove('active') won't fire. However, since .remove() still resets the state, .add('link') fires as normal.

But what if I want to do things that aren't chainable?
That's where .then() comes in.

  $('nav a').has('active').then(function(el) {
    // your custom code here
    $(el).remove('active');
    // some more custom code here
    // whatever you want, really
  }).add('link'); // chain is still preserved.