![hello, slim.js](./doc-site/src/assets/slim3.png) [![Build Status](https://semaphoreci.com/api/v1/eavichay/slim-js/branches/master/badge.svg)](https://semaphoreci.com/eavichay/slim-js) [Chat on gitter](https://gitter.im/slim-js/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link) # Hello slim.js - your declarative web components library ```javascript import { Slim } from 'slim-js'; import { tag, template } from 'slim-js/decorators'; @tag('my-awesome-element') @template(` {{this.count}} `) class extends Slim { count = 0; inc() { this.count++ } dec() { this.count-- } } ``` #### [Read the documentation](http://slimjs.com) Slim is an ultra fast, native and elegant library for [Web Components](https://www.webcomponents.org/introduction) development ## It's fast. Very fast. Super fast. It leverages the native browser's API to manipulate DOM using templates, with custom directives. Imagine vue or angular's strctured tempaltes combined with react's ease of use - combined, faster and lighter. ## What's the difference? Why slim.js? It's native. It has no black magic, no compilers and no external dependencies. It aims for fast performance, low CPU usage, using the native HTMLElement class inheritence and CustomElementsRegistry. It works anywhere. You can combine slim.js in any other framework, combine any framework into slim.js app or any other combination. You can write fully functional classes with complex code, or create pure "render-only" components without writing a single function. Opt-in/Opt-out anything. The core is super small _(2927 bytes gzipped)_, every directive is a self-contained module. Opt-in if you like. Pick your preferences for using (or not) shadow-dom. Work directly with properties on the element or create a view-model layer. It's super easy to learn. Anything in your template that is wrapped with bars (example: `

` ) is the actual code running. And it runs only when the used properties change. Changes affects only the specific DOM nodes that are bound. It means you can manipulate DOM manually without bothering the core, and vice-versa. No virtual dom engine or anything like that. ## What about bundling, typescript, or other tools? It just works. The library is written in javascript, and it has `index.d.ts` to support strongly-typed projects. It also provides access to it's internals, if you want to hack things out. ## What are "directives" anyway? Directives are middlewares that executes code on your template whenever you have attributes in your markup. For example, if you opt-in for the **property-directive**, any attribute that starts with a period (i.e. ``) will trigger the property-directive into action: `this.user` will project as a `user` property into `some-element`. Another example is the **foreach-directive**: You can map arrays or iterables to repeating elements. For example ```html

{{item.name}}

``` slim.js provides the following out-of-the-box directives: - custom-code (default)`` or `

Welcome, {{this.user.name}}!

` - property `` - events `` - if `

` - foreach `

` - reference `` will create a property targeting the DOM element - repeat (optional, faster, with lazy memory release) `

` All the directives (excluding custom-code) are **optional** - each is a standalone module. Choose the directives you use, or write your own! ## What about plugins? You can hook into any slim.js component's lifecycle using plugins. You plugin will be notified for step of the lifecycle, so you can add you own custom code or change things on-the-go. ## Isn't a runtime library slower than compiled libraries? Well, slim.js is an exception. Your custom code is memoized, and every piece of in-template code is created only once, can be even shared accross components. The core is very small and efficient, and releasing bound nodes is done progressively as background-tasks, keeping the user interface responsive as first priority. Modern browsers supports `requestIdleCallback`, so if supported, the removed elements will be released slowly and progressively. # Is this another framework? Yes, and No. It's a very thin, fast, and extensible core library for writing custom-elements, powered by optional plugins and directives. You have the power to decide. It adds the firepower of a framework to your web-components, using the browser's native capabilities — as defined by W3C standards. # Here's what you get: - HTML markup with custom inlined code. - Reactive components: If a property is in the template, it becomes reactive. The core wraps it with a getter and setter function (and keeping your original one intact, if exists). No need to declare, it's derived from the tempalte. - Data binding: data changes triggers changes in the rendered HTML. - Directive system: Register your own directives. - Plugins: Add global lifecycle hooks for every slim.js component. - It feels like a framework (in a good way), but without the limits of a classic framework. It works everywhere, you can pick your own framework. - Low-footprint: it's less than 3KB gzipped. Directives are optional. - Single file for core functionality, and you're good to go. - No dependencies, everything is based on native browsers' API. Choose your own tools. - (_Optional_) Decorators for ES7/Next syntax, via Babel included. - Works with mixins from other component libraries, such as Polymer, out of the box. ## Standards-compliant - ES6 - Web Components V1 - No transpiling or compilation required ## No Setup required. It just works. Use native (or bundlers) import statements, load from the CDN, or use the non-module (commonJS) file. # Documentation - [Developer's Guide](http://slimjs.com) The official website is built with Slim.js (with source maps). Check out the source code, see it for yourself. # Migration from older versions Version 3 introduced the plugins. Version 4 introduced the es modules. Version 5 has new engine, directive system and plugin system. ## es modules ```js import { Slim } from 'slim-js'; ``` ## IIFE (no-modules) ```html ``` Access a global `Slim` object. ## HTML + Modules ```html ``` ### Contibutors are welcome. _USE THE PLATFORM_ ## Would you like to spend some good money on a good library and support the project? Contact **eavichay@gmail.com**.

	Stars	Issues	Version	Updated	Created
@github/catalyst			1.6.0	2 years ago	3 years ago
@microsoft/fast-element	9,053	443	1.13.0	a month ago	4 years ago
@stencil/core	12,324	386	4.18.1	6 days ago	7 years ago
lit	17,667	496	3.1.3	a month ago	12 years ago
slim-js			5.0.10	3 years ago	7 years ago

@github/catalyst vs @microsoft/fast-element vs @stencil/core vs lit vs slim-js

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past