ui-optago 1.1.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -1
- package/favicon.ico +0 -0
- package/index.html +1414 -0
- package/llms.txt +192 -0
- package/package.json +4 -2
- package/ui-optago.css +52 -29
- package/ui-optago.js +31 -3
package/llms.txt
ADDED
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
# UI Óptago
|
|
2
|
+
|
|
3
|
+
> Design system em CSS puro + JavaScript vanilla (sem build, sem dependências de framework) da Óptago. Todas as classes usam o prefixo `op-`, estados usam `is-` (`is-open`, `is-active`, `is-error`...), e a maior parte dos comportamentos interativos liga sozinha via atributos `data-op-*`, sem precisar escrever JS. API global em `window.OptagoUI`. Versão atual: `1.2.0`.
|
|
4
|
+
|
|
5
|
+
Este arquivo é a referência otimizada para agentes de IA/LLMs que forem gerar HTML usando esta biblioteca. Para a documentação em prosa (humanos), veja [README.md](README.md). Para ver todos os componentes renderizados com exemplo de código, veja [index.html](index.html) (showcase).
|
|
6
|
+
|
|
7
|
+
## Instalação (escolha uma)
|
|
8
|
+
|
|
9
|
+
CDN, versão fixa (recomendado em produção, sem definir versão especifica ele estará sempre na versão mais atual da biblioteca):
|
|
10
|
+
|
|
11
|
+
```html
|
|
12
|
+
<link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.0/ui-optago.css">
|
|
13
|
+
<script src="https://unpkg.com/ui-optago@1.2.0/ui-optago.js"></script>
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
npm:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install ui-optago
|
|
20
|
+
```
|
|
21
|
+
```html
|
|
22
|
+
<link rel="stylesheet" href="node_modules/ui-optago/ui-optago.css">
|
|
23
|
+
<script src="node_modules/ui-optago/ui-optago.js"></script>
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Arquivos locais: copie `ui-optago.css` e `ui-optago.js` para o projeto e sirva localmente.
|
|
27
|
+
|
|
28
|
+
## Regras que um agente NÃO pode quebrar
|
|
29
|
+
|
|
30
|
+
1. **Sempre incluir os dois arquivos juntos**: `ui-optago.css` E `ui-optago.js`. O JS não é opcional: ele aplica o tema salvo, injeta fontes/ícones e liga todos os `data-op-*`. Sem ele, os componentes ficam sem interatividade e sem tema.
|
|
31
|
+
2. **NUNCA usar `defer` ou `async` no `<script>` do `ui-optago.js`, nem movê-lo pro fim do `<body>`.** Ele precisa rodar antes do primeiro paint pra aplicar a classe `light`/tema no `<html>` e evitar flash de tema errado (FOUC). Carregue no `<head>`, na ordem: `<link>` do CSS primeiro, depois `<script>` do JS.
|
|
32
|
+
3. **Todo elemento raiz da página precisa da estrutura de app shell** (`body.op-app` > `.op-app-body` + `aside.op-sidebar`) se for usar header/sidebar fixos; ver seção "Layout" abaixo. Componentes isolados (um card, um modal, um formulário) NÃO precisam do app shell, funcionam soltos em qualquer página.
|
|
33
|
+
4. **A sidebar (`.op-sidebar`) fica à DIREITA da tela**, não à esquerda. É fixa, colapsa para só ícones no desktop (clique em `[data-op-sidebar-toggle]`) e vira drawer no mobile (`[data-op-sidebar-mobile]`). Por padrão ela inicia **colapsada** (só ícones); o estado escolhido pelo usuário fica salvo em `localStorage`.
|
|
34
|
+
5. **Não hardcode cores em `style=""` nos componentes.** Use as classes de variante (`op-btn-danger`, `op-alert-warning`...) ou, se precisar de cor customizada, sobrescreva os tokens `--op-*` (ver seção Tokens). Isso garante que o componente continue correto nos dois temas.
|
|
35
|
+
6. **`op-btn-primary` e `op-btn-secondary` têm cor FIXA, igual nos dois temas** (não seguem a variável `--op-primary`, que muda por tema e é usada só internamente por outros componentes como checkbox/switch/paginação). Primário = sempre verde-lima `#C0FF6B` com texto preto. Secundário = sempre cinza-chumbo `#656565` com texto branco. Não tente "corrigir" isso pra usar `var(--op-primary)`, é proposital.
|
|
36
|
+
7. **Tema claro/escuro é controlado só pela classe `light` no `<html>`**, aplicada automaticamente pelo JS (lê cookie/`localStorage`, senão `prefers-color-scheme`). Não escreva lógica própria de tema; use `OptagoUI.setTheme('light'|'dark')` se precisar forçar via JS.
|
|
37
|
+
10. **Tema compartilhado entre subdomínios**: adicione `data-op-theme-domain` no `<script>` da lib (ex.: `<script src="ui-optago.js" data-op-theme-domain=".seusite.com"></script>`) e o tema passa a ser salvo num cookie com esse `Domain`, em vez de só `localStorage`. Assim, `app1.seusite.com` e `app2.seusite.com` compartilham a mesma escolha de tema automaticamente. Sem esse atributo, o comportamento continua sendo só `localStorage` (por app, isolado). O valor precisa começar com `.` e ser um domínio de verdade que a página atual pertence (não use domínios de terceiros).
|
|
38
|
+
8. **Ícones**: a lib usa Phosphor Icons (`<i class="ph ph-nome-do-icone"></i>`), injetado automaticamente via CDN pelo JS. Não precisa adicionar `<link>`/`<script>` do Phosphor manualmente.
|
|
39
|
+
9. **Fontes**: Chakra Petch (títulos, `--op-font-display`), Inter (corpo, `--op-font-sans`), JetBrains Mono (mono/labels/botões, `--op-font-mono`), injetadas automaticamente via Google Fonts pelo JS.
|
|
40
|
+
|
|
41
|
+
## Layout obrigatório (app shell)
|
|
42
|
+
|
|
43
|
+
Use isto quando a página precisar de header + sidebar fixos (painel administrativo, dashboard, showcase):
|
|
44
|
+
|
|
45
|
+
```html
|
|
46
|
+
<body class="op-app">
|
|
47
|
+
<div class="op-app-body">
|
|
48
|
+
<header class="op-header">...</header>
|
|
49
|
+
<main class="op-main">CONTEÚDO ROLÁVEL AQUI</main>
|
|
50
|
+
<footer class="op-footer">...</footer>
|
|
51
|
+
</div>
|
|
52
|
+
<aside class="op-sidebar">
|
|
53
|
+
<div class="op-sidebar-header">...<button data-op-sidebar-toggle><i class="ph ph-sidebar-simple"></i></button></div>
|
|
54
|
+
<nav class="op-sidebar-nav">
|
|
55
|
+
<a class="op-nav-item" href="#secao">
|
|
56
|
+
<i class="ph ph-palette"></i>
|
|
57
|
+
<span class="op-nav-text">Título</span>
|
|
58
|
+
<span class="op-nav-tooltip">Título</span>
|
|
59
|
+
</a>
|
|
60
|
+
</nav>
|
|
61
|
+
</aside>
|
|
62
|
+
</body>
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Só `.op-main` rola (scroll interno). Header, footer e sidebar são fixos. `.op-nav-item.is-active` marca o item ativo (pílula preenchida com a cor de marca, igual nos dois temas).
|
|
66
|
+
|
|
67
|
+
## Catálogo de componentes (classes `op-*`)
|
|
68
|
+
|
|
69
|
+
| Grupo | Classes |
|
|
70
|
+
|---|---|
|
|
71
|
+
| Botões | `op-btn` + `op-btn-primary` (verde-lima fixo) / `op-btn-secondary` (cinza-chumbo fixo) / `op-btn-success` / `op-btn-danger` / `op-btn-warning` / `op-btn-info` / `op-btn-cyan`; ghosts: `op-btn-ghost`, `op-btn-ghost-info/success/danger/warning/cyan`; tamanhos `op-btn-sm`/`op-btn-lg`; `op-btn-icon` (só ícone); `op-btn-group` (agrupa vários `.op-btn` colados); estado `is-loading`; `disabled` ou `is-disabled` |
|
|
72
|
+
| Badges | `op-badge` + `op-badge-brand/info/success/warning/danger/cyan`, `op-badge-pill` (arredondado total), `op-dot` (bolinha de status, some com `op-dot-pulse` pra pulsar) |
|
|
73
|
+
| Alertas | `op-alert` + `op-alert-info/success/warning/danger`; filhos: `op-alert-title`, `op-alert-text`, `op-alert-close` (com `data-op-dismiss`) |
|
|
74
|
+
| Formulários | `op-field` (wrapper), `op-label` (+ `<span class="req">` pro asterisco obrigatório), `op-input`/`op-select`/`op-textarea`, `op-help` (+ `is-error`/`is-success`), `op-check` (checkbox/radio customizado), `op-switch` (toggle), `op-range` (slider), `op-input-icon` (input com ícone à esquerda), `op-input-group` + `op-input-addon` (prefixo/sufixo), `[data-op-reveal]` + `op-reveal-btn` (mostrar/ocultar senha), `op-combobox` (input com busca/filtro de opções, ver seção própria abaixo); estados `is-error`/`is-success` nos inputs; tamanhos `op-input-xs`/`op-input-sm`/`op-input-lg` em `op-input`, `op-select` e `op-textarea` (sem modificador = tamanho normal, o padrão) |
|
|
75
|
+
| Tabelas | `op-table` (+ `op-table-hover`, `op-table-striped`) para tabela HTML simples; `OptagoUI.tabulator()` para tabela avançada (ordenação/paginação) com tema Óptago aplicado |
|
|
76
|
+
| Cards | `op-card`, `op-card-hover` (efeito hover), `op-card-title`, `op-card-text`, `op-stat` (cartão de KPI/métrica) |
|
|
77
|
+
| Feedback | `op-progress` + `op-progress-bar` (+ `is-info/success/warning/danger`), `op-spinner` (+ `op-spinner-sm/lg`, `op-spinner-dots`), `op-skeleton` (+ `-thumb`/`-title`/`-btn`/`-badge`/`-row`), toasts (via JS, não classe direta) |
|
|
78
|
+
| Navegação | `op-tabs` (sublinhado) / `op-tabs-pills` (pílulas) / `op-tabs-vertical` + `op-tabs-col` (vertical, tipo settings-page); todas usam `.op-tab` + `.op-tab.is-active` (pílula preenchida com cor de marca) e `.op-tab-panel.is-active`; `op-accordion` (usa `<details>` nativo); `op-breadcrumb`; `op-pagination` + `op-page.is-active`; `op-dropdown` + `op-menu` (abre alinhado à esquerda do gatilho por padrão; use `op-menu-end` se precisar abrir alinhado à direita) |
|
|
79
|
+
| Overlays | `op-modal` (+ `op-modal-drawer` lateral, `op-modal-centered` sem header, `op-modal-sm`/`op-modal-lg`); tooltip 100% CSS via atributo `data-op-tip="texto"` (+ variante `op-tip-bottom`) |
|
|
80
|
+
| Tela de carregamento | `OptagoUI.showLoading('mensagem')` / `OptagoUI.hideLoading()`, ou `data-op-loading-form` no `<form>` pra acionar sozinho no submit; overlay full-screen com blur, criado e destruído automaticamente pelo JS |
|
|
81
|
+
| Extras | `op-timeline` (marcadores octogonais; some `op-timeline-horizontal` junto pra virar linha do tempo horizontal, itens em coluna), `op-glow` (+ `-sm`/`-lg`/`-strong`/`-info`/`-cyan`, manchas desfocadas de fundo; precisa de um ancestral `position:relative`), `op-avatar` (+ `-sm`/`-lg`, `-ring`), `op-avatar-group` |
|
|
82
|
+
| Layout/utilitários | `op-row` (flex wrap), `op-stack` (flex column), `op-grid-2/3/4` (grid responsivo), `op-mobile-only`, `op-text-muted`/`op-text-accent`/`op-text-mono`/`op-text-sm`/`op-text-xs`, `op-mt-1..4`/`op-mb-1..4` |
|
|
83
|
+
|
|
84
|
+
## Combobox (input com busca)
|
|
85
|
+
|
|
86
|
+
Estrutura obrigatória (o JS liga sozinho via `data-op-*`, não precisa de mais nada):
|
|
87
|
+
|
|
88
|
+
```html
|
|
89
|
+
<div class="op-combobox" data-op-combobox>
|
|
90
|
+
<input class="op-input" data-op-combobox-input type="text" placeholder="Buscar..." autocomplete="off">
|
|
91
|
+
<div class="op-combobox-menu" data-op-combobox-menu>
|
|
92
|
+
<button type="button" class="op-combobox-option" data-op-combobox-option data-value="br">Brasil</button>
|
|
93
|
+
<button type="button" class="op-combobox-option" data-op-combobox-option data-value="pt">Portugal</button>
|
|
94
|
+
<div class="op-combobox-empty" hidden>Nenhum resultado</div>
|
|
95
|
+
</div>
|
|
96
|
+
</div>
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Abre no foco do input, filtra as opções pelo texto digitado (case-insensitive), navega com seta pra cima/baixo, seleciona com clique ou Enter, fecha com ESC/clique fora. Ao selecionar: o `<input>` recebe o texto da opção, e o `data-value` da opção escolhida fica disponível em `elementoComCombobox.dataset.value`. Dispara um evento `change` no input ao selecionar, pra quem quiser ouvir. Não cria `<select>`/`<option>` nativos, é só `<div>`/`<button>`; se precisar enviar o valor num `<form>` tradicional, leia `dataset.value` no submit ou espelhe num `<input type="hidden">`.
|
|
100
|
+
|
|
101
|
+
## Atributos `data-op-*` (comportamento sem escrever JS)
|
|
102
|
+
|
|
103
|
+
| Atributo | Ação |
|
|
104
|
+
|---|---|
|
|
105
|
+
| `data-op-theme-toggle` | Alterna tema claro/escuro no elemento clicado (persiste em `localStorage`) |
|
|
106
|
+
| `data-op-sidebar-toggle` | Colapsa/expande a sidebar (desktop) |
|
|
107
|
+
| `data-op-sidebar-mobile` | Abre/fecha a sidebar como drawer (mobile) |
|
|
108
|
+
| `data-op-modal-open="#id"` | Abre o modal com esse id |
|
|
109
|
+
| `data-op-modal-close` | Fecha o modal ancestral (ESC e clique no backdrop também fecham) |
|
|
110
|
+
| `data-op-tab="nome"` | Botão de aba; use `data-op-tab-group="grupo"` no container pai quando houver mais de um grupo de tabs na mesma página |
|
|
111
|
+
| `data-op-tab-panel="nome"` | Painel correspondente a `data-op-tab="nome"` |
|
|
112
|
+
| `data-op-dropdown-toggle` | Abre/fecha o `.op-dropdown` ancestral mais próximo |
|
|
113
|
+
| `data-op-dismiss` | Remove o `.op-alert` (ou o pai direto) com animação |
|
|
114
|
+
| `data-op-tip="texto"` | Tooltip em CSS puro no elemento (hover) |
|
|
115
|
+
| `data-op-copy="#seletor"` | Copia o HTML do elemento alvo pro clipboard |
|
|
116
|
+
| `data-op-code="#seletor"` | Mostra/esconde um bloco `<pre>` com o código-fonte do elemento alvo |
|
|
117
|
+
| `data-op-loading-form` | No `<form>`: mostra a tela de carregamento sozinho ao submeter |
|
|
118
|
+
| `data-op-loading-message="texto"` | Mensagem customizada pro `data-op-loading-form` (padrão: "Carregando...") |
|
|
119
|
+
| `data-op-reveal` (no wrapper) + `data-op-reveal-toggle` (no botão dentro) | Mostrar/ocultar senha; o wrapper envolve o `<input type="password">` e o botão |
|
|
120
|
+
| `data-op-toast='[{"type":"success","message":"Oi"}]'` | Dispara toast(s) a partir de flash messages vindas do servidor, sem `<script>` inline (funciona sob CSP estrito). Aceita um objeto único ou array. Campos: `type` (`success`/`error`/`warning`/`info`), `message`, `duration` (ms, opcional) |
|
|
121
|
+
| `data-op-version` | Elemento cujo texto é substituído pela versão da lib (ex.: `v1.2.0`) no carregamento |
|
|
122
|
+
| `data-op-combobox` (wrapper) + `data-op-combobox-input` + `data-op-combobox-menu` + `data-op-combobox-option` | Combobox com busca/filtro; ver seção "Combobox" acima pra estrutura completa |
|
|
123
|
+
|
|
124
|
+
## API JavaScript (`window.OptagoUI`)
|
|
125
|
+
|
|
126
|
+
```js
|
|
127
|
+
OptagoUI.toast(mensagem, tipo, duracaoMs); // tipo: 'success' | 'error' | 'warning' | 'info' (padrão 'info'); duração padrão 4000ms
|
|
128
|
+
// toast pausa o contador ao passar o mouse ou focar nele, e mostra barra de progresso
|
|
129
|
+
OptagoUI.openModal('#idDoModal');
|
|
130
|
+
OptagoUI.closeModal('#idDoModal');
|
|
131
|
+
OptagoUI.setTheme('light'); // 'dark' | 'light', também persiste em localStorage
|
|
132
|
+
OptagoUI.toggleTheme();
|
|
133
|
+
OptagoUI.toggleSidebar(); // desktop: colapsa/expande; mobile: chama toggleSidebarMobile()
|
|
134
|
+
OptagoUI.toggleSidebarMobile();
|
|
135
|
+
OptagoUI.closeSidebarMobile();
|
|
136
|
+
OptagoUI.showLoading('Salvando...'); // mostra overlay de carregamento full-screen; mensagem opcional
|
|
137
|
+
OptagoUI.hideLoading();
|
|
138
|
+
OptagoUI.copyHTML('#seletor', botaoOpcional); // usado internamente por data-op-copy
|
|
139
|
+
OptagoUI.toggleCode('#seletor', botao); // usado internamente por data-op-code
|
|
140
|
+
OptagoUI.version; // string, ex. "1.2.0"
|
|
141
|
+
|
|
142
|
+
// Tabela avançada: carrega Tabulator via CDN sob demanda, já com tema Óptago aplicado
|
|
143
|
+
OptagoUI.tabulator('#minhaTabela', {
|
|
144
|
+
layout: 'fitColumns',
|
|
145
|
+
pagination: true,
|
|
146
|
+
data: [...],
|
|
147
|
+
columns: [...]
|
|
148
|
+
}).then(instanciaTabulator => { /* ... */ });
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Tokens CSS (design tokens, sobrescrevíveis)
|
|
152
|
+
|
|
153
|
+
Sobrescreva no seu próprio CSS, depois de importar `ui-optago.css`:
|
|
154
|
+
|
|
155
|
+
```css
|
|
156
|
+
:root {
|
|
157
|
+
--op-accent: #C0FF6B; /* verde-lima, cor primária da marca */
|
|
158
|
+
--op-cyan: #6BE0FF; /* ciano, cor secundária da marca */
|
|
159
|
+
--op-info: #3B82F6;
|
|
160
|
+
--op-success: #10B981;
|
|
161
|
+
--op-warning: #F59E0B;
|
|
162
|
+
--op-danger: #EF4444;
|
|
163
|
+
--op-radius: 12px; /* --op-radius-sm: 8px, --op-radius-lg: 16px */
|
|
164
|
+
/* superfícies (mudam por tema, não sobrescreva sem pensar nos dois): */
|
|
165
|
+
/* --op-bg, --op-panel, --op-panel-2, --op-panel-3, --op-border, --op-border-2, --op-text, --op-strong, --op-muted */
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
Tema escuro é o `:root` (padrão). Tema claro redefine as mesmas variáveis dentro de `html.light { ... }`, aplicado automaticamente pelo JS.
|
|
170
|
+
|
|
171
|
+
## Selo "Desenvolvido por Óptago"
|
|
172
|
+
|
|
173
|
+
Para rodapé de QUALQUER site da Óptago, mesmo sites que não usam o resto da lib. Dois arquivos autocontidos (não dependem de `ui-optago.css`/`.js`): `optago-credit-dark.html` (fundos escuros/neutros) e `optago-credit-light.html` (fundos claros).
|
|
174
|
+
|
|
175
|
+
```html
|
|
176
|
+
<div id="optago-credit"></div>
|
|
177
|
+
<script>
|
|
178
|
+
fetch('https://unpkg.com/ui-optago@1.2.0/optago-credit-dark.html')
|
|
179
|
+
.then(r => r.text())
|
|
180
|
+
.then(html => document.getElementById('optago-credit').innerHTML = html);
|
|
181
|
+
</script>
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
Ou copie o arquivo direto pro projeto e inclua localmente (`include` no PHP, import estático etc.).
|
|
185
|
+
|
|
186
|
+
## Arquivos do pacote
|
|
187
|
+
|
|
188
|
+
- `ui-optago.css`, `ui-optago.js`: a lib em si (obrigatórios, sempre os dois juntos)
|
|
189
|
+
- `optago-credit-dark.html`, `optago-credit-light.html`: selo de rodapé, independentes da lib
|
|
190
|
+
- `index.html`: showcase com todos os componentes renderizados e botão "Copiar" pra cada exemplo
|
|
191
|
+
- `README.md`: documentação em prosa para humanos
|
|
192
|
+
- `llms.txt`: este arquivo
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ui-optago",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Design System Óptago: componentes UI em CSS puro + JS vanilla, com tema claro/escuro, verde-lima (#C0FF6B) e app shell com sidebar colapsável.",
|
|
5
5
|
"author": "Óptago <cowork@optago.com.br> (https://optago.com.br)",
|
|
6
6
|
"license": "MIT",
|
|
@@ -21,7 +21,9 @@
|
|
|
21
21
|
"files": [
|
|
22
22
|
"ui-optago.css",
|
|
23
23
|
"ui-optago.js",
|
|
24
|
-
"
|
|
24
|
+
"index.html",
|
|
25
|
+
"favicon.ico",
|
|
26
|
+
"llms.txt",
|
|
25
27
|
"optago-credit-dark.html",
|
|
26
28
|
"optago-credit-light.html"
|
|
27
29
|
]
|
package/ui-optago.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ============================================================================
|
|
2
|
-
UI ÓPTAGO: Design System v1.
|
|
2
|
+
UI ÓPTAGO: Design System v1.2.0
|
|
3
3
|
CSS puro, sem dependências. Tema escuro por padrão.
|
|
4
4
|
Para tema claro: adicione a classe "light" ao <html> (o ui-optago.js
|
|
5
5
|
gerencia isso automaticamente via localStorage).
|
|
@@ -78,10 +78,10 @@
|
|
|
78
78
|
|
|
79
79
|
/* Superfícies: TEMA CLARO */
|
|
80
80
|
html.light {
|
|
81
|
-
--op-bg: #
|
|
82
|
-
--op-panel: #
|
|
83
|
-
--op-panel-2: #
|
|
84
|
-
--op-panel-3: #
|
|
81
|
+
--op-bg: #DDE3EA;
|
|
82
|
+
--op-panel: #EDF1F5;
|
|
83
|
+
--op-panel-2: #D5DCE4;
|
|
84
|
+
--op-panel-3: #CDD5DE;
|
|
85
85
|
--op-border: #D6DEE7;
|
|
86
86
|
--op-border-2: #BDC9D8;
|
|
87
87
|
--op-text: #334155;
|
|
@@ -101,12 +101,14 @@ html.light {
|
|
|
101
101
|
color-scheme: light;
|
|
102
102
|
}
|
|
103
103
|
|
|
104
|
-
/* Fundo do tema claro: gradiente suave com um toque de verde-lima no topo
|
|
104
|
+
/* Fundo do tema claro: gradiente suave com um toque de verde-lima no topo.
|
|
105
|
+
Baseado em --op-bg (não em hex fixo) e propositalmente mais escuro que
|
|
106
|
+
--op-panel, pra telas (fundo) não ficarem parecidas com cards (painel). */
|
|
105
107
|
html.light body {
|
|
106
108
|
background:
|
|
107
109
|
radial-gradient(900px 420px at 75% -10%, rgba(192,255,107,.20) 0%, transparent 60%),
|
|
108
110
|
radial-gradient(700px 380px at 10% 110%, rgba(192,255,107,.10) 0%, transparent 60%),
|
|
109
|
-
linear-gradient(180deg,
|
|
111
|
+
linear-gradient(180deg, var(--op-bg) 0%, color-mix(in srgb, var(--op-bg) 85%, black) 100%);
|
|
110
112
|
}
|
|
111
113
|
|
|
112
114
|
/* ----------------------------------------------------------------------------
|
|
@@ -221,11 +223,12 @@ html.light :focus-visible {
|
|
|
221
223
|
display: flex;
|
|
222
224
|
flex-direction: column;
|
|
223
225
|
position: relative;
|
|
224
|
-
/*
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
226
|
+
/* Sem overflow:clip aqui (era o comportamento antigo): isso cortava
|
|
227
|
+
qualquer coisa que vazasse do header/footer, incluindo tooltips
|
|
228
|
+
(data-op-tip) de botões perto da sidebar — a borda direita da
|
|
229
|
+
.op-app-body é exatamente onde a sidebar começa. A contenção do
|
|
230
|
+
.op-glow (pra não tornar o documento rolável) agora é feita dentro
|
|
231
|
+
do .op-main, que é onde o glow realmente é usado. */
|
|
229
232
|
}
|
|
230
233
|
|
|
231
234
|
/* Header */
|
|
@@ -239,11 +242,9 @@ html.light :focus-visible {
|
|
|
239
242
|
gap: 1rem;
|
|
240
243
|
padding: 0 1.25rem;
|
|
241
244
|
border-bottom: 1px solid var(--op-border);
|
|
242
|
-
background:
|
|
243
|
-
backdrop-filter: blur(12px);
|
|
244
|
-
-webkit-backdrop-filter: blur(12px);
|
|
245
|
+
background: var(--op-panel);
|
|
245
246
|
box-shadow: 0 8px 24px -12px rgba(0,0,0,.5);
|
|
246
|
-
z-index: 30;
|
|
247
|
+
z-index: 30; /* precisa ficar abaixo da .op-sidebar (50) no mobile, pra o drawer cobrir o header ao abrir */
|
|
247
248
|
}
|
|
248
249
|
/* filete de brilho verde-lima sob o header */
|
|
249
250
|
.op-header::after {
|
|
@@ -286,6 +287,7 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
|
|
|
286
287
|
.op-main {
|
|
287
288
|
flex: 1;
|
|
288
289
|
overflow-y: auto;
|
|
290
|
+
overflow-x: clip; /* contém .op-glow (evita que vaze e torne a página rolável) */
|
|
289
291
|
padding: 1.5rem;
|
|
290
292
|
scroll-behavior: smooth;
|
|
291
293
|
position: relative;
|
|
@@ -293,6 +295,16 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
|
|
|
293
295
|
}
|
|
294
296
|
@media (min-width: 1024px) { .op-main { padding: 1.75rem 2rem; } }
|
|
295
297
|
|
|
298
|
+
/* header/footer ficam acima da sidebar por padrão (55 > 50): evita que um
|
|
299
|
+
tooltip (data-op-tip) de um botão do header/footer fique preso no contexto
|
|
300
|
+
de empilhamento do header/footer e acabe renderizado atrás da sidebar,
|
|
301
|
+
mesmo com z-index nominal maior que o dela. Isso valia só a partir de
|
|
302
|
+
1024px antes, mas o mesmo corte acontecia em qualquer largura abaixo
|
|
303
|
+
disso enquanto a sidebar ainda não é o drawer mobile aberto — por isso
|
|
304
|
+
agora é incondicional. Quando a sidebar VIRA o drawer mobile (.is-open),
|
|
305
|
+
ela sobe pra 60 e volta a cobrir o header normalmente. */
|
|
306
|
+
.op-header, .op-footer { z-index: 55; }
|
|
307
|
+
|
|
296
308
|
.op-container { max-width: 1100px; margin: 0 auto; }
|
|
297
309
|
|
|
298
310
|
/* Footer */
|
|
@@ -309,7 +321,7 @@ html.light .op-brand-mark::after { background: var(--op-accent); }
|
|
|
309
321
|
font-family: var(--op-font-mono);
|
|
310
322
|
font-size: 11px;
|
|
311
323
|
color: var(--op-muted);
|
|
312
|
-
z-index: 30;
|
|
324
|
+
z-index: 30; /* mesmo motivo do .op-header */
|
|
313
325
|
}
|
|
314
326
|
|
|
315
327
|
/* ----------------------------------------------------------------------------
|
|
@@ -455,7 +467,7 @@ html.light .op-nav-item:hover { color: #000000; }
|
|
|
455
467
|
transform: translateX(100%);
|
|
456
468
|
box-shadow: var(--op-shadow-lg);
|
|
457
469
|
}
|
|
458
|
-
.op-sidebar.is-open { transform: translateX(0); }
|
|
470
|
+
.op-sidebar.is-open { transform: translateX(0); z-index: 60; }
|
|
459
471
|
.op-sidebar.is-collapsed { width: var(--op-sidebar-w); } /* colapso só no desktop */
|
|
460
472
|
.op-sidebar.is-collapsed .op-nav-text,
|
|
461
473
|
.op-sidebar.is-collapsed .op-sidebar-label,
|
|
@@ -644,24 +656,26 @@ html.light .op-badge-cyan { color: #0E7490; }
|
|
|
644
656
|
}
|
|
645
657
|
.op-alert-close:hover { opacity: 1; }
|
|
646
658
|
|
|
647
|
-
.op-alert-info { background: color-mix(in srgb, var(--op-info)
|
|
659
|
+
.op-alert-info { background: color-mix(in srgb, var(--op-info) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-info) 45%, transparent); }
|
|
648
660
|
.op-alert-info > i, .op-alert-info .op-alert-title { color: color-mix(in srgb, var(--op-info) 65%, var(--op-strong)); }
|
|
649
|
-
.op-alert-success { background: color-mix(in srgb, var(--op-success)
|
|
661
|
+
.op-alert-success { background: color-mix(in srgb, var(--op-success) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-success) 45%, transparent); }
|
|
650
662
|
.op-alert-success > i, .op-alert-success .op-alert-title { color: color-mix(in srgb, var(--op-success) 65%, var(--op-strong)); }
|
|
651
|
-
.op-alert-warning { background: color-mix(in srgb, var(--op-warning)
|
|
663
|
+
.op-alert-warning { background: color-mix(in srgb, var(--op-warning) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-warning) 45%, transparent); }
|
|
652
664
|
.op-alert-warning > i, .op-alert-warning .op-alert-title { color: color-mix(in srgb, var(--op-warning) 65%, var(--op-strong)); }
|
|
653
|
-
.op-alert-danger { background: color-mix(in srgb, var(--op-danger)
|
|
665
|
+
.op-alert-danger { background: color-mix(in srgb, var(--op-danger) 28%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-danger) 45%, transparent); }
|
|
654
666
|
.op-alert-danger > i, .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 65%, var(--op-strong)); }
|
|
655
667
|
|
|
656
|
-
/* Modo claro: fundo mais saturado e
|
|
657
|
-
|
|
658
|
-
|
|
668
|
+
/* Modo claro: fundo mais saturado e opaco (misturado com --op-panel-2 em vez de
|
|
669
|
+
transparent, senão a cor de fundo da página vaza e o alerta fica "aguado") e
|
|
670
|
+
texto/ícone numa variante mais escura da cor semântica (em vez do tom vivo,
|
|
671
|
+
que perde contraste em fundo claro). */
|
|
672
|
+
html.light .op-alert-info { background: color-mix(in srgb, var(--op-info) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-info) 55%, transparent); }
|
|
659
673
|
html.light .op-alert-info > i, html.light .op-alert-info .op-alert-title { color: color-mix(in srgb, var(--op-info) 70%, black); }
|
|
660
|
-
html.light .op-alert-success { background: color-mix(in srgb, var(--op-success)
|
|
674
|
+
html.light .op-alert-success { background: color-mix(in srgb, var(--op-success) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-success) 55%, transparent); }
|
|
661
675
|
html.light .op-alert-success > i, html.light .op-alert-success .op-alert-title { color: color-mix(in srgb, var(--op-success) 70%, black); }
|
|
662
|
-
html.light .op-alert-warning { background: color-mix(in srgb, var(--op-warning)
|
|
676
|
+
html.light .op-alert-warning { background: color-mix(in srgb, var(--op-warning) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-warning) 55%, transparent); }
|
|
663
677
|
html.light .op-alert-warning > i, html.light .op-alert-warning .op-alert-title { color: color-mix(in srgb, var(--op-warning) 70%, black); }
|
|
664
|
-
html.light .op-alert-danger { background: color-mix(in srgb, var(--op-danger)
|
|
678
|
+
html.light .op-alert-danger { background: color-mix(in srgb, var(--op-danger) 34%, var(--op-panel-2)); border-color: color-mix(in srgb, var(--op-danger) 55%, transparent); }
|
|
665
679
|
html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title { color: color-mix(in srgb, var(--op-danger) 70%, black); }
|
|
666
680
|
|
|
667
681
|
/* ----------------------------------------------------------------------------
|
|
@@ -1374,7 +1388,9 @@ html.light .op-spinner-dots span { background: var(--op-primary); }
|
|
|
1374
1388
|
font-weight: 700;
|
|
1375
1389
|
padding: .375rem .75rem;
|
|
1376
1390
|
border-radius: var(--op-radius-sm);
|
|
1377
|
-
|
|
1391
|
+
max-width: min(220px, 90vw);
|
|
1392
|
+
white-space: normal;
|
|
1393
|
+
text-align: center;
|
|
1378
1394
|
box-shadow: var(--op-shadow);
|
|
1379
1395
|
opacity: 0;
|
|
1380
1396
|
visibility: hidden;
|
|
@@ -1832,6 +1848,7 @@ html.light .op-glow-strong { opacity: .55; }
|
|
|
1832
1848
|
justify-content: center;
|
|
1833
1849
|
font-size: 2rem;
|
|
1834
1850
|
margin-bottom: 1rem;
|
|
1851
|
+
animation: op-icon-pop .5s var(--op-spring);
|
|
1835
1852
|
}
|
|
1836
1853
|
.op-modal-icon.is-success { background: color-mix(in srgb, var(--op-success) 15%, transparent); color: var(--op-success); }
|
|
1837
1854
|
.op-modal-icon.is-danger { background: color-mix(in srgb, var(--op-danger) 15%, transparent); color: var(--op-danger); }
|
|
@@ -1839,6 +1856,12 @@ html.light .op-glow-strong { opacity: .55; }
|
|
|
1839
1856
|
.op-modal-icon.is-brand { background: color-mix(in srgb, var(--op-accent) 14%, transparent); color: var(--op-accent); }
|
|
1840
1857
|
html.light .op-modal-icon.is-brand { color: #3F6212; }
|
|
1841
1858
|
|
|
1859
|
+
@keyframes op-icon-pop {
|
|
1860
|
+
0% { transform: scale(0) rotate(-20deg); opacity: 0; }
|
|
1861
|
+
60% { transform: scale(1.15) rotate(4deg); opacity: 1; }
|
|
1862
|
+
100% { transform: scale(1) rotate(0deg); }
|
|
1863
|
+
}
|
|
1864
|
+
|
|
1842
1865
|
@keyframes op-drawer-in {
|
|
1843
1866
|
from { transform: translateX(100%); }
|
|
1844
1867
|
to { transform: translateX(0); }
|
package/ui-optago.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ============================================================================
|
|
2
|
-
UI ÓPTAGO: Design System v1.
|
|
2
|
+
UI ÓPTAGO: Design System v1.2.0 (JavaScript)
|
|
3
3
|
Sem dependências de build. Carregue no <head> SEM defer para evitar
|
|
4
4
|
flash de tema errado (FOUC):
|
|
5
5
|
|
|
@@ -31,6 +31,15 @@
|
|
|
31
31
|
partir de flash messages do servidor,
|
|
32
32
|
sem precisar de <script> inline (CSP-safe)
|
|
33
33
|
|
|
34
|
+
Tema compartilhado entre subdomínios: adicione data-op-theme-domain no
|
|
35
|
+
próprio <script src="ui-optago.js"> pra o tema virar cookie em vez de só
|
|
36
|
+
localStorage, e todo app sob esse domínio (ex.: app1.seusite.com,
|
|
37
|
+
app2.seusite.com) passa a enxergar a mesma escolha de tema:
|
|
38
|
+
|
|
39
|
+
<script src="ui-optago.js" data-op-theme-domain=".seusite.com"></script>
|
|
40
|
+
|
|
41
|
+
Sem esse atributo, o tema continua só em localStorage (por app, como antes).
|
|
42
|
+
|
|
34
43
|
API global: OptagoUI.toast(msg, tipo, ms) · OptagoUI.openModal(sel)
|
|
35
44
|
OptagoUI.closeModal(sel) · OptagoUI.setTheme('dark'|'light')
|
|
36
45
|
OptagoUI.showLoading(msg) · OptagoUI.hideLoading()
|
|
@@ -42,7 +51,7 @@
|
|
|
42
51
|
|
|
43
52
|
// Fonte única da versão exibida no badge do header e no rodapé
|
|
44
53
|
// (elementos com o atributo data-op-version). Atualize só aqui.
|
|
45
|
-
var VERSION = '1.
|
|
54
|
+
var VERSION = '1.2.0';
|
|
46
55
|
OptagoUI.version = VERSION;
|
|
47
56
|
|
|
48
57
|
/* --------------------------------------------------------------------------
|
|
@@ -50,8 +59,26 @@
|
|
|
50
59
|
-------------------------------------------------------------------------- */
|
|
51
60
|
var THEME_KEY = 'op-theme';
|
|
52
61
|
|
|
62
|
+
// document.currentScript só é confiável em scripts síncronos (sem defer/
|
|
63
|
+
// async), que é exatamente como esta lib precisa ser carregada mesmo.
|
|
64
|
+
var THEME_DOMAIN = (function () {
|
|
65
|
+
var s = document.currentScript;
|
|
66
|
+
return (s && s.getAttribute('data-op-theme-domain')) || null;
|
|
67
|
+
})();
|
|
68
|
+
|
|
69
|
+
function readCookie(name) {
|
|
70
|
+
var m = document.cookie.match(new RegExp('(?:^|; )' + name + '=([^;]*)'));
|
|
71
|
+
return m ? decodeURIComponent(m[1]) : null;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
function writeCookie(name, value) {
|
|
75
|
+
var attrs = 'path=/; max-age=31536000; SameSite=Lax; domain=' + THEME_DOMAIN;
|
|
76
|
+
if (window.location.protocol === 'https:') attrs += '; Secure';
|
|
77
|
+
document.cookie = name + '=' + encodeURIComponent(value) + '; ' + attrs;
|
|
78
|
+
}
|
|
79
|
+
|
|
53
80
|
function currentTheme() {
|
|
54
|
-
var saved = localStorage.getItem(THEME_KEY);
|
|
81
|
+
var saved = (THEME_DOMAIN && readCookie(THEME_KEY)) || localStorage.getItem(THEME_KEY);
|
|
55
82
|
if (saved === 'light' || saved === 'dark') return saved;
|
|
56
83
|
return window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
|
|
57
84
|
}
|
|
@@ -59,6 +86,7 @@
|
|
|
59
86
|
OptagoUI.setTheme = function (theme) {
|
|
60
87
|
document.documentElement.classList.toggle('light', theme === 'light');
|
|
61
88
|
localStorage.setItem(THEME_KEY, theme);
|
|
89
|
+
if (THEME_DOMAIN) writeCookie(THEME_KEY, theme);
|
|
62
90
|
document.querySelectorAll('[data-op-theme-toggle]').forEach(function (btn) {
|
|
63
91
|
var moon = btn.querySelector('.op-icon-moon');
|
|
64
92
|
var sun = btn.querySelector('.op-icon-sun');
|