ki.js is a super-tiny jQuery-like API JavaScript library (480 bytes | 145 gzipped)
ki.js (recommended) version is supported by the following browsers: IE9 , Chrome 6 , Safari 5 , Firefox 6 , Opera 11.5 .
ki.ie8.js version is supported by all the previous browsers including IE8. (619 bytes | 181 gzipped) a The minified and gzip size numbers mentioned above where measured without the header comments
With bower
$ bower install ki
..or clone the repo
$ git clone https://github.com/dciccale/ki.js.git
In order to run the build task you'll need NodeJS and Grunt.js.
After installing NodeJS, install grunt-cli:
Install grunt-cli:
$ npm install -g grunt-cli
Now that you have NodeJS and Grunt installed, clone the project by running:
$ git clone git://github.com/dciccale/ki.js.git
Install local dependencies inside ki.js directory:
$ cd ki.js && npm install
Now you can run the default task that will generate a ki.min.js
file ready to use.
$ grunt
If you want IE8 support, generate ki.ie8.min.js
by running:
$ grunt ie
With ki.js you can do the basic stuff jQuery can, for example:
$(function () {
// this will be executed when the dom is ready!
alert('Hey the DOM is ready ;)');
});
This was just ki.js, no jQuery
Use any CSS selector that exists to get elements from the DOM.
$('p:nth-last-of-type(2)');
$('[attribute|=value]');
$('p:not(.note)');
$('p:empty');
See a list of all CSS selectors
Yes, events with the known .on()
and .off()
methods
<button>ki.js</button>
$(function () {
// ok now that the dom is ready i would like to add some events
var alertMyName = function () {
alert('My name is ' this.textContent); // will allert 'ki.js'
};
$('button').on('click', alertMyName);
// to turn it off just use .off()
//$('button').off('click', alertMyName);
});
You can add any JavaScript event even touch events for mobile, under the hood ki.js uses addEventListener, so feel free to use any valid DOM event.
The each()
method is also included in the core of ki.js for easy iteration on a DOM collection.
$(function () {
// get all p tags
$('p').each(function (elem, i) {
// change color to red
elem.style.color = 'red';
// append the index to the text
elem.textContent = i;
});
});
All ki.js methods are chainable, just like jQuery.
Yeah, you can write plugins for ki.js if you want, fork the project, keep them super super xxs and I promise to merge them into the official repo.
Check out a lot of already made extensions for ki.js here: ki.extend.js (thanks to james2doyle)
Just add your methods to the prototype of ki.js and you're done.
For example, let's add a text()
method for setting or getting the text of an element, in the tiniest way I can think of:
// minified is 106 bytes
$.prototype.text = function (a) {
return a === a '' ? this.each(function (b) {
b.textContent = a
}) : this[0].textContent
};
Now use the plugin just like the other methods:
$(function () {
// <p>hello</p>
// get the text from the p tag
console.log($('p').text()); // hello
// set another text
$('p').text('bye'); // bye
});
Create your own plugin and let's make the tiniest JavaScript Library ever! Remember to write byte-saving code, see this [useful resource for JavaScript byte-saving techniques](https://github.com/jed/140bytes/wiki/Byte-saving-techniques) written by 140byt.es community
In every cool and modern browser.
The code of ki.js was written for byte-saving, so I don't recommend using this script for a real application or website. It was done for fun, and the funniest part is that it actually works :)
See LICENSE.txt