Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/franciscop/umbrella
:umbrella: Lightweight javascript library for DOM manipulation and events
https://github.com/franciscop/umbrella
Last synced: 29 days ago
JSON representation
:umbrella: Lightweight javascript library for DOM manipulation and events
- Host: GitHub
- URL: https://github.com/franciscop/umbrella
- Owner: franciscop
- License: mit
- Created: 2014-10-21T19:19:27.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T01:11:04.000Z (6 months ago)
- Last Synced: 2024-10-01T22:03:47.045Z (about 1 month ago)
- Language: JavaScript
- Homepage: https://umbrellajs.com/
- Size: 1.81 MB
- Stars: 2,288
- Watchers: 39
- Forks: 110
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: Contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-tiny-js - umbrella - jQuery-style DOM manipulation library, <img align="top" height="24" src="./img/umbrellajs.svg"> (UI Frameworks)
- jimsghstars - franciscop/umbrella - :umbrella: Lightweight javascript library for DOM manipulation and events (JavaScript)
README
# Umbrella JS [![test badge](https://github.com/franciscop/umbrella/workflows/tests/badge.svg)](https://github.com/franciscop/umbrella/actions) [![stats](https://data.jsdelivr.com/v1/package/npm/umbrellajs/badge?style=rounded)](https://www.jsdelivr.com/package/npm/umbrellajs) [![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/franciscop/umbrella/blob/master/LICENSE)
> [**Library Documentation**](http://umbrellajs.com/documentation) | [**Migrating from jQuery guide**](https://github.com/franciscop/umbrella/blob/master/jquery.md)
Covers your javascript needs for those rainy days. A <3kb performant jQuery-like library born from the question: [You might not need jQuery](http://youmightnotneedjquery.com/), then what do you need?
You probably need awesome CSS (like [Picnic CSS](http://picnicss.com/)) and a lightweight, modern and performant javascript library. This does:
- DOM traversal (selector, filter, find, each, etc.)
- DOM editing (classes & attributes, html, before, etc.)
- Event handlingA couple of simple examples:
```js
// Simple events like jQuery
u("button").on('click', e => {
alert("Hello world");
});// Handle form submissions
u('form.login').handle('submit', async e => {
const user = await fetch('/login', {
method: 'POST', body: new FormData(e.target)
}).then(res => res.json());
window.href = '/user/' + user.id;
});
```## Getting started
There are few ways to use Umbrella JS:
### Play with it
Instead of installing it, you can just play with it in JSFiddle:
[**Try on JSFiddle**](https://jsfiddle.net/franciscop/mwpcqddj/)
### Use a CDN
jsdelivr.com is an awesome OSS service that hosts many open source projects so you don't need to even download the code:
```js
```
### Install with `npm`
Using npm is a front-end package manager that makes it super-easy to add a new package:
```
npm install umbrellajs
```### Module support
If you use a front-end module bundler like Webpack or Browserify, `u` is exposed as CommonJS exports. You can pull them in like so:
```js
// ES Modules/Webpack/etc
import u from 'umbrellajs';// Commonjs
var u = require('umbrellajs');
```### ES Module support
If you use an ES Module, `u` and `ajax` are exposed as ES Module exports.
You can pull them in like so:```
import u from 'umbrellajs/umbrella.esm.js'
```### Download it
If you like it or prefer to try it locally, just download `umbrella.min.js`:
[**Download Umbrella JS**](https://raw.githubusercontent.com/franciscop/umbrella/master/umbrella.min.js)
Add it to your project:
```html
```
## Support: IE11+
Current usage for IE 10- is under 1% for each version (8, 9, 10) so it's not Umbrella's mission to support this. However, those extra seconds gained from loading faster on mobile might be even bigger than that percentage. You should probably test it.
Known, wontfix IE10- bugs:
- [Invalid target element for this operation](http://caniuse.com/#feat=insertadjacenthtml) when trying to use any of these methods on **table**, **tbody**, **thead** or **tr**. Check [the issue on StackOverflow](http://stackoverflow.com/q/8771498/938236). For those elements, this gives an error:
- `.before()`
- `.after()`
- `.append()`
- `.prepend()`- [Unable to get property ____ of undefined or null reference](http://caniuse.com/#search=classList) since classList is not supported by IE9-. Just use `polyfill.js` and they will work. Affects:
- `.addClass()`
- `.removeClass()`
- `.hasClass()`
- `.toggleClass()`- Choosing multiple options within `` doesn't work with IE10- when using `.serialize()` (and thus `.ajax()`). No idea why, but it's a really corner case. Affects:
- `.ajax()`
- `.serialize()`## Alternatives
- [jQuery](https://jquery.com/)
- [Zepto](http://zeptojs.com/)
- [Bliss](http://blissfuljs.com/)
- [NodeList](https://github.com/eorroe/NodeList.js)
- [Micro Framework (many)](http://microjs.com/)
## Author and License
Created and maintained by [Francisco Presencia](https://github.com/franciscop) under the MIT license.
## References
- https://www.bennadel.com/blog/4184-replacing-jquery-110kb-with-umbrella-js-8kb.htm
- http://www.tutsplanet.com/umbrella-js-alternative-jquery-288/
- http://www.hongkiat.com/blog/umbrella-js/
- http://www.catswhocode.com/blog/umbrella-js-a-tiny-yet-powerful-alternative-to-jquery
- https://webmaster.kitchen/jquery-kutuphanesine-alternatif-umbrellajs-kimdir/
- https://wmaraci.com/blog/umbrellajs-jquery-alternatifiniz-olmaya-aday-533
- http://qiita.com/kt3k/items/0da4c0b36c402b96122b
- https://whatpixel.com/umbrella-js-library/
- https://gomakethings.com/umbrella-js/
- https://medium.com/@rintoug/umbrella-js-is-your-alternative-to-jquery-c73fab99061
- https://lean.codecomputerlove.com/keeping-your-code-dry-with-umbrellajs/