ui-optago 1.2.4 → 2.0.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.
@@ -0,0 +1,731 @@
1
+ <!DOCTYPE html>
2
+ <html lang="pt-BR">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
6
+
7
+ <!-- SEO: gerado por scripts/gerar.mjs a partir de capitulos/capitulos.json -->
8
+ <!-- manual:seo -->
9
+ <title>Começando: instalação, tema e personalização | UI Óptago</title>
10
+ <meta name="description" content="Instale o UI Óptago por CDN ou npm, entenda as convenções, o layout, o tema claro e escuro, a aparência personalizável e o idioma. CSS puro e JavaScript vanilla.">
11
+ <meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
12
+ <meta name="author" content="Óptago">
13
+ <meta name="keywords" content="biblioteca de interface, ui, css puro, javascript vanilla, componentes, leve, moderna, tema escuro, acessibilidade, wcag, óptago">
14
+ <meta name="theme-color" content="#151A21" media="(prefers-color-scheme: dark)">
15
+ <meta name="theme-color" content="#EEF2F7" media="(prefers-color-scheme: light)">
16
+ <link rel="canonical" href="https://ui.optago.com.br/capitulos/comecando.html">
17
+ <link rel="alternate" hreflang="pt-BR" href="https://ui.optago.com.br/capitulos/comecando.html">
18
+ <link rel="alternate" hreflang="x-default" href="https://ui.optago.com.br/capitulos/comecando.html">
19
+ <link rel="prev" href="https://ui.optago.com.br/">
20
+ <link rel="next" href="https://ui.optago.com.br/capitulos/fundamentos.html">
21
+
22
+ <!-- Open Graph / redes sociais -->
23
+ <meta property="og:type" content="article">
24
+ <meta property="og:url" content="https://ui.optago.com.br/capitulos/comecando.html">
25
+ <meta property="og:title" content="Começando: instalação, tema e personalização | UI Óptago">
26
+ <meta property="og:description" content="Instale o UI Óptago por CDN ou npm, entenda as convenções, o layout, o tema claro e escuro, a aparência personalizável e o idioma. CSS puro e JavaScript vanilla.">
27
+ <meta property="og:image" content="https://ui.optago.com.br/og.png">
28
+ <meta property="og:image:type" content="image/png">
29
+ <meta property="og:image:width" content="1200">
30
+ <meta property="og:image:height" content="630">
31
+ <meta property="og:image:alt" content="UI Óptago: biblioteca de interface leve e moderna, em CSS puro e JavaScript vanilla">
32
+ <meta property="og:locale" content="pt_BR">
33
+ <meta property="og:site_name" content="UI Óptago">
34
+ <meta name="twitter:card" content="summary_large_image">
35
+ <meta name="twitter:title" content="Começando: instalação, tema e personalização | UI Óptago">
36
+ <meta name="twitter:description" content="Instale o UI Óptago por CDN ou npm, entenda as convenções, o layout, o tema claro e escuro, a aparência personalizável e o idioma. CSS puro e JavaScript vanilla.">
37
+ <meta name="twitter:image" content="https://ui.optago.com.br/og.png">
38
+ <meta name="twitter:image:alt" content="UI Óptago: biblioteca de interface leve e moderna, em CSS puro e JavaScript vanilla">
39
+
40
+ <!-- Conexões antecipadas: fontes e ícones que a biblioteca carrega -->
41
+ <link rel="preconnect" href="https://fonts.googleapis.com">
42
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
43
+ <link rel="preconnect" href="https://unpkg.com" crossorigin>
44
+
45
+ <!-- Dados estruturados (schema.org) -->
46
+ <script type="application/ld+json">
47
+ {
48
+ "@context": "https://schema.org",
49
+ "@graph": [
50
+ {
51
+ "@type": "Organization",
52
+ "@id": "https://optago.com.br/#organizacao",
53
+ "name": "Óptago",
54
+ "url": "https://optago.com.br"
55
+ },
56
+ {
57
+ "@type": "WebSite",
58
+ "@id": "https://ui.optago.com.br/#site",
59
+ "url": "https://ui.optago.com.br/",
60
+ "name": "UI Óptago",
61
+ "inLanguage": "pt-BR",
62
+ "publisher": {
63
+ "@id": "https://optago.com.br/#organizacao"
64
+ }
65
+ },
66
+ {
67
+ "@type": "TechArticle",
68
+ "@id": "https://ui.optago.com.br/capitulos/comecando.html#artigo",
69
+ "headline": "Começando",
70
+ "name": "Começando: instalação, tema e personalização | UI Óptago",
71
+ "description": "Instale o UI Óptago por CDN ou npm, entenda as convenções, o layout, o tema claro e escuro, a aparência personalizável e o idioma. CSS puro e JavaScript vanilla.",
72
+ "url": "https://ui.optago.com.br/capitulos/comecando.html",
73
+ "image": "https://ui.optago.com.br/og.png",
74
+ "inLanguage": "pt-BR",
75
+ "isPartOf": {
76
+ "@id": "https://ui.optago.com.br/#site"
77
+ },
78
+ "author": {
79
+ "@id": "https://optago.com.br/#organizacao"
80
+ },
81
+ "publisher": {
82
+ "@id": "https://optago.com.br/#organizacao"
83
+ },
84
+ "about": {
85
+ "@type": "Thing",
86
+ "name": "Começando"
87
+ },
88
+ "position": 1
89
+ },
90
+ {
91
+ "@type": "BreadcrumbList",
92
+ "itemListElement": [
93
+ {
94
+ "@type": "ListItem",
95
+ "position": 1,
96
+ "name": "Início",
97
+ "item": "https://ui.optago.com.br/"
98
+ },
99
+ {
100
+ "@type": "ListItem",
101
+ "position": 2,
102
+ "name": "Capítulo 1: Começando",
103
+ "item": "https://ui.optago.com.br/capitulos/comecando.html"
104
+ }
105
+ ]
106
+ }
107
+ ]
108
+ }
109
+ </script>
110
+ <!-- /manual:seo -->
111
+
112
+ <!-- Favicon: octógono verde-lima da marca com "UI" dentro (favicon.ico, multi-resolução) -->
113
+ <link rel="icon" type="image/x-icon" href="../favicon.ico">
114
+
115
+ <link rel="stylesheet" href="../ui-optago.css">
116
+ <script src="../ui-optago.js"></script>
117
+ </head>
118
+
119
+ <body class="op-app">
120
+
121
+ <!-- Primeiro elemento da página: aparece só com o foco do teclado -->
122
+ <a class="op-skip-link" href="#conteudo">Pular para o conteúdo</a>
123
+
124
+ <!-- ==================== COLUNA PRINCIPAL (header + main + footer) ==================== -->
125
+ <div class="op-app-body">
126
+
127
+ <!-- Glows de fundo (verde-lima desfocado): ficam atrás do conteúdo -->
128
+ <!-- (o fundo da página agora é a aurora do próprio ui-optago.css; os
129
+ .op-glow ficam para destacar blocos específicos, como nas seções abaixo) -->
130
+
131
+ <!-- HEADER (fixo) -->
132
+ <header class="op-header">
133
+ <div class="op-header-group">
134
+ <a class="op-brand" href="https://optago.com.br" target="_blank" rel="noopener" aria-label="Ir para o site da Óptago">
135
+ <div class="op-brand-mark"></div>
136
+ <span class="op-brand-name">Óptago</span>
137
+ </a>
138
+ <div class="op-header-divider op-desktop-only"></div>
139
+ <div class="op-header-group op-desktop-only">
140
+ <a href="../index.html" aria-label="Início do manual do UI Óptago" style="display:inline-flex; align-items:center; justify-content:center; min-width:28px; min-height:28px; font-family:var(--op-font-display); font-size:.875rem; font-weight:700; color:var(--op-strong); text-decoration:none;">UI</a>
141
+ <span class="op-badge op-badge-brand op-badge-pill op-desktop-only"><span class="op-dot op-dot-pulse"></span><span data-op-version>v1.0.5</span></span>
142
+ </div>
143
+ </div>
144
+ <div class="op-header-group">
145
+
146
+ <a
147
+ href="https://www.npmjs.com/package/ui-optago"
148
+ target="_blank"
149
+ rel="noopener noreferrer"
150
+ class="op-btn op-btn-icon op-btn-ghost op-tip-bottom op-desktop-only"
151
+ data-op-tip="Abrir UI Optago no npm">
152
+ <i class="ph ph-package"></i>
153
+ </a>
154
+
155
+ <!-- Painel de personalização: tema, cor de destaque, cantos, fonte... -->
156
+ <button class="op-btn op-btn-icon op-btn-ghost op-tip-bottom" data-op-customizer-open data-op-tip="Personalizar a aparência">
157
+ <i class="ph ph-paint-brush-broad"></i>
158
+ </button>
159
+
160
+ <!-- Paleta de comandos (também abre com Ctrl+K) -->
161
+ <button class="op-btn op-btn-icon op-btn-ghost op-tip-bottom op-desktop-only" data-op-command-open data-op-tip="Buscar telas e ações (Ctrl+K)">
162
+ <i class="ph ph-magnifying-glass"></i>
163
+ </button>
164
+
165
+ <!-- Oculta todos os valores marcados com data-op-sensitive -->
166
+ <button class="op-btn op-btn-icon op-btn-ghost op-tip-bottom" data-op-privacy-toggle data-op-tip="Ocultar ou mostrar valores sensíveis">
167
+ <i class="ph ph-eye op-icon-eye"></i>
168
+ <i class="ph ph-eye-slash op-icon-eye-slash" style="display:none"></i>
169
+ </button>
170
+
171
+ <button class="op-btn op-btn-icon op-btn-ghost op-tip-bottom" data-op-theme-toggle data-op-tip="Alternar tema">
172
+ <i class="ph ph-moon op-icon-moon"></i>
173
+ <i class="ph ph-sun op-icon-sun" style="display:none"></i>
174
+ </button>
175
+
176
+
177
+
178
+ <!-- Hamburguer: aparece só no mobile para abrir o drawer -->
179
+ <button class="op-btn op-btn-icon op-btn-ghost op-mobile-only" data-op-sidebar-mobile>
180
+ <i class="ph ph-list"></i>
181
+ </button>
182
+ </div>
183
+ </header>
184
+
185
+ <!-- MAIN (única área rolável) -->
186
+ <main class="op-main" id="conteudo" tabindex="-1">
187
+ <div class="op-container">
188
+ <!-- manual:trilha -->
189
+ <nav aria-label="Você está em" class="op-mb-2">
190
+ <ul class="op-breadcrumb">
191
+ <li><a href="../index.html"><i class="ph ph-house" aria-hidden="true"></i> Início</a></li>
192
+ <li aria-current="page">Capítulo 1: Começando</li>
193
+ </ul>
194
+ </nav>
195
+ <!-- /manual:trilha -->
196
+ <div class="op-chapter" id="cap-comecando">
197
+ <p class="op-chapter-kicker">Capítulo 1</p>
198
+ <h1 class="op-chapter-title">Começando</h1>
199
+ <p class="op-chapter-text">O que incluir na página, como os nomes funcionam e como montar a estrutura de uma tela.</p>
200
+ <!-- manual:toc -->
201
+ <ul class="op-chapter-toc" aria-label="Neste capítulo">
202
+ <li><a href="#instalacao">Instalação</a></li>
203
+ <li><a href="#convencoes">Convenções</a></li>
204
+ <li><a href="#layout">Layout</a></li>
205
+ <li><a href="#tema">Tema</a></li>
206
+ <li><a href="#customizando">Customizando</a></li>
207
+ <li><a href="#idioma">Idioma</a></li>
208
+ <li><a href="#conteudo-dinamico">HTML inserido depois</a></li>
209
+ </ul>
210
+ <!-- /manual:toc -->
211
+ </div>
212
+
213
+ <section id="instalacao" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
214
+ <div class="op-section-head">
215
+ <i class="ph ph-download-simple"></i>
216
+ <h2>Instalação</h2>
217
+ </div>
218
+ <p class="op-text-muted op-text-sm">São dois arquivos, sem etapa de build. O <code>&lt;script&gt;</code> vai no <code>&lt;head&gt;</code>, sem <code>defer</code> nem <code>async</code>: ele aplica o tema antes de a página aparecer. Em produção, use sempre uma versão fixa.</p>
219
+ <div class="op-manual">
220
+ <div><p class="op-manual-title">Quando usar</p><p>No <code>&lt;head&gt;</code> de toda página que usa a biblioteca: primeiro o CSS, depois o script.</p></div>
221
+ <div><p class="op-manual-title">Cuidados</p><p>Sem <code>defer</code> e sem <code>async</code>. Em produção, fixe a versão no endereço.</p></div>
222
+ </div>
223
+ <div class="op-code op-mb-2"><pre><code>npm install ui-optago</code></pre></div>
224
+ <p class="op-text-sm">Opções no <code>&lt;script&gt;</code> da biblioteca:</p>
225
+ <div class="op-table-wrap">
226
+ <table class="op-table">
227
+ <thead><tr><th>Atributo</th><th>O que faz</th></tr></thead>
228
+ <tbody>
229
+ <tr><td><code>data-op-assets="off"</code></td><td>Não carrega nada de terceiros (você hospeda as fontes e os ícones).</td></tr>
230
+ <tr><td><code>data-op-fonts="off"</code></td><td>Não carrega as fontes do Google Fonts.</td></tr>
231
+ <tr><td><code>data-op-icons="regular,bold"</code></td><td>Carrega só esses pesos de ícone; <code>off</code> não carrega nenhum.</td></tr>
232
+ <tr><td><code>data-op-theme-domain=".seusite.com"</code></td><td>Guarda o tema em um cookie do domínio, para valer em todos os subdomínios.</td></tr>
233
+ <tr><td><code>data-op-observe="off"</code></td><td>Desliga o tratamento automático do HTML inserido depois do carregamento.</td></tr>
234
+ <tr><td><code>data-op-editor-base="/vendor/toastui/"</code></td><td>Carrega o editor de texto de uma pasta sua, em vez do CDN.</td></tr>
235
+ </tbody>
236
+ </table>
237
+ </div>
238
+ </section>
239
+
240
+ <section id="convencoes" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
241
+ <div class="op-section-head">
242
+ <i class="ph ph-ruler"></i>
243
+ <h2>Convenções</h2>
244
+ </div>
245
+ <p class="op-text-muted op-text-sm">Tudo na biblioteca segue as mesmas cinco regras de nome. Sabendo delas, dá para adivinhar o resto.</p>
246
+ <div class="op-table-wrap">
247
+ <table class="op-table">
248
+ <thead><tr><th>O quê</th><th>Como se escreve</th><th>Exemplo</th></tr></thead>
249
+ <tbody>
250
+ <tr><td>Componente</td><td>classe com prefixo <code>op-</code></td><td><code>op-btn</code>, <code>op-card</code>, <code>op-table</code></td></tr>
251
+ <tr><td>Variação</td><td>classe com o nome do componente na frente</td><td><code>op-btn-primary</code>, <code>op-alert-warning</code></td></tr>
252
+ <tr><td>Estado</td><td>classe com prefixo <code>is-</code></td><td><code>is-open</code>, <code>is-active</code>, <code>is-error</code></td></tr>
253
+ <tr><td>Comportamento</td><td>atributo <code>data-op-*</code>, sem escrever JavaScript</td><td><code>data-op-modal-open="#id"</code></td></tr>
254
+ <tr><td>Função</td><td>objeto global <code>OptagoUI</code></td><td><code>OptagoUI.toast('Salvo', 'success')</code></td></tr>
255
+ <tr><td>Evento</td><td>nome com prefixo <code>op:</code>, ouvido com <code>addEventListener</code></td><td><code>op:sort</code>, <code>op:otp-complete</code>, <code>op:theme-change</code></td></tr>
256
+ <tr><td>Cor, raio e fonte</td><td>variável CSS <code>--op-*</code></td><td><code>--op-accent</code>, <code>--op-radius</code></td></tr>
257
+ </tbody>
258
+ </table>
259
+ </div>
260
+ </section>
261
+
262
+ <section id="layout" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
263
+ <div class="op-section-head">
264
+ <i class="ph ph-layout"></i>
265
+ <h2>Layout: App Shell</h2>
266
+ </div>
267
+ <p class="op-text-muted op-text-sm"><code>body.op-app</code> contém <code>op-app-body</code> (cabeçalho, <code>op-main</code> e rodapé) e a <code>op-sidebar</code>, que fica à direita. Só o <code>op-main</code> rola.</p>
268
+ <div class="op-manual">
269
+ <div><p class="op-manual-title">Quando usar</p><p>Em painéis e sistemas. Página solta (login, erro, site) não precisa do app shell.</p></div>
270
+ <div><p class="op-manual-title">Cuidados</p><p>Comece o <code>&lt;body&gt;</code> com o link <code>op-skip-link</code> e dê um <code>id</code> ao <code>&lt;main&gt;</code>. Ponha no cabeçalho os botões de tema e de pausar animações.</p></div>
271
+ </div>
272
+ <div class="op-alert op-alert-info op-mb-2">
273
+ <i class="ph ph-info"></i>
274
+ <div>
275
+ <p class="op-alert-title">Esta própria página usa o app shell</p>
276
+ <p class="op-alert-text">Header, footer e sidebar (direita) são fixos. Apenas o conteúdo central rola. A sidebar colapsa no desktop (só ícones + tooltip) e vira drawer no mobile.</p>
277
+ </div>
278
+ </div>
279
+ <div class="op-demo">
280
+ <div class="op-demo-preview" style="padding:0;">
281
+ <pre class="op-demo-code is-visible" style="border-top:none;">&lt;body class="op-app"&gt;
282
+ &lt;div class="op-app-body"&gt;
283
+ &lt;header class="op-header"&gt;...&lt;/header&gt;
284
+ &lt;main class="op-main"&gt;CONTEÚDO ROLÁVEL&lt;/main&gt;
285
+ &lt;footer class="op-footer"&gt;...&lt;/footer&gt;
286
+ &lt;/div&gt;
287
+ &lt;aside class="op-sidebar"&gt;
288
+ &lt;nav class="op-sidebar-nav"&gt;
289
+ &lt;a class="op-nav-item" href="#secao"&gt;
290
+ &lt;i class="ph ph-palette"&gt;&lt;/i&gt;
291
+ &lt;span class="op-nav-text"&gt;Título&lt;/span&gt;
292
+ &lt;span class="op-nav-tooltip"&gt;Título&lt;/span&gt;
293
+ &lt;/a&gt;
294
+ &lt;/nav&gt;
295
+ &lt;/aside&gt;
296
+ &lt;/body&gt;</pre>
297
+ </div>
298
+ </div>
299
+
300
+ <h3 class="op-h4 op-mt-3 op-mb-1" style="font-size:1rem;">Visibilidade por tela</h3>
301
+ <p class="op-text-sm" style="max-width:640px;">
302
+ Duas utilitárias mostram ou escondem um elemento conforme a largura da tela. O corte é o
303
+ mesmo em que a sidebar vira drawer: <strong>1024px</strong>.
304
+ </p>
305
+ <div class="op-table-wrap op-mb-2">
306
+ <table class="op-table op-table-hover op-mb-2">
307
+ <thead><tr><th>Classe</th><th>Até 1023px (celular/tablet)</th><th>A partir de 1024px (desktop)</th></tr></thead>
308
+ <tbody>
309
+ <tr><td><code>op-mobile-only</code></td><td>Visível (<code>inline-flex</code>)</td><td>Escondida</td></tr>
310
+ <tr><td><code>op-desktop-only</code></td><td>Escondida</td><td>Visível (mantém o <code>display</code> original do elemento)</td></tr>
311
+ </tbody>
312
+ </table>
313
+ </div>
314
+ <div class="op-demo">
315
+ <div class="op-demo-preview op-row">
316
+ <span class="op-badge op-badge-info op-mobile-only"><i class="ph ph-device-mobile"></i> Você está no mobile</span>
317
+ <span class="op-badge op-badge-brand op-desktop-only"><i class="ph ph-desktop"></i> Você está no desktop</span>
318
+ </div>
319
+ <pre class="op-demo-code is-visible">&lt;!-- botão hambúrguer: só aparece onde a sidebar é drawer --&gt;
320
+ &lt;button class="op-btn op-btn-icon op-mobile-only" data-op-sidebar-mobile&gt;
321
+ &lt;i class="ph ph-list"&gt;&lt;/i&gt;
322
+ &lt;/button&gt;
323
+
324
+ &lt;!-- versão no header: some no celular pra não apertar o layout --&gt;
325
+ &lt;span class="op-badge op-desktop-only"&gt;v2.0.0&lt;/span&gt;</pre>
326
+ </div>
327
+ <p class="op-text-muted op-text-xs" style="margin:0;">
328
+ Ambas usam <code>display: none !important</code>/<code>inline-flex !important</code>, então vencem
329
+ o <code>display</code> definido por outra classe. Redimensione a janela pra ver a troca.
330
+ </p>
331
+ </section>
332
+
333
+ <section id="tema" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
334
+ <div class="op-section-head">
335
+ <i class="ph ph-circle-half"></i>
336
+ <h2>Tema: claro, escuro ou do sistema</h2>
337
+ </div>
338
+ <p class="op-text-muted op-text-sm">Sem escolha da pessoa, a página segue o tema do sistema operacional, inclusive quando ele muda com a página aberta. <code>data-op-theme-toggle</code> alterna entre claro e escuro; <code>data-op-theme="light"</code>, <code>"dark"</code> ou <code>"system"</code> escolhe direto. Por código: <code>OptagoUI.setTheme("system")</code>. O evento <code>op:theme-change</code> avisa a troca.</p>
339
+ <div class="op-manual">
340
+ <div><p class="op-manual-title">Quando usar</p><p>O botão de alternar vai no cabeçalho; a escolha entre as três opções cabe na tela de preferências.</p></div>
341
+ <div><p class="op-manual-title">Cuidados</p><p>Não force um tema: siga o do sistema até a pessoa escolher.</p></div>
342
+ </div>
343
+ <div class="op-demo">
344
+ <div class="op-demo-preview" id="d-tema">
345
+ <div class="op-btn-group" role="group" aria-label="Tema">
346
+ <button class="op-btn op-btn-secondary" type="button" data-op-theme="light"><i class="ph ph-sun"></i> Claro</button>
347
+ <button class="op-btn op-btn-secondary" type="button" data-op-theme="dark"><i class="ph ph-moon"></i> Escuro</button>
348
+ <button class="op-btn op-btn-secondary" type="button" data-op-theme="system"><i class="ph ph-desktop"></i> Sistema</button>
349
+ </div>
350
+ </div>
351
+ <div class="op-demo-bar">
352
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-tema"><i class="ph ph-code"></i> Ver código</button>
353
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-tema"><i class="ph ph-copy"></i> Copiar</button>
354
+ </div>
355
+ </div>
356
+ </section>
357
+
358
+ <section id="customizando" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
359
+ <div class="op-section-head">
360
+ <i class="ph ph-sliders"></i>
361
+ <h2>Customizando</h2>
362
+ </div>
363
+ <p class="op-text-muted op-text-sm">Tudo o que dá para mudar na biblioteca, de três jeitos: <strong>tokens CSS</strong> (variáveis <code>--op-*</code>), <strong>atributos no <code>&lt;html&gt;</code></strong> e <strong>JavaScript</strong> (<code>OptagoUI.customize()</code> e <code>OptagoUI.appearance()</code>). O painel <strong>Personalizar</strong> (o pincel no cabeçalho) e o editor de tokens desta página mexem nas mesmas coisas, e a escolha fica salva neste navegador.</p>
364
+ <div class="op-manual">
365
+ <div><p class="op-manual-title">Quando usar</p><p>Para aplicar a marca de um cliente ou de um sistema sem alterar a biblioteca, ou para deixar a pessoa ajustar o que lê melhor para ela (texto maior, painéis opacos, sem luzes em movimento).</p></div>
366
+ <div><p class="op-manual-title">Cuidados</p><p>Confira o contraste nos dois temas depois de trocar uma cor. Com uma cor livre, a biblioteca escolhe preto ou branco para o texto sobre ela e escurece a versão do tema claro até 4,5:1. Tokens de superfície mudam por tema: no editor, o valor vale só para o tema em uso.</p></div>
367
+ </div>
368
+
369
+ <h3 class="op-h4 op-mt-3 op-mb-1">As duas cores da marca</h3>
370
+ <p class="op-text-muted op-text-sm">A biblioteca tem duas cores de marca, chamadas pelo papel que cumprem, e não pela cor que têm hoje: a <strong>principal</strong> (<code>--op-main</code>) e a <strong>secundária</strong> (<code>--op-secondary</code>). Os nomes antigos, <code>--op-accent</code> e <code>--op-cyan</code>, continuam funcionando em qualquer CSS que você já tenha.</p>
371
+ <div class="op-table-wrap">
372
+ <table class="op-table op-table-hover op-mb-2">
373
+ <caption class="op-sr-only">Nomes das duas cores da marca</caption>
374
+ <thead><tr><th>Papel</th><th>Nome novo</th><th>Nome antigo (continua valendo)</th><th>Padrão</th><th>O que muda</th></tr></thead>
375
+ <tbody>
376
+ <tr><td>Principal</td><td><code>--op-main</code>, <code>-hover</code>, <code>-ink</code>, <code>-text</code></td><td><code>--op-accent</code>, <code>-hover</code>, <code>-ink</code>, <code>-text</code></td><td>#C0FF6B</td><td>Botão primário, foco, item ativo, brilho e luzes de fundo</td></tr>
377
+ <tr><td>Secundária</td><td><code>--op-secondary</code>, <code>-hover</code>, <code>-ink</code>, <code>-text</code></td><td><code>--op-cyan</code>, <code>-hover</code>, <code>-ink</code>, <code>-text</code></td><td>#6BE0FF</td><td>Detalhes, degradê, ondas do logo, badges e botões <code>op-btn-cyan</code></td></tr>
378
+ </tbody>
379
+ </table>
380
+ </div>
381
+ <div class="op-alert op-alert-info op-mb-2">
382
+ <i class="ph ph-arrows-clockwise"></i>
383
+ <div>
384
+ <p class="op-alert-title">Retrocompatibilidade</p>
385
+ <p class="op-alert-text">Definir o nome novo muda o antigo junto (<code>--op-accent</code> é só um apelido de <code>--op-main</code>), e definir o antigo continua valendo. <code>OptagoUI.customize({ accent, cyan })</code>, <code>OptagoUI.appearance({ accent, cyan })</code> e o atributo <code>data-op-accent</code> seguem aceitos e valem o mesmo que <code>main</code> e <code>secondary</code>. As classes <code>op-btn-cyan</code>, <code>op-badge-cyan</code> e <code>op-glow-cyan</code> mantêm o nome e seguem a cor secundária.</p>
386
+ </div>
387
+ </div>
388
+
389
+ <div class="op-demo">
390
+ <div class="op-demo-preview" id="d-customizando">
391
+ <div class="op-row">
392
+ <button class="op-btn op-btn-primary" type="button" data-op-customizer-open><i class="ph ph-paint-brush-broad"></i> Abrir o painel Personalizar</button>
393
+ <button class="op-btn op-btn-secondary" type="button" onclick="OptagoUI.appearance({ main: 'blue', secondary: 'rose', radius: 'soft', shape: 'round' })">Azul e rosa, cantos suaves</button>
394
+ <button class="op-btn op-btn-secondary" type="button" onclick="OptagoUI.appearance({ main: '#FF6B00', secondary: '#7C3AED', radius: 'sharp', font: 'mono' })">Laranja e violeta, retos, técnica</button>
395
+ <button class="op-btn op-btn-ghost" type="button" onclick="OptagoUI.resetAppearance()"><i class="ph ph-arrow-counter-clockwise"></i> Restaurar</button>
396
+ </div>
397
+ </div>
398
+ <div class="op-demo-bar">
399
+ <span class="op-text-muted op-text-xs"><i class="ph ph-cursor-click"></i> Ao vivo: o manual inteiro muda junto.</span>
400
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-customizando"><i class="ph ph-code"></i> Ver código</button>
401
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-customizando"><i class="ph ph-copy"></i> Copiar</button>
402
+ </div>
403
+ </div>
404
+
405
+ <h3 class="op-h4 op-mt-3 op-mb-1">Editor de tokens</h3>
406
+ <p class="op-text-muted op-text-sm">Um controle para cada token: as duas cores da marca, as cores de estado, as superfícies e o texto, os cantos, as fontes e as dimensões do layout. Mexa e veja a página inteira mudar; <strong>Restaurar tokens</strong> volta tudo. Para pôr o mesmo editor em outra página, use <code>&lt;div data-op-token-editor&gt;&lt;/div&gt;</code> (com <code>data-op-token-brand="off"</code> para tirar as cores da marca).</p>
407
+ <div class="op-demo">
408
+ <div class="op-demo-preview" id="d-editor-tokens">
409
+ <div data-op-token-editor></div>
410
+ </div>
411
+ <div class="op-demo-bar">
412
+ <span class="op-text-muted op-text-xs"><i class="ph ph-floppy-disk"></i> As escolhas ficam salvas neste navegador. O botão Copiar código do painel Personalizar gera o CSS.</span>
413
+ </div>
414
+ </div>
415
+
416
+ <h3 class="op-h4 op-mt-3 op-mb-1">Opções por atributo no &lt;html&gt;</h3>
417
+ <p class="op-text-muted op-text-sm">Nove opções nomeadas, sem escrever CSS. O padrão é não pôr o atributo. O painel Personalizar e <code>OptagoUI.appearance()</code> usam os mesmos atributos.</p>
418
+ <div class="op-table-wrap">
419
+ <table class="op-table op-table-hover op-mb-2">
420
+ <caption class="op-sr-only">Atributos de aparência do html</caption>
421
+ <thead><tr><th>Atributo</th><th>Valores</th><th>O que muda</th></tr></thead>
422
+ <tbody>
423
+ <tr><td><code>data-op-main</code></td><td><code>lime</code> (padrão), <code>cyan</code>, <code>blue</code>, <code>violet</code>, <code>rose</code>, <code>orange</code>, <code>teal</code>, <code>yellow</code>, <code>graphite</code></td><td>Cor principal, nos dois temas (<code>data-op-accent</code> é o nome antigo)</td></tr>
424
+ <tr><td><code>data-op-secondary</code></td><td><code>cyan</code> (padrão), e os mesmos nomes da principal</td><td>Cor secundária, nos dois temas</td></tr>
425
+ <tr><td><code>data-op-radius</code></td><td><code>sharp</code>, <code>soft</code>, padrão, <code>round</code></td><td>Cantos de cards, campos, menus e modais</td></tr>
426
+ <tr><td><code>data-op-shape</code></td><td>pílula (padrão), <code>round</code>, <code>square</code></td><td>Formato de botões, etiquetas, abas e paginação</td></tr>
427
+ <tr><td><code>data-op-font</code></td><td>Óptago (padrão), <code>system</code>, <code>serif</code>, <code>mono</code></td><td>Fontes, só com as do sistema (nada é baixado)</td></tr>
428
+ <tr><td><code>data-op-text</code></td><td><code>sm</code>, padrão, <code>lg</code>, <code>xl</code></td><td>Tamanho do texto da página inteira, de 87,5% a 125%</td></tr>
429
+ <tr><td><code>data-op-width</code></td><td><code>narrow</code>, padrão, <code>wide</code>, <code>full</code></td><td>Largura do conteúdo (<code>op-container</code>): 880px, a partir de 1100px, 1500px ou sem limite</td></tr>
430
+ <tr><td><code>data-op-aurora</code></td><td><code>off</code>, <code>soft</code>, padrão</td><td>Luzes que se movem no fundo</td></tr>
431
+ <tr><td><code>data-op-surface</code></td><td><code>glass</code> (padrão), <code>solid</code></td><td>Painéis translúcidos ou opacos</td></tr>
432
+ </tbody>
433
+ </table>
434
+ </div>
435
+ <p class="op-text-muted op-text-sm">Além dessas, o painel liga o <strong>modo compacto</strong> (<code>OptagoUI.setDensity('compact')</code>, veja <a href="preferencias.html#densidade">Modo compacto</a>), pausa as <strong>animações</strong> (<code>OptagoUI.setMotion(false)</code>) e escolhe o <strong>tema</strong> (<code>OptagoUI.setTheme()</code>).</p>
436
+
437
+ <h3 class="op-h4 op-mt-3 op-mb-1">Em código</h3>
438
+ <div class="op-grid-2 op-mb-2">
439
+ <div class="op-card">
440
+ <h4 class="op-h4 op-mb-1" style="font-size:.9375rem;"><i class="ph ph-code"></i> No seu CSS</h4>
441
+ <p class="op-text-muted op-text-sm op-mb-1">Fixo, definido uma vez. Depois do <code>ui-optago.css</code>.</p>
442
+ <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">:root {
443
+ --op-main: #FF6B00;
444
+ --op-secondary: #7C3AED;
445
+ --op-radius: 6px;
446
+ }
447
+ /* o nome antigo também vale: */
448
+ /* :root { --op-accent: #FF6B00; } */</pre>
449
+ </div>
450
+ <div class="op-card">
451
+ <h4 class="op-h4 op-mb-1" style="font-size:.9375rem;"><i class="ph ph-lightning"></i> Em JavaScript</h4>
452
+ <p class="op-text-muted op-text-sm op-mb-1">Dinâmico: por cliente, por tenant, pela pessoa.</p>
453
+ <pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">OptagoUI.customize({
454
+ main: '#FF6B00', // vira --op-main
455
+ secondary: '#7C3AED',
456
+ '--op-radius': '6px' // nome completo também
457
+ });
458
+ // salva no navegador e aceita tudo:
459
+ OptagoUI.appearance({
460
+ main: 'blue', radius: 'soft',
461
+ tokens: { '--op-info': '#1E90FF' }
462
+ });</pre>
463
+ </div>
464
+ </div>
465
+ <div class="op-code op-mb-2"><pre><code>&lt;!-- Fixo, no HTML: --&gt;
466
+ &lt;html lang="pt-BR" data-op-main="blue" data-op-secondary="rose" data-op-radius="soft" data-op-font="system"&gt;
467
+
468
+ // OptagoUI.appearance(): as opções em uso; resetAppearance(): volta ao que a página definiu
469
+ OptagoUI.appearance();
470
+ OptagoUI.appearance({ tokens: { dark: { '--op-bg': '#101820' }, light: { '--op-bg': '#FFFBE6' } } });
471
+ OptagoUI.resetAppearance(); // tudo
472
+ OptagoUI.resetAppearance('tokens'); // só os tokens soltos
473
+
474
+ // Painel e editor:
475
+ OptagoUI.customizer.open(); // ou &lt;button data-op-customizer-open&gt;
476
+ &lt;div data-op-token-editor&gt;&lt;/div&gt;</code></pre></div>
477
+
478
+ <h3 class="op-h4 op-mt-3 op-mb-1">Principais tokens</h3>
479
+ <div class="op-table-wrap">
480
+ <table class="op-table op-table-hover op-mb-2">
481
+ <caption class="op-sr-only">Principais tokens</caption>
482
+ <thead><tr><th>Variável</th><th>Padrão (escuro)</th><th>O que muda</th></tr></thead>
483
+ <tbody>
484
+ <tr><td><code>--op-main</code> (antes <code>--op-accent</code>)</td><td>#C0FF6B</td><td>Cor principal: botão primário, foco, item ativo, brilho</td></tr>
485
+ <tr><td><code>--op-secondary</code> (antes <code>--op-cyan</code>)</td><td>#6BE0FF</td><td>Cor secundária: detalhes, degradê, badges</td></tr>
486
+ <tr><td><code>--op-info / -success / -warning / -danger</code></td><td>azul / verde / laranja / vermelho</td><td>Cores de estado (badges, alerts, toasts)</td></tr>
487
+ <tr><td><code>--op-bg / -panel / -panel-2 / -panel-3</code></td><td>tons de grafite (escuro) / cinza-azulado (claro)</td><td>Superfícies: fundo da página, cards, sidebar</td></tr>
488
+ <tr><td><code>--op-border / -border-2</code></td><td>tons de cinza</td><td>Contornos e divisórias</td></tr>
489
+ <tr><td><code>--op-text / -strong / -muted</code></td><td>tons de cinza</td><td>Texto padrão, texto em destaque, texto apagado</td></tr>
490
+ <tr><td><code>--op-radius-sm / -radius / -radius-lg</code></td><td>12px / 18px / 24px</td><td>Arredondamento de botões, cards, inputs...</td></tr>
491
+ <tr><td><code>--op-font-display / -sans / -mono</code></td><td>Chakra Petch / Inter / JetBrains Mono</td><td>Títulos, texto corrido, dados técnicos</td></tr>
492
+ <tr><td><code>--op-header-h / -footer-h / -sidebar-w / -container-w</code></td><td>56px / 42px / 260px / 1100px</td><td>Dimensões do app shell e largura do conteúdo</td></tr>
493
+ <tr><td><code>--op-light-main-text / -grad-1 / -aurora-1 / -series-1</code></td><td>(só no tema claro)</td><td>Como a cor principal aparece no tema claro: texto, degradê, luzes e série. Os equivalentes da secundária são <code>--op-light-secondary-text / -grad-2 / -aurora-2 / -series-2</code></td></tr>
494
+ </tbody>
495
+ </table>
496
+ </div>
497
+ <p class="op-text-muted op-text-xs" style="margin:0;">
498
+ Lista completa: <code>tokens.json</code> (gerado do CSS) ou a seção <strong>1. TOKENS</strong> no topo de <code>ui-optago.css</code>. O tema
499
+ claro redefine boa parte desses tokens dentro de <code>html.light { ... }</code>: para mudar um token de superfície só no tema claro,
500
+ sobrescreva dentro de <code>html.light</code> (ou use o editor, que cuida disso por tema).
501
+ </p>
502
+ </section>
503
+
504
+ <section id="idioma" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
505
+ <div class="op-section-head">
506
+ <i class="ph ph-translate"></i>
507
+ <h2>Idioma e traduções</h2>
508
+ </div>
509
+ <p class="op-text-muted op-text-sm">Os textos que a biblioteca escreve (rótulos de botões, avisos, mensagens para leitor de tela) vêm de um dicionário em português. Para outro idioma, entregue as traduções com <code>OptagoUI.locale({...})</code> ou em um <code>&lt;script type="application/json" data-op-locale&gt;</code>. O formato das mensagens é o mesmo do CodeIgniter 4, com <code>{0}</code>, <code>{nome}</code> e plural, então um único arquivo de idioma serve ao PHP e à tela.</p>
510
+ <div class="op-manual">
511
+ <div><p class="op-manual-title">Quando usar</p><p>Em sistemas com mais de um idioma, ou para ajustar um texto da biblioteca ao vocabulário do produto.</p></div>
512
+ <div><p class="op-manual-title">Cuidados</p><p>Mantenha o <code>lang</code> do <code>&lt;html&gt;</code> correto: ele define plural, números e datas.</p></div>
513
+ </div>
514
+ <p class="op-text-sm">1. Copie <code>codeigniter/Language/</code> para <code>app/Language/</code>. Cada idioma tem um <code>OptagoUI.php</code>:</p>
515
+ <div class="op-code op-mb-2"><pre><code>return [
516
+ 'ui' =&gt; [
517
+ 'common' =&gt; ['close' =&gt; 'Fechar'],
518
+ 'table' =&gt; ['selected' =&gt; '{0, plural, one{# selecionada} other{# selecionadas}}'],
519
+ ],
520
+ ];</code></pre></div>
521
+ <p class="op-text-sm">2. No layout, entregue os textos do idioma atual. Não precisa de JavaScript inline:</p>
522
+ <div class="op-code op-mb-2"><pre><code>&lt;script type="application/json" data-op-locale&gt;&lt;?= json_encode(lang('OptagoUI.ui'), JSON_UNESCAPED_UNICODE | JSON_HEX_TAG) ?&gt;&lt;/script&gt;</code></pre></div>
523
+ <p class="op-text-sm">3. O mesmo texto serve no PHP, com <code>lang('OptagoUI.ui.table.selected', [3])</code>, e na tela, com <code>OptagoUI.t('table.selected', [3])</code>. Fora do CodeIgniter, use <code>locales/en.json</code> com <code>OptagoUI.locale()</code>.</p>
524
+ <div class="op-demo">
525
+ <div class="op-demo-preview" id="d-idioma">
526
+ <button class="op-btn op-btn-secondary" type="button" onclick="OptagoUI.locale({ table: { selected: '{0, plural, one{# selected} other{# selected}}' } }); OptagoUI.toast(OptagoUI.t('table.selected', [3]), 'info');"><i class="ph ph-translate"></i> Trocar um texto para inglês</button>
527
+ </div>
528
+ <div class="op-demo-bar">
529
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-idioma"><i class="ph ph-code"></i> Ver código</button>
530
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-idioma"><i class="ph ph-copy"></i> Copiar</button>
531
+ </div>
532
+ </div>
533
+ </section>
534
+
535
+ <section id="conteudo-dinamico" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
536
+ <div class="op-section-head">
537
+ <i class="ph ph-magic-wand"></i>
538
+ <h2>HTML inserido depois</h2>
539
+ </div>
540
+ <p class="op-text-muted op-text-sm">O que entra na página depois do carregamento (uma tela trocada por AJAX, uma linha nova na tabela) recebe sozinho o mesmo tratamento do resto: nomes acessíveis, papéis ARIA e os componentes que a biblioteca desenha. Não é preciso chamar nada. Para desligar, use <code>data-op-observe="off"</code> no <code>&lt;script&gt;</code> da biblioteca ou no trecho da página.</p>
541
+ <div class="op-manual">
542
+ <div><p class="op-manual-title">Quando usar</p><p>Em telas que trocam trechos por AJAX ou montam HTML por código.</p></div>
543
+ <div><p class="op-manual-title">Cuidados</p><p>Uma área redesenhada o tempo todo por outra biblioteca pode levar <code>data-op-observe="off"</code>.</p></div>
544
+ </div>
545
+ <div class="op-demo">
546
+ <div class="op-demo-preview" id="d-conteudo-dinamico">
547
+ <button class="op-btn op-btn-secondary" type="button" onclick="document.getElementById('dinamico-alvo').innerHTML = '&lt;div class=&quot;op-otp&quot; data-op-otp&gt;&lt;input type=&quot;text&quot; inputmode=&quot;numeric&quot; maxlength=&quot;4&quot; aria-label=&quot;PIN&quot;&gt;&lt;/div&gt; &lt;div class=&quot;op-chart-canvas op-chart-canvas-sm&quot; style=&quot;width:280px&quot;&gt;&lt;canvas data-op-chart=&quot;line&quot; data-op-labels=&quot;A,B,C,D,E,F&quot; data-op-data=&quot;3,8,5,12,9,15&quot; aria-label=&quot;Tendência de alta: 3, 8, 5, 12, 9, 15&quot;&gt;&lt;/canvas&gt;&lt;/div&gt;';"><i class="ph ph-plus"></i> Inserir um código de verificação e um gráfico</button>
548
+ <div class="op-row op-mt-2" id="dinamico-alvo"></div>
549
+ </div>
550
+ <div class="op-demo-bar">
551
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-conteudo-dinamico"><i class="ph ph-code"></i> Ver código</button>
552
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-conteudo-dinamico"><i class="ph ph-copy"></i> Copiar</button>
553
+ </div>
554
+ </div>
555
+ </section>
556
+
557
+ <!-- manual:pager -->
558
+ <nav class="op-chapter-pager" aria-label="Outros capítulos">
559
+ <span></span>
560
+ <a class="op-card op-card-hover op-chapter-pager-next" href="fundamentos.html" rel="next"><p class="op-stat-label">Próximo capítulo</p><p class="op-h4" style="margin:.25rem 0 0;">Fundamentos <i class="ph ph-arrow-right"></i></p></a>
561
+ </nav>
562
+ <!-- /manual:pager -->
563
+ </div>
564
+ </main>
565
+
566
+ <!-- FOOTER (fixo) -->
567
+ <footer class="op-footer">
568
+ <span>Biblioteca de interface<span class="op-desktop-only"> | <span data-op-version>v1.0.5</span> | <a href="projeto.html#licenca">Licença MIT</a></span></span>
569
+ <a class="bb-optago-credit" href="https://optago.com.br" target="_blank" rel="noopener">
570
+ <span class="bb-optago-mark op-oct"></span> Desenvolvido por Óptago
571
+ </a>
572
+ </footer>
573
+
574
+ <!-- Aparece depois que a página rola -->
575
+ <button class="op-fab op-back-top" type="button" data-op-back-top hidden><i class="ph ph-arrow-up"></i></button>
576
+ </div>
577
+
578
+ <!-- ==================== SIDEBAR DIREITA (fixa, colapsável) ==================== -->
579
+ <aside class="op-sidebar">
580
+ <div class="op-sidebar-header">
581
+ <span class="op-sidebar-header-text op-text-mono op-text-xs" style="font-weight:700; letter-spacing:.2em; color:var(--op-muted);">SUMÁRIO</span>
582
+ <button class="op-btn op-btn-icon op-btn-sm" data-op-sidebar-toggle>
583
+ <i class="ph ph-sidebar-simple"></i>
584
+ </button>
585
+ </div>
586
+ <nav class="op-sidebar-nav">
587
+ <!-- manual:nav -->
588
+ <a class="op-nav-item" href="../index.html" data-op-desc="início resumo visão geral manual números modelos"><i class="ph ph-house"></i><span class="op-nav-text">Início</span><span class="op-nav-tooltip">Início</span></a>
589
+ <details class="op-nav-group" open>
590
+ <summary class="op-nav-item" data-op-desc="instalar estrutura tema idioma primeiros passos"><i class="ph ph-rocket-launch"></i><span class="op-nav-text">Começando</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Começando</span></summary>
591
+ <div class="op-nav-sub">
592
+ <a class="op-nav-item" href="#instalacao" data-op-desc="instalar cdn npm script head começar"><span class="op-nav-text">Instalação</span></a>
593
+ <a class="op-nav-item" href="#convencoes" data-op-desc="nomes prefixo op is data-op eventos api padrão"><span class="op-nav-text">Convenções</span></a>
594
+ <a class="op-nav-item" href="#layout" data-op-desc="app shell header sidebar footer estrutura"><span class="op-nav-text">Layout</span></a>
595
+ <a class="op-nav-item" href="#tema" data-op-desc="claro escuro sistema dark light mode"><span class="op-nav-text">Tema</span></a>
596
+ <a class="op-nav-item" href="#customizando" data-op-desc="tokens variáveis css personalizar cores principal secundária main secondary accent cyan raio fonte tamanho texto largura luzes fundo painéis tema atributos html appearance customize painel pincel editor retrocompatibilidade"><span class="op-nav-text">Customizando</span></a>
597
+ <a class="op-nav-item" href="#idioma" data-op-desc="tradução locale i18n codeigniter lang inglês textos"><span class="op-nav-text">Idioma</span></a>
598
+ <a class="op-nav-item" href="#conteudo-dinamico" data-op-desc="ajax dinâmico refresh observer mutation"><span class="op-nav-text">HTML inserido depois</span></a>
599
+ </div>
600
+ </details>
601
+ <details class="op-nav-group">
602
+ <summary class="op-nav-item" data-op-desc="cores fontes tipografia texto base visual"><i class="ph ph-palette"></i><span class="op-nav-text">Fundamentos</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Fundamentos</span></summary>
603
+ <div class="op-nav-sub">
604
+ <a class="op-nav-item" href="fundamentos.html#cores" data-op-desc="paleta tokens verde-lima ciano tema escuro claro"><span class="op-nav-text">Cores</span></a>
605
+ <a class="op-nav-item" href="fundamentos.html#tipografia" data-op-desc="fontes títulos texto letras chakra inter mono"><span class="op-nav-text">Tipografia</span></a>
606
+ <a class="op-nav-item" href="fundamentos.html#texto-longo" data-op-desc="prose artigo truncar cortar reticências ver mais"><span class="op-nav-text">Texto longo</span></a>
607
+ <a class="op-nav-item" href="fundamentos.html#efeitos" data-op-desc="glow brilho fundo aurora"><span class="op-nav-text">Efeitos / Glow</span></a>
608
+ </div>
609
+ </details>
610
+ <details class="op-nav-group">
611
+ <summary class="op-nav-item" data-op-desc="botões menus atalhos comandos acionar"><i class="ph ph-hand-pointing"></i><span class="op-nav-text">Ações</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Ações</span></summary>
612
+ <div class="op-nav-sub">
613
+ <a class="op-nav-item" href="acoes.html#botoes" data-op-desc="button ações primário secundário ghost ícone loading grupo"><span class="op-nav-text">Botões</span></a>
614
+ <a class="op-nav-item" href="acoes.html#botoes-extras" data-op-desc="split dividido fab flutuante voltar ao topo"><span class="op-nav-text">Botões extras</span></a>
615
+ <a class="op-nav-item" href="acoes.html#dropdown" data-op-desc="menu suspenso opções ações"><span class="op-nav-text">Dropdown</span></a>
616
+ <a class="op-nav-item" href="acoes.html#menu-contexto" data-op-desc="botão direito context menu ações"><span class="op-nav-text">Menu de contexto</span></a>
617
+ <a class="op-nav-item" href="acoes.html#copiar" data-op-desc="clipboard área de transferência copy"><span class="op-nav-text">Copiar</span></a>
618
+ <a class="op-nav-item" href="acoes.html#paleta" data-op-desc="command palette ctrl k atalho busca rápida"><span class="op-nav-text">Paleta de comandos</span></a>
619
+ <a class="op-nav-item" href="acoes.html#atalhos" data-op-desc="shortcuts hotkeys teclas ajuda"><span class="op-nav-text">Atalhos de teclado</span></a>
620
+ </div>
621
+ </details>
622
+ <details class="op-nav-group">
623
+ <summary class="op-nav-item" data-op-desc="campos entrada validação cadastro editar"><i class="ph ph-textbox"></i><span class="op-nav-text">Formulários</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Formulários</span></summary>
624
+ <div class="op-nav-sub">
625
+ <a class="op-nav-item" href="formularios.html#formularios" data-op-desc="campos input select textarea checkbox radio switch range combobox senha validação"><span class="op-nav-text">Formulários</span></a>
626
+ <a class="op-nav-item" href="formularios.html#validacao" data-op-desc="erros resumo obrigatório required aria-invalid barra de ações salvar"><span class="op-nav-text">Validação</span></a>
627
+ <a class="op-nav-item" href="formularios.html#nao-salvo" data-op-desc="unsaved sair sem salvar aviso"><span class="op-nav-text">Alterações não salvas</span></a>
628
+ <a class="op-nav-item" href="formularios.html#mascaras" data-op-desc="cpf cnpj telefone cep moeda dinheiro formato input mask"><span class="op-nav-text">Máscaras</span></a>
629
+ <a class="op-nav-item" href="formularios.html#datas" data-op-desc="calendário date intervalo de até datepicker"><span class="op-nav-text">Data e período</span></a>
630
+ <a class="op-nav-item" href="formularios.html#otp" data-op-desc="otp pin sms token dois fatores 2fa"><span class="op-nav-text">Código de verificação</span></a>
631
+ <a class="op-nav-item" href="formularios.html#campos-extras" data-op-desc="número quantidade stepper seleção múltipla multiselect estrelas nota força da senha contador caracteres"><span class="op-nav-text">Campos extras</span></a>
632
+ <a class="op-nav-item" href="formularios.html#faixa" data-op-desc="range slider duas alças mínimo máximo preço"><span class="op-nav-text">Faixa de valores</span></a>
633
+ <a class="op-nav-item" href="formularios.html#chips" data-op-desc="chip tag etiqueta filtro multiseleção seleção múltipla"><span class="op-nav-text">Chips e tags</span></a>
634
+ <a class="op-nav-item" href="formularios.html#segmentado" data-op-desc="segmented radio cartões escolha plano alternar"><span class="op-nav-text">Segmentado e opções</span></a>
635
+ <a class="op-nav-item" href="formularios.html#upload" data-op-desc="arquivo anexo enviar arrastar soltar dropzone file"><span class="op-nav-text">Upload</span></a>
636
+ <a class="op-nav-item" href="formularios.html#repetidor" data-op-desc="repeater adicionar remover linhas itens dinâmicos"><span class="op-nav-text">Campos repetíveis</span></a>
637
+ <a class="op-nav-item" href="formularios.html#transferencia" data-op-desc="transfer dual listbox mover perfis permissões"><span class="op-nav-text">Lista de transferência</span></a>
638
+ <a class="op-nav-item" href="formularios.html#editor" data-op-desc="wysiwyg markdown html rich text formatação"><span class="op-nav-text">Editor de texto</span></a>
639
+ </div>
640
+ </details>
641
+ <details class="op-nav-group">
642
+ <summary class="op-nav-item" data-op-desc="tabelas cards gráficos listas mostrar informação"><i class="ph ph-database"></i><span class="op-nav-text">Dados</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Dados</span></summary>
643
+ <div class="op-nav-sub">
644
+ <a class="op-nav-item" href="dados.html#tabelas" data-op-desc="table dados linhas colunas tabulator ordenação"><span class="op-nav-text">Tabelas</span></a>
645
+ <a class="op-nav-item" href="dados.html#tabela-ordenavel" data-op-desc="sort ordenar cabeçalho fixo sticky expandir linha detalhe"><span class="op-nav-text">Tabela ordenável</span></a>
646
+ <a class="op-nav-item" href="dados.html#tabela-trabalho" data-op-desc="toolbar filtro busca selecionar linhas ações em lote bulk cartões celular"><span class="op-nav-text">Tabela de trabalho</span></a>
647
+ <a class="op-nav-item" href="dados.html#filtros" data-op-desc="filter chips limpar painel busca avançada"><span class="op-nav-text">Filtros ativos</span></a>
648
+ <a class="op-nav-item" href="dados.html#cards" data-op-desc="cartões kpi indicadores métricas stat"><span class="op-nav-text">Cards</span></a>
649
+ <a class="op-nav-item" href="dados.html#graficos" data-op-desc="chart chart.js chartjs canvas barras linha área rosca donut pizza radar eixos legenda tooltip séries tendência"><span class="op-nav-text">Gráficos</span></a>
650
+ <a class="op-nav-item" href="dados.html#definicoes" data-op-desc="dl detalhe rótulo valor chave ficha"><span class="op-nav-text">Lista de definição</span></a>
651
+ <a class="op-nav-item" href="dados.html#lista" data-op-desc="list group registros pessoas arquivos"><span class="op-nav-text">Lista de itens</span></a>
652
+ <a class="op-nav-item" href="dados.html#badges" data-op-desc="etiquetas tags status selo pill"><span class="op-nav-text">Badges</span></a>
653
+ <a class="op-nav-item" href="dados.html#avatares" data-op-desc="avatar usuário foto iniciais grupo"><span class="op-nav-text">Avatares</span></a>
654
+ <a class="op-nav-item" href="dados.html#timeline" data-op-desc="linha do tempo histórico eventos"><span class="op-nav-text">Timeline</span></a>
655
+ <a class="op-nav-item" href="dados.html#kanban" data-op-desc="quadro colunas cartões arrastar tarefas board"><span class="op-nav-text">Kanban</span></a>
656
+ <a class="op-nav-item" href="dados.html#calendario" data-op-desc="mês agenda eventos dias datas"><span class="op-nav-text">Calendário</span></a>
657
+ <a class="op-nav-item" href="dados.html#arvore" data-op-desc="tree pastas hierarquia categorias organograma"><span class="op-nav-text">Árvore</span></a>
658
+ <a class="op-nav-item" href="dados.html#galeria" data-op-desc="imagens fotos miniaturas lightbox visualizador"><span class="op-nav-text">Galeria</span></a>
659
+ <a class="op-nav-item" href="dados.html#carrossel" data-op-desc="carousel slides banner rotativo destaques"><span class="op-nav-text">Carrossel</span></a>
660
+ <a class="op-nav-item" href="dados.html#codigo" data-op-desc="code snippet comando pre copiar"><span class="op-nav-text">Bloco de código</span></a>
661
+ </div>
662
+ </details>
663
+ <details class="op-nav-group">
664
+ <summary class="op-nav-item" data-op-desc="menu abas trilha etapas localizar mover"><i class="ph ph-compass"></i><span class="op-nav-text">Navegação</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Navegação</span></summary>
665
+ <div class="op-nav-sub">
666
+ <a class="op-nav-item" href="navegacao.html#cabecalho-pagina" data-op-desc="page header título topo ações trilha"><span class="op-nav-text">Cabeçalho de página</span></a>
667
+ <a class="op-nav-item" href="navegacao.html#navegacao" data-op-desc="breadcrumb trilha paginação páginas"><span class="op-nav-text">Navegação</span></a>
668
+ <a class="op-nav-item" href="navegacao.html#tabs" data-op-desc="abas pills painéis vertical"><span class="op-nav-text">Tabs</span></a>
669
+ <a class="op-nav-item" href="navegacao.html#accordion" data-op-desc="sanfona faq perguntas expandir details"><span class="op-nav-text">Accordion</span></a>
670
+ <a class="op-nav-item" href="navegacao.html#stepper" data-op-desc="stepper wizard passos fluxo assistente cadastro"><span class="op-nav-text">Etapas</span></a>
671
+ <a class="op-nav-item" href="navegacao.html#submenu" data-op-desc="sidebar menu grupo descrição data-op-desc"><span class="op-nav-text">Submenu e busca</span></a>
672
+ <a class="op-nav-item" href="navegacao.html#navegacao-celular" data-op-desc="bottom nav tab bar rodapé mobile polegar"><span class="op-nav-text">Navegação inferior</span></a>
673
+ <a class="op-nav-item" href="navegacao.html#paineis" data-op-desc="split splitter divisor arrastar largura"><span class="op-nav-text">Painéis redimensionáveis</span></a>
674
+ </div>
675
+ </details>
676
+ <details class="op-nav-group">
677
+ <summary class="op-nav-item" data-op-desc="mensagens avisos erro sucesso carregando retorno"><i class="ph ph-bell-ringing"></i><span class="op-nav-text">Avisos e retorno</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Avisos e retorno</span></summary>
678
+ <div class="op-nav-sub">
679
+ <a class="op-nav-item" href="feedback.html#alertas" data-op-desc="avisos mensagens sucesso erro info atenção"><span class="op-nav-text">Alertas</span></a>
680
+ <a class="op-nav-item" href="feedback.html#avisos" data-op-desc="banner manutenção cookies lgpd consentimento sessão expirar offline conexão"><span class="op-nav-text">Banners e sessão</span></a>
681
+ <a class="op-nav-item" href="feedback.html#toasts" data-op-desc="notificações mensagens flash"><span class="op-nav-text">Toasts</span></a>
682
+ <a class="op-nav-item" href="feedback.html#toasts-acao" data-op-desc="desfazer undo snackbar promise carregando"><span class="op-nav-text">Toast com ação</span></a>
683
+ <a class="op-nav-item" href="feedback.html#conta-notificacoes" data-op-desc="sino alertas perfil usuário sair logout avatar"><span class="op-nav-text">Notificações e conta</span></a>
684
+ <a class="op-nav-item" href="feedback.html#progresso" data-op-desc="progress barra spinner skeleton carregando"><span class="op-nav-text">Progresso</span></a>
685
+ <a class="op-nav-item" href="feedback.html#carregamento" data-op-desc="loading overlay tela aguarde"><span class="op-nav-text">Carregamento</span></a>
686
+ <a class="op-nav-item" href="feedback.html#splash" data-op-desc="splash abertura logo animado octógono loader carregando página inicial marca"><span class="op-nav-text">Tela de abertura</span></a>
687
+ <a class="op-nav-item" href="feedback.html#estados" data-op-desc="vazio empty sem dados erro indisponível"><span class="op-nav-text">Estados</span></a>
688
+ </div>
689
+ </details>
690
+ <details class="op-nav-group">
691
+ <summary class="op-nav-item" data-op-desc="janelas modais balões por cima"><i class="ph ph-app-window"></i><span class="op-nav-text">Sobreposições</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Sobreposições</span></summary>
692
+ <div class="op-nav-sub">
693
+ <a class="op-nav-item" href="sobreposicoes.html#modais" data-op-desc="modal diálogo drawer janela popup"><span class="op-nav-text">Modais</span></a>
694
+ <a class="op-nav-item" href="sobreposicoes.html#confirmacao" data-op-desc="confirmar excluir apagar destrutiva diálogo"><span class="op-nav-text">Confirmação</span></a>
695
+ <a class="op-nav-item" href="sobreposicoes.html#popover" data-op-desc="balão flutuante ajuda conteúdo"><span class="op-nav-text">Popover</span></a>
696
+ <a class="op-nav-item" href="sobreposicoes.html#tooltips" data-op-desc="dica balão ajuda hover"><span class="op-nav-text">Tooltips</span></a>
697
+ <a class="op-nav-item" href="sobreposicoes.html#tour" data-op-desc="tour guiado onboarding passos"><span class="op-nav-text">Tour Guiado</span></a>
698
+ </div>
699
+ </details>
700
+ <details class="op-nav-group">
701
+ <summary class="op-nav-item" data-op-desc="telas prontas login erro site modelos"><i class="ph ph-browsers"></i><span class="op-nav-text">Páginas e modelos</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Páginas e modelos</span></summary>
702
+ <div class="op-nav-sub">
703
+ <a class="op-nav-item" href="paginas.html#paginas" data-op-desc="login entrar 404 500 erro manutenção"><span class="op-nav-text">Páginas prontas</span></a>
704
+ <a class="op-nav-item" href="paginas.html#resultado" data-op-desc="sucesso 403 500 acesso negado manutenção"><span class="op-nav-text">Páginas de resultado</span></a>
705
+ <a class="op-nav-item" href="paginas.html#blocos-site" data-op-desc="hero landing preços planos pricing rodapé footer"><span class="op-nav-text">Blocos de site</span></a>
706
+ <a class="op-nav-item" href="paginas.html#modelos" data-op-desc="templates dashboard painel exemplos prontos"><span class="op-nav-text">Modelos de tela</span></a>
707
+ </div>
708
+ </details>
709
+ <details class="op-nav-group">
710
+ <summary class="op-nav-item" data-op-desc="a11y preferências privacidade impressão compacto"><i class="ph ph-person-arms-spread"></i><span class="op-nav-text">Acessibilidade e preferências</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Acessibilidade e preferências</span></summary>
711
+ <div class="op-nav-sub">
712
+ <a class="op-nav-item" href="preferencias.html#acessibilidade" data-op-desc="a11y wcag teclado foco leitor de tela contraste"><span class="op-nav-text">Acessibilidade</span></a>
713
+ <a class="op-nav-item" href="preferencias.html#privacidade" data-op-desc="ocultar esconder saldo dinheiro valores sensíveis mascarar cpf olho"><span class="op-nav-text">Valores sensíveis</span></a>
714
+ <a class="op-nav-item" href="preferencias.html#densidade" data-op-desc="compacto denso espaçamento dense"><span class="op-nav-text">Modo compacto</span></a>
715
+ <a class="op-nav-item" href="preferencias.html#impressao" data-op-desc="print imprimir papel pdf"><span class="op-nav-text">Impressão</span></a>
716
+ </div>
717
+ </details>
718
+ <details class="op-nav-group">
719
+ <summary class="op-nav-item" data-op-desc="selo créditos empresa óptago"><i class="ph ph-buildings"></i><span class="op-nav-text">Sobre o projeto</span><i class="ph ph-caret-down op-nav-caret"></i><span class="op-nav-tooltip">Sobre o projeto</span></summary>
720
+ <div class="op-nav-sub">
721
+ <a class="op-nav-item" href="projeto.html#licenca" data-op-desc="mit licença open source código aberto livre gratuito copiar usar reproduzir modificar distribuir direitos copyright"><span class="op-nav-text">Licença</span></a>
722
+ <a class="op-nav-item" href="projeto.html#creditos" data-op-desc="selo rodapé desenvolvido por"><span class="op-nav-text">Créditos</span></a>
723
+ <a class="op-nav-item" href="projeto.html#sobre" data-op-desc="empresa contato óptago"><span class="op-nav-text">Sobre</span></a>
724
+ </div>
725
+ </details>
726
+ <!-- /manual:nav -->
727
+ </nav>
728
+ </aside>
729
+
730
+ </body>
731
+ </html>