# balalaika
> A tiny DOM library
Latest version **1.0.1** (published 2016-09-14) · MIT license · 0 weekly downloads
> **Deprecated.** This package is deprecated.
## Install
```sh
npm install balalaika
pnpm add balalaika
yarn add balalaika
bun add balalaika
```
## Health
**Score 10/100 (F)** — status: deprecated.
Negative: deprecated.
## Facts
| | |
|---|---|
| Version | 1.0.1 |
| Published | 2016-09-14 |
| First published | 2015-12-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 288 |
| Author | Andrey Gubanov |
| Maintainers | finom |
| Keywords | jquery, dom, vanillajs, balalaika |
## Links
- npm: https://www.npmjs.com/package/balalaika
- Repository: https://github.com/finom/balalaika
- Homepage: https://github.com/finom/balalaika#readme
- Issues: https://github.com/finom/balalaika/issues
- npm.io page: https://npm.io/package/balalaika
## Alternatives
- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads
## Recent versions
- 1.0.1 (latest) — 2016-09-14
- 1.0.0 — 2015-12-02
## README
Balalaika.js
=========
[](https://gitter.im/finom/balalaika?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## The tiny DOM library (986 bytes uncompressed and 603 bytes gzipped!)
Balalaika provides you tiny replacement for huge DOM libraries such as jQuery and Zepto. It contains few methods which should be sufficient for vanilla.js developers.
Too big? [Check this out](https://github.com/finom/bala).
### How can I use it?
First of all you can use it as common library on the web page. Just paste this code to the ``head`` tag:
```html
```
(Looks like Google Analytics embed)
Then use it anywhere on the web page:
```html
```
The second kind of use is using it inside single script as local variable:
```js
(function(win, $) {
// your code starts here
$(function() {
$('.my-selector').on('click', function() {
alert('I need my balalaika');
});
});
// your code ends here
})(window, function(t,e,n,i,o,r,s,u,c,f,l,h){return h=function(t,e){return new h.i(t,e)},h.i=function(i,o){n.push.apply(this,i?i.nodeType||i==t?[i]:""+i===i?/
Besides, Balalaika has few additional methods such as:
#### ``on``
```js
$('.my-selector').on('click.namespace', function() {
alert('I need my balalaika');
});
```
#### ``off``
```js
$('.my-selector').off('click.namespace');
```
#### ``is``
```js
$('.my-selector').on('click', function(evt) {
if($(evt.target).is('.another-selector')) {
alert('I need my balalaika');
}
});
```
#### ``extend``
```js
var myObject = {a:1};
$.extend(myObject,{
b: 2
});
```
#### DOM-ready feature
```js
$(function() {
// Do something with DOM
});
```
### It provides very few functions, doesn't it?
Yep. The idea is if you need something, implement it! A lot of jQuery-like functions can be created easily. Use $.fn style to create additional methods:
```js
$.fn.hasClass = function( className ) {
return !!this[ 0 ] && this[ 0 ].classList.contains( className );
};
```
```js
$.fn.addClass = function( className ) {
this.forEach( function( item ) {
var classList = item.classList;
classList.add.apply( classList, className.split( /\s/ ) );
});
return this;
};
```
```js
$.fn.removeClass = function( className ) {
this.forEach( function( item ) {
var classList = item.classList;
classList.remove.apply( classList, className.split( /\s/ ) );
});
return this;
};
```
```js
$.fn.toggleClass = function( className, b ) {
this.forEach( function( item ) {
var classList = item.classList;
if( typeof b !== 'boolean' ) {
b = !classList.contains( className );
}
classList[ b ? 'add' : 'remove' ].apply( classList, className.split( /\s/ ) );
});
return this;
};
```
And so on...
### More examples
#### Find elements inside another element
```js
var elements = $('.my-selector', el);
```
#### Parse HTML
```js
var elements = $('
');
```
#### Extended parsing function
Pay attention that example above doesn't parse contextual elements such as ``td``, ``tr``, etc. But function below does:
```js
$.parseHTML = function( html ) {
var node = document.createElement( 'div' ),
// wrapMap is taken from jQuery
wrapMap = {
option: [ 1, "" ],
legend: [ 1, "" ],
thead: [ 1, "