Mirror of https://github.com/Polymer/lit-html
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
6 days ago | |
---|---|---|
.github | 3 months ago | |
.vscode | 2 years ago | |
demo/clock | 2 years ago | |
docs | 6 days ago | |
src | 5 months ago | |
test | 6 months ago | |
.clang-format | 3 years ago | |
.editorconfig | 3 years ago | |
.eslintignore | 1 year ago | |
.eslintrc.json | 1 year ago | |
.gitignore | 10 months ago | |
.npmignore | 3 years ago | |
.travis.yml | 11 months ago | |
CHANGELOG.md | 5 months ago | |
CODE_OF_CONDUCT.md | 1 year ago | |
CONTRIBUTING.md | 1 year ago | |
LICENSE | 3 years ago | |
README.md | 6 months ago | |
check-version-tracker.cjs | 6 months ago | |
package-lock.json | 5 months ago | |
package.json | 5 months ago | |
rollup.config.js | 11 months ago | |
travis-bench.sh | 1 year ago | |
tsconfig.json | 1 year ago | |
tslint.json | 1 year ago | |
wct.conf.json | 11 months ago |
README.md
lit-html
Efficient, Expressive, Extensible HTML templates in JavaScript
Documentation
Full documentation is available at lit-html.polymer-project.org.
Docs source is in the docs
folder. To build the site yourself, 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 aTemplateResult
, which is a container for a template, and the values that should populate the template.render()
: A function that renders aTemplateResult
to a DOM container, such as an element or shadow root.
Installation
$ npm install lit-html
Contributing
Please see CONTRIBUTING.md.