Lit is a simple library for building fast, lightweight web components.

At Lit's core is a boilerplate-killing component base class that provides reactive state, scoped styles, and a declarative template system that's tiny, fast and expressive.

Documentation

See the full documentation for Lit at lit.dev

Overview

Lit provides developers with just the right tools to build fast web components:

• A fast declarative HTML template system
• Reactive property declarations
• A customizable reactive update lifecycle
• Easy to use scoped CSS styling

Lit builds on top of standard web components, and makes them easier to write:

1import {LitElement, html, css} from 'lit';
2import {customElement, property} from 'lit/decorators.js';
3
4// Registers the element
5@customElement('my-element')
6export class MyElement extends LitElement {
7  // Styles are applied to the shadow root and scoped to this element
8  static styles = css`
9    span {
10      color: green;
11    }
12  `;
13
14  // Creates a reactive property that triggers rendering
15  @property()
16  mood = 'great';
17
18  // Render the component's DOM by returning a Lit template
19  render() {
20    return html`Web Components are <span>${this.mood}</span>!`;
21  }
22}

Once you've defined your component, you can use it anywhere you use HTML:

1<my-element mood="awesome"></my-element>

Contributing

Please see CONTRIBUTING.md.