Skip to content

Latest commit

 

History

History
101 lines (63 loc) · 2.79 KB

README.md

File metadata and controls

101 lines (63 loc) · 2.79 KB
Raw

freeDOM

A JavaScript DOM Manipulation Library

Live

Description

FreeDOM is a DOM Manipulation library for making AJAX requests, handling events, manipulating the DOM, inspired by jQuery and written in vanilla JavaScript.

Functionalities include:

  • Hold DOM nodes and offer convenient methods for traversal and manipulation, like empty, remove, attr, addClass, removeClass, html, find, children, and parent
  • Select DOM Elements by HTML tag, id, or class
  • Handle events with callbacks using on and off methods
  • Make AJAX requests

Using freeDOM

  • Clone the repo into your project
  • Import freeDOM.js into your project by including it in a script tag in the header of your HTML

API

$l

The $l wrapper has three main uses:

  • Creates a new DOMNodeCollection object, ex: $l("<li>")
  • Takes an HTMLElement and wraps it to return an DOMNodeCollection object
  • Selects elements via tags, css selectors or id, ex: $l(".class") or $l("#id")

DOM Traversal

#find(selector)

Returns a DOMNodeCollection of all the nodes that match the argument that are children of the DOMNodeCollection nodes.

#children()

Returns a DOMNodeCollection of all children of all nodes within the DOMNodeCollection.

$l(".class").children()

#parent()

Returns a DOMNodeCollection of the parent of all nodes within the DOMNodeCollection.

$l(".class").parent().

#remove()

Removes the element from the DOM.

Event Handling

#on(action,callback)

Installs an 'action' event handler. When triggered runs the callback.

$l(".submit").on("click", e => { e.preventDefault(); const value = document.querySelector('.input').value; if (value) { $l('.todo-list').append(); } }

#off(action)

Removes the 'action' listener from the DOM

Manipulation

#addClass(className)

Adds a class attritube to all nodes within the DOMNodeCollection.
node.addClass("className");

#removeClass(className)

Remove a class attritube of all nodes within the DOMNodeCollection.
node.removeClass("className");

#append(arg)

arg can be a string, HTMLElement, or DOMNodeCollection object Appends the outerHTML of each element in the argument to the innerHTML of ALL nodes within the DOMNodeCollection. node.append(${newStuff}); newNode.append(something); where subButton is an instance of DOMNodeCollection

#empty()

Clears the content from all nodes within the DOMNodeCollection.

#attr(key, [value])

Accepts a key and optional value. If the value exists, it will add that value and key to all nodes within the DOMNodeCollection. If there is no value, it will return the value corresponding for the key of the first node.

if ($l(e.target).attr("class") === "delete") { $l(e.target).parent().remove(); }