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

dongyu/lit-html

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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

47a8af4 · Jul 9, 2019
Feb 9, 2019
May 4, 2018
Nov 27, 2018
Jun 24, 2019
Jul 9, 2019
Jun 12, 2019
Jun 26, 2018
Aug 31, 2017
Aug 27, 2017
Dec 18, 2018
Jul 8, 2017
May 21, 2019
Jul 9, 2019
May 3, 2019
May 3, 2019
Sep 1, 2017
Feb 21, 2019
Aug 12, 2017
Jul 9, 2019
Jul 9, 2019
Jul 9, 2019
Apr 5, 2019
Jun 6, 2019
Jan 18, 2019
Mar 2, 2019
Jan 14, 2018

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

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 96.4%
  • HTML 2.2%
  • Other 1.4%