lit

Simples. Rápido. Componentes da Web.

Lit é uma biblioteca simples para construir componentes web rápidos e leves.

No núcleo do Lit está uma classe base de componente padrão que fornece estado reativo, estilos com escopo e um sistema de modelo declarativo que é pequeno, rápido e expressivo.

Documentação

Consulte a documentação completa do Lit em lit.dev.

Documentação adicional para desenvolvedores que desejam contribuir ou entender mais sobre o projeto pode ser encontrada em dev-docs .

npm

Para instalar a partir do npm:

npm i lit

Monorepo iluminado

Este é o monorepo para pacotes Lit.

A fonte lit 2.x está disponível na ramificação 2.x A fonte lit-html 1.x está disponível no branch lit-html-1.x .

Pacotes

• Pacotes principais
  • lit - O principal pacote do Lit voltado para o usuário, que inclui tudo, desde lit-html e lit-element.
  • lit-element - A classe base do componente da web usada no Lit.
  • lit-html - A biblioteca de renderização usada pelo LitElement.
  • @lit/reactive-element - Uma classe base de baixo nível que fornece um ciclo de vida reativo baseado em alterações de atributos/propriedades.
• Bibliotecas adicionais
  • @lit/localize - Uma biblioteca e ferramenta de linha de comando para localizar aplicativos da web criados com Lit.
  • @lit/localize-tools - Ferramentas de localização para uso com @lit/localize .
  • @lit/react - Um wrapper de componente React para componentes da web.
  • @lit/task - Um controlador para Lit que renderiza tarefas assíncronas.
  • @lit/context - Um sistema para passar dados através de uma árvore de elementos usando eventos do navegador, evitando a necessidade de passar propriedades para cada camada da árvore usando um protocolo definido pela comunidade.
• Laboratórios
  • @lit-labs/ssr - Um pacote de servidor para renderizar modelos e componentes do Lit no servidor.
  • @lit-labs/ssr-client - Um conjunto de módulos de suporte do lado do cliente para renderizar componentes e modelos do Lit no servidor usando @lit-labs/ssr .
  • @lit-labs/eleventy-plugin-lit - Um plugin para Eleventy que pré-renderiza componentes Lit usando @lit-labs/ssr com hidratação opcional.
  • @lit-labs/ssr-react - Um pacote para integração do Lit SSR com estruturas React e React.
  • @lit-labs/nextjs - Um plug-in para Next.js que permite a renderização profunda de componentes do Lit no servidor com Lit SSR.
  • @lit-labs/router - Um roteador para Lit.
  • @lit-labs/motion - Diretivas do Lit para fazer as coisas se moverem
  • @lit-labs/scoped-registry-mixin - Um mixin para LitElement que se integra ao polyfill especulativo Scoped CustomElementRegistry.
  • @lit-labs/observers - Um conjunto de controladores reativos que facilitam o uso dos objetos observadores da plataforma.
  • @lit-labs/preact-signals - Integração Preact Signals para Lit.
  • @lit-labs/testing - Utilitários para testar componentes do Lit.
  • @lit-labs/virtualizer - Virtualização baseada em viewport (incluindo rolagem virtual).
  • @lit-labs/compiler - Um compilador para otimizar modelos do Lit.
• Kits iniciais (não publicados no npm)
  • lit-starter-ts (repositório de modelo) - Um repositório inicial para construir componentes reutilizáveis ​​usando Lit em TypeScript.
  • lit-starter-js (repositório de modelos) - Um repositório inicial para construir componentes reutilizáveis ​​usando Lit em JavaScript.
• Pacotes internos (não publicados no npm)
  • tests - Infraestrutura de teste para o monorepo.
  • benchmarks - Benchmarks para testar várias bibliotecas no monorepo.
  • @lit-internal/scripts - Scripts utilitários usados ​​no monorepo.

Contribuindo para a Literatura

Lit é de código aberto e apreciamos relatórios de problemas e solicitações pull. Consulte CONTRIBUTING.md para obter mais informações.

Configurando o monorepo iluminado para desenvolvimento

Inicialize o repositório:

git clone https://github.com/lit/lit.git
cd lit
npm ci

Construa todos os pacotes:

npm run build

Teste todos os pacotes:

npm run test

Execute benchmarks para todos os pacotes:

npm run benchmarks

Consulte os READMEs de pacotes individuais para obter detalhes sobre o desenvolvimento de um pacote específico.