lit-html

Efficient, Expressive, Extensible HTML templates in JavaScript

lit-html is the template system that powers the Lit library for building fast web components.

When using lit-html to develop web components, most users should import lit-html via the lit package rather than installing and importing from lit-html directly.

Documentation

Full documentation is available at lit.dev/docs/templates/overview/.

Overview

lit-html lets you write HTML templates in JavaScript with template literals.

lit-html templates are plain JavaScript and combine the familiarity of writing HTML with the power of JavaScript. lit-html takes care of efficiently rendering templates to DOM, including efficiently updating the DOM with new values.

1import {html, render} from 'lit-html';
2
3// This is a lit-html template function. It returns a lit-html template.
4const helloTemplate = (name) => html`<div>Hello ${name}!</div>`;
5
6// This renders <div>Hello Steve!</div> to the document body
7render(helloTemplate('Steve'), document.body);
8
9// This updates to <div>Hello Kevin!</div>, but only updates the ${name} part
10render(helloTemplate('Kevin'), document.body);

lit-html provides two main exports:

• html: A JavaScript template tag used to produce a TemplateResult, which is a container for a template, and the values that should populate the template.
• render(): A function that renders a TemplateResult to a DOM container, such as an element or shadow root.

Installation

1$ npm install lit-html

Or use from lit:

1$ npm install lit

Contributing

Please see CONTRIBUTING.md.