Skip to content

Latest commit

 

History

History
177 lines (126 loc) · 4.46 KB

README.md

File metadata and controls

177 lines (126 loc) · 4.46 KB
Raw

ki.js

ki.js is a super-tiny jQuery-like API JavaScript library (480 bytes | 145 gzipped)

Browser support

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

Installation

With bower

$ bower install ki

..or clone the repo

$ git clone https://github.com/dciccale/ki.js.git

Build

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

What can I do with ki.js?

With ki.js you can do the basic stuff jQuery can, for example:

DOM Ready?

$(function () {
  // this will be executed when the dom is ready!
  alert('Hey the DOM is ready ;)');
});

This was just ki.js, no jQuery

CSS Selectors

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

Events

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.

.each()

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;
  });
});

Keep the chain!

All ki.js methods are chainable, just like jQuery.

Plugins?

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.

ki.extend

Check out a lot of already made extensions for ki.js here: ki.extend.js (thanks to james2doyle)

How to make plugins?

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

Where can I use ki.js?

In every cool and modern browser.

The Code

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 :)

License

See LICENSE.txt