Open source

facil.js

Uma caixa de ferramentas leve para o front-end.

Biblioteca JavaScript leve que reúne manipulação do DOM, requisições HTTP, validação de formulários, reatividade e roteador SPA.

Sobre o projeto

O que é o facil.js

O facil.js é uma biblioteca JavaScript leve, pensada para quem desenvolve para a web. Ela reduz o código repetitivo das tarefas do dia a dia: mexer no DOM, gerenciar estado, rotear páginas, validar formulários e cuidar das interações da interface.

Tudo fica no objeto Facil, com métodos encadeáveis em uma sintaxe parecida com a do jQuery. Para usar, basta importar o arquivo minificado (dist/facil.min.js) no projeto.

Recursos

O que o facil.js faz

DOM encadeável

Selecione elementos e altere HTML, classes, CSS e eventos com métodos encadeados, em uma sintaxe parecida com a do jQuery.

Reatividade

Vinculação de dados bidirecional (f-model e f-text) com Proxies: mudou o estado, o DOM atualiza na hora.

Cliente HTTP

Um wrapper sobre o fetch (get, post e request) com indicador de carregamento automático.

Validação de formulários

Regras declaradas em texto, como "required|min:3", que devolvem se o formulário é válido, os erros e os dados.

Roteador SPA

Roteamento no cliente com templates HTML, busca dinâmica por templateUrl e uma rota para o 404.

Utilitários de interface

Skeleton loading, barra de progresso global, event bus (Pub/Sub) e modo escuro com persistência.

FAQ

Perguntas frequentes

Como instalo?

O README não pede gerenciador de pacotes: importe o build minificado no projeto, com import { Facil } from './dist/facil.min.js'.

Como funciona o modo escuro?

Facil.darkMode.init() usa a preferência do sistema ou o que estiver salvo no localStorage, e toggle() alterna entre os temas.

Quais regras de validação existem?

required, email, min:n, max:n, number, url e match:campo, combinadas com o caractere |.

Qual é a licença?

MIT.

Onde está o código?

No GitHub, em rodrigocborges/facil.js, com as pastas src, dist e example.

Continue explorando

Veja também

Todos os projetos