Compatibilidade
O ozi-ui foi projetado para funcionar em diferentes stacks, frameworks e ambientes — do PHP puro ao Laravel moderno, do Bootstrap ao Tailwind.
Dependências
A partir da v2.0, o ozi-ui não depende de nenhuma biblioteca de terceiros. O núcleo, os módulos, os componentes e os behaviors são JavaScript puro.
| Dependência |
Necessária? |
Observação |
| Nenhuma |
— |
O ozi-ui v2 funciona sozinho — basta um <script src> |
| jQuery |
❌ Opcional |
Só é necessário se você ativar os shims de compatibilidade com a v1 |
| Etapa de build |
❌ Opcional |
Distribuído como IIFE — Webpack, Vite e npm são dispensáveis |
Vindo da v1? O ozi-ui v1 era construído sobre jQuery 3.6+. Na v2 o jQuery deixou de ser
requisito e não é mais carregado no boot. Se o seu app dependia do jQuery que "vinha junto",
passe a incluí-lo por conta própria. Veja o guia de migração.
Frontend
| Framework |
Suporte |
Observação |
| Livewire 4 |
✅ Nativo |
Testado com v4.2.4 — adapter com dispatch nativo em wire:model |
| Livewire 3 |
✅ Nativo |
Hooks afterRender automáticos — integração completa |
| Alpine.js |
✅ Ótimo |
Consumo direto dos eventos via x-on:ozi:change="$event.detail" |
| Vue.js |
✅ Ótimo |
Plugins JS funcionam como utilitários externos |
| React |
✅ Bom |
Inicialize via useEffect após montagem do componente |
| Vanilla JS |
✅ Total |
Funciona sem nenhum framework |
Backend
Métodos de instalação
| Método |
Descrição |
| Composer |
Instalação via gerenciador de pacotes — composer require ozi-ui/core:^2.0 |
| Manual |
Copie os arquivos para o projeto e referencie via <script src="./plugins/ozi-ui/ozi.js"></script> |
| Framework |
Suporte |
Composer |
Manual |
Observação |
| Laravel 13 |
✅ Nativo |
✅ |
✅ |
Totalmente suportado |
| Laravel 12 |
✅ Nativo |
✅ |
✅ |
Totalmente suportado |
| Laravel 11 |
✅ Nativo |
✅ |
✅ |
Totalmente suportado |
| Laravel 10 |
✅ Nativo |
✅ |
✅ |
ServiceProvider, diretivas Blade e ozi:check |
| Laravel 9 |
✅ Compatível |
✅ |
✅ |
Funciona com ajuste mínimo no composer.json |
| Laravel 8 |
⚠️ Parcial |
❌ |
✅ |
Requer PHP 8.0+ e ajuste no ServiceProvider |
| Laravel 7 |
⚠️ Parcial |
❌ |
✅ |
Apenas os plugins JS — sem ServiceProvider |
| Laravel 5/6 |
⚠️ Parcial |
❌ |
✅ |
Sem ServiceProvider — apenas plugins JS via <script src> |
| PHP puro |
✅ Total |
❌ |
✅ |
Funciona em qualquer projeto PHP sem etapa de build |
| Symfony |
⚠️ Parcial |
❌ |
|
Plugins JS funcionam — ServiceProvider não disponível |
| WordPress |
⚠️ Parcial |
❌ |
✅ |
Plugins JS funcionam |
UI / CSS
O tema é dado, não código: variáveis CSS (--ozi-*) + um mapa de classes. O mesmo build JS serve qualquer tema — troca-se apenas oziConf({ theme }).
| Framework |
Suporte |
Observação |
| Bootstrap 5.x |
✅ Nativo |
Padrão recomendado |
| Bootstrap 4.x |
✅ Compatível |
Configure as classes via oziConf() |
| Tailwind CSS 4 |
✅ Nativo |
Tema completo na v2 — inclui overrides.css próprio |
| DaisyUI |
✅ Compatível |
Funciona sobre Tailwind — mesma configuração |
| CSS próprio |
✅ Total |
Tokens --ozi-* customizáveis via :root |
| Sem framework CSS |
✅ Total |
Visual próprio via tokens CSS |
Ambientes
O ozi-ui v2 é escrito em sintaxe ES5 (sem transpilação), mas usa APIs de navegador modernas — fetch, WeakMap, AbortController, Element.closest e Element.animate.
| Ambiente |
Suporte |
Observação |
| Navegadores modernos |
✅ Total |
Chrome, Firefox, Safari, Edge |
| Mobile browsers |
✅ Total |
iOS Safari, Android Chrome |
| Internet Explorer 11 |
❌ |
v2 requer fetch/WeakMap/AbortController — use a v1 (v1-final) se precisar de IE11 |
| Node.js (SSR) |
❌ |
Requer DOM — não funciona server-side |
Resumo
|
ozi-ui v2 |
| Dependências |
Nenhuma — JS puro |
| Requisito mínimo |
Navegador moderno (fetch, WeakMap) |
| Laravel recomendado |
10, 11, 12, 13 |
| PHP recomendado |
8.2+ |
| PHP puro |
✅ Total |
| Livewire |
3 e 4 ✅ |
| Frontend |
Livewire, Alpine, Vue, React, Vanilla |
| UI |
Bootstrap, Tailwind, DaisyUI, CSS próprio |
| Outros |
Symfony e WordPress ⚠️ parcial |
| Licença |
MIT — uso livre |