Skip to content
forked from lit/lit

An efficient, expressive, extensible HTML templating library for JavaScript.

License

Notifications You must be signed in to change notification settings

aweary/lit-html

This branch is 2119 commits behind lit/lit:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

713e6a2 · Jan 3, 2019
Jan 3, 2019
May 4, 2018
Nov 27, 2018
Dec 20, 2018
Jan 2, 2019
Nov 30, 2018
Jun 26, 2018
Aug 31, 2017
Aug 27, 2017
Dec 18, 2018
Jul 8, 2017
Sep 13, 2018
Dec 13, 2018
Jan 2, 2019
Jan 2, 2019
Sep 1, 2017
Dec 18, 2018
Aug 12, 2017
Dec 18, 2018
Dec 18, 2018
Sep 4, 2018
Oct 23, 2018
Jan 2, 2019
Jan 14, 2018

🛠 Status: In Development

lit-html is currently in development. It's on the fast track to a 1.0 release, so we encourage you to use it and give us your feedback, but there are things that haven't been finalized yet and you can expect some changes.

lit-html

Efficient, Expressive, Extensible HTML templates in JavaScript

Build Status Published on npm Mentioned in Awesome lit-html

Documentation

Full documentation is available at lit-html.polymer-project.org.

Docs source is in the docs folder. To build the site youself, see the instructions in docs/README.md.

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.

import {html, render} from 'lit-html';

// This is a lit-html template function. It returns a lit-html template.
const helloTemplate = (name) => html`<div>Hello ${name}!</div>`;

// This renders <div>Hello Steve!</div> to the document body
render(helloTemplate('Steve'), document.body);

// This updates to <div>Hello Kevin!</div>, but only updates the ${name} part
render(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

$ npm install lit-html

Status

lit-html is under active development and has not yet had a 1.0 release. The internal API may still change somewhat. The html and render API is stable.

Contributing

Please see CONTRIBUTING.md.

About

An efficient, expressive, extensible HTML templating library for JavaScript.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 97.8%
  • HTML 1.9%
  • JavaScript 0.3%