Like us a lot? Help others know why you like us! Review this package on pkgreview.dev | ➡ |
---|
This is an open-source collection of functions, methods and routine javascript operations which every front-end developer might have a use for at some point in their project.
It is worth saying that this is a dependency free library, and was built from ground up using plain old vanilla javascript.
It bascially simplifies your work flow by shorthanding some of the long boring codes you write everytime which may consist of so many functions, variables, methods and so on, into a single function. From DOM manipulation, to mathematical calculations to string manipulations and so on all in one library(Pretty useful uh!😎).
Think of it as Lodash and JQuery all in one, with a few more tricks and flicks off it's sleaves.
Why write or copy the same code over and over again when you could just have it all in one library for easy access (Well step right up ToolJS 👏).
See the full documentation and api here ToolJS Documentation and API
In Node.js
npm install @redeakaa/tooljs
For Browser
<script src="https://unpkg.com/@redeakaa/[email protected]/dist/umd/tooljs.min.js"></script>
For Browser(As a module)
<script type="module" src="https://unpkg.com/@redeakaa/[email protected]/dist/esm/tooljs.esm.js"></script>
Usage In Node.js
To include the libraries default export
const ToolJS = require("@redeakaa/tooljs).default;
Then export a module or an array of modules to a variable and use as needed
var $ = ToolJS.export(["Str", "Calc", "Utils"]);
var total = $.add(10, 50, 40);
console.log(total);
// => 100
var toCamelCase = $.camelCase("Hello World from ToolJS");
console.log(toCamelCase);
// => "helloWorldFromToolJS"
var type = $.typeOf(400);
console.log(type);
// => "number"
Or you can include any of the libraries named exports and call any of its registered methods.
const { DOM, Obj, Str, Num, Calc, Utils } = require("@redeakaa/tooljs");
var capitalized = DOM.capitalize("hello world from toolJS");
console.log(capitalized);
// => "Hello World From ToolJS"
var obj = Obj.push({ name: "John Doe", age: 25 }, { gender: "Male" });
console.log(obj);
// => { name: "John Doe", age: 25, gender: "Male" }
Usage In Browser
If you included the tooljs.min.js
file or the tooljs.umd.js
, then the ToolJS
namespace is automatically exposed to the window object.
// export all methods in all registered module
var _ = ToolJS.export();
// increment 10 by 5.
var val = _.increment(10, 5);
console.log(val);
// => 15
var odd = _.isOdd(27);
console.log(odd);
// => true"
// gets the element whose id = "#myElement"
var el = _.getEl("#myElement");
// creates a p tag, sets its innerText, applies some style to it and appends it to the body element.
_.createEl("p", {
innerText: "Hello there! i was created using ToolJS",
appendTo: "body",
style: {
color: "red",
fontSize: "44px"
}
});
For ES6 Module's Import Style
var url = "https://unpkg.com/@redeakaa/[email protected]/dist/esm/tooljs.esm.js";
import ToolJS from url;
import { Utils, Obj } from url;
// sets a cookie which expires in 14 days
Utils.setCookie("username", "John Doe", 14, "/");
// gets the cookie named "username"
var user = Utils.getCookie("username",);
console.log(user);
// => "John Doe"
var myObj = Obj.toObj(["John Doe", "Male"]);
console.log(myObj);
// => { 0: "John Doe", 1: "Male" }
Check out the libraries official documentation page to see a list of all available methods for each module and how to create a module/plugin of your own.
Please feel free to make contributions to this project at any point in time. Find any bug, open an issue and we'll fix it together.
- Made with 💝 by Okoro Redemption.