ui-optago 1.2.3 → 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,850 @@
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>Modais, popovers, tooltips e tour guiado | UI Óptago</title>
10
+ <meta name="description" content="Modais, confirmações, drawers, popovers, tooltips e tour guiado: tudo o que aparece por cima da página, com foco e teclado tratados.">
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/sobreposicoes.html">
17
+ <link rel="alternate" hreflang="pt-BR" href="https://ui.optago.com.br/capitulos/sobreposicoes.html">
18
+ <link rel="alternate" hreflang="x-default" href="https://ui.optago.com.br/capitulos/sobreposicoes.html">
19
+ <link rel="prev" href="https://ui.optago.com.br/capitulos/feedback.html">
20
+ <link rel="next" href="https://ui.optago.com.br/capitulos/paginas.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/sobreposicoes.html">
25
+ <meta property="og:title" content="Modais, popovers, tooltips e tour guiado | UI Óptago">
26
+ <meta property="og:description" content="Modais, confirmações, drawers, popovers, tooltips e tour guiado: tudo o que aparece por cima da página, com foco e teclado tratados.">
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="Modais, popovers, tooltips e tour guiado | UI Óptago">
36
+ <meta name="twitter:description" content="Modais, confirmações, drawers, popovers, tooltips e tour guiado: tudo o que aparece por cima da página, com foco e teclado tratados.">
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/sobreposicoes.html#artigo",
69
+ "headline": "Sobreposições",
70
+ "name": "Modais, popovers, tooltips e tour guiado | UI Óptago",
71
+ "description": "Modais, confirmações, drawers, popovers, tooltips e tour guiado: tudo o que aparece por cima da página, com foco e teclado tratados.",
72
+ "url": "https://ui.optago.com.br/capitulos/sobreposicoes.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": "Sobreposições"
87
+ },
88
+ "position": 8
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 8: Sobreposições",
103
+ "item": "https://ui.optago.com.br/capitulos/sobreposicoes.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 8: Sobreposições</li>
193
+ </ul>
194
+ </nav>
195
+ <!-- /manual:trilha -->
196
+ <div class="op-chapter" id="cap-sobreposicoes">
197
+ <p class="op-chapter-kicker">Capítulo 8</p>
198
+ <h1 class="op-chapter-title">Sobreposições</h1>
199
+ <p class="op-chapter-text">O que aparece por cima da página: modais, confirmações, popovers, tooltips e o tour guiado.</p>
200
+ <!-- manual:toc -->
201
+ <ul class="op-chapter-toc" aria-label="Neste capítulo">
202
+ <li><a href="#modais">Modais</a></li>
203
+ <li><a href="#confirmacao">Confirmação</a></li>
204
+ <li><a href="#popover">Popover</a></li>
205
+ <li><a href="#tooltips">Tooltips</a></li>
206
+ <li><a href="#tour">Tour Guiado</a></li>
207
+ </ul>
208
+ <!-- /manual:toc -->
209
+ </div>
210
+
211
+ <section id="modais" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
212
+ <div class="op-section-head">
213
+ <i class="ph ph-app-window"></i>
214
+ <h2>Modais</h2>
215
+ </div>
216
+ <p class="op-text-muted op-text-sm"><code>op-modal</code> com <code>op-modal-box</code>. Abre com <code>data-op-modal-open="#id"</code> e fecha com <code>data-op-modal-close</code>, ESC ou clique fora. Variações: <code>op-modal-sm</code>, <code>-lg</code>, <code>op-modal-centered</code> e <code>op-modal-drawer</code> (painel lateral).</p>
217
+ <div class="op-manual">
218
+ <div><p class="op-manual-title">Quando usar</p><p>Para uma tarefa curta que pede atenção total. Conteúdo longo ou com vários passos merece uma página.</p></div>
219
+ <div><p class="op-manual-title">Cuidados</p><p>O foco entra no modal, fica preso nele e volta para quem abriu; o resto da página fica inerte. Dê um título com <code>op-modal-title</code>.</p></div>
220
+ </div>
221
+ <div class="op-demo">
222
+ <div class="op-demo-preview" id="d-modais">
223
+ <div class="op-row">
224
+ <button class="op-btn op-btn-primary" data-op-modal-open="#modalExemplo">
225
+ <i class="ph ph-arrows-out"></i> Padrão
226
+ </button>
227
+ <button class="op-btn op-btn-danger" data-op-modal-open="#modalConfirm">
228
+ <i class="ph ph-trash"></i> Confirmação
229
+ </button>
230
+ <button class="op-btn op-btn-ghost-success" data-op-modal-open="#modalSucesso">
231
+ <i class="ph ph-check-circle"></i> Centrado (sucesso)
232
+ </button>
233
+ <button class="op-btn op-btn-secondary" data-op-modal-open="#modalForm">
234
+ <i class="ph ph-user-plus"></i> Com formulário
235
+ </button>
236
+ <button class="op-btn op-btn-ghost-info" data-op-modal-open="#modalDrawer">
237
+ <i class="ph ph-sidebar"></i> Drawer lateral
238
+ </button>
239
+ </div>
240
+ </div>
241
+ <div class="op-demo-bar">
242
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-modal-src"><i class="ph ph-code"></i> Ver código</button>
243
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-modal-src"><i class="ph ph-copy"></i> Copiar</button>
244
+ </div>
245
+ </div>
246
+ </section>
247
+
248
+ <section id="confirmacao" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
249
+ <div class="op-section-head">
250
+ <i class="ph ph-shield-warning"></i>
251
+ <h2>Confirmação de ação destrutiva</h2>
252
+ </div>
253
+ <p class="op-text-muted op-text-sm">
254
+ Excluir, descartar ou sobrescrever pede confirmação antes. <code>OptagoUI.confirm(mensagem, opções)</code>
255
+ devolve uma <code>Promise</code> com <code>true</code> ou <code>false</code>. O foco começa em
256
+ “Cancelar”, e ESC ou um clique fora também cancelam. Sem escrever JS, use
257
+ <code>data-op-confirm="Mensagem"</code> em um <code>&lt;form&gt;</code> ou <code>&lt;a&gt;</code>.
258
+ </p>
259
+ <div class="op-manual">
260
+ <div><p class="op-manual-title">Quando usar</p><p>Antes de excluir, descartar ou sobrescrever algo que não dá para desfazer.</p></div>
261
+ <div><p class="op-manual-title">Cuidados</p><p>O foco começa em “Cancelar”. O título diz o que vai acontecer e o botão diz a ação (“Excluir”), não “OK”.</p></div>
262
+ </div>
263
+ <div class="op-demo">
264
+ <div class="op-demo-preview" id="d-confirmacao">
265
+ <div class="op-row">
266
+ <button class="op-btn op-btn-danger" type="button" onclick="OptagoUI.confirm('O projeto e todos os dados dele serão excluídos. Isso não pode ser desfeito.', { title: 'Excluir o projeto?', confirmText: 'Excluir' }).then(function (ok) { OptagoUI.toast(ok ? 'Projeto excluído.' : 'Nada foi excluído.', ok ? 'success' : 'info'); })">
267
+ <i class="ph ph-trash"></i> Excluir (via JS)
268
+ </button>
269
+ <form data-op-confirm="O rascunho será descartado." data-op-confirm-title="Descartar o rascunho?" data-op-confirm-button="Descartar" onsubmit="event.preventDefault(); OptagoUI.toast('Rascunho descartado.', 'success')">
270
+ <button class="op-btn op-btn-ghost-danger" type="submit">
271
+ <i class="ph ph-x-circle"></i> Descartar (via atributo no form)
272
+ </button>
273
+ </form>
274
+ </div>
275
+ </div>
276
+ <div class="op-demo-bar">
277
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-confirmacao"><i class="ph ph-code"></i> Ver código</button>
278
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-confirmacao"><i class="ph ph-copy"></i> Copiar</button>
279
+ </div>
280
+ </div>
281
+ </section>
282
+
283
+ <section id="popover" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
284
+ <div class="op-section-head">
285
+ <i class="ph ph-chat-centered-text"></i>
286
+ <h2>Popover</h2>
287
+ </div>
288
+ <p class="op-text-muted op-text-sm">Balão com conteúdo e ações, para quando o tooltip (só texto) não basta. Usa a API nativa do navegador: <code>popovertarget</code> no botão e <code>popover</code> no painel. Abre e fecha por clique, ESC e clique fora, sem JavaScript próprio.</p>
289
+ <div class="op-manual">
290
+ <div><p class="op-manual-title">Quando usar</p><p>Quando o tooltip não basta: explicação com link, pequenas ações.</p></div>
291
+ <div><p class="op-manual-title">Cuidados</p><p>Abre por clique, nunca só por hover.</p></div>
292
+ </div>
293
+ <div class="op-demo">
294
+ <div class="op-demo-preview" id="d-popover">
295
+ <button class="op-btn op-btn-secondary" type="button" popovertarget="pop-demo"><i class="ph ph-info"></i> Sobre este plano</button>
296
+ <div class="op-popover" id="pop-demo" popover>
297
+ <p class="op-popover-title">Plano Profissional</p>
298
+ <p style="margin:0 0 .75rem;">Até 20 usuários, relatórios e suporte em horário comercial.</p>
299
+ <a class="op-card-link" href="#popover">Ver detalhes <i class="ph ph-arrow-right"></i></a>
300
+ </div>
301
+ </div>
302
+ <div class="op-demo-bar">
303
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-popover"><i class="ph ph-code"></i> Ver código</button>
304
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-popover"><i class="ph ph-copy"></i> Copiar</button>
305
+ </div>
306
+ </div>
307
+ </section>
308
+
309
+ <section id="tooltips" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
310
+ <div class="op-section-head">
311
+ <i class="ph ph-chat-centered-text"></i>
312
+ <h2>Tooltips</h2>
313
+ </div>
314
+ <p class="op-text-muted op-text-sm"><code>data-op-tip="texto"</code> em qualquer elemento; <code>op-tip-bottom</code> abre para baixo.</p>
315
+ <div class="op-manual">
316
+ <div><p class="op-manual-title">Quando usar</p><p>Para dar nome a um botão só com ícone ou uma dica curta. Informação necessária não fica só no tooltip.</p></div>
317
+ <div><p class="op-manual-title">Cuidados</p><p>Aparece também com o foco do teclado e some com ESC. Em tela de toque não há hover: o controle precisa fazer sentido sem a dica.</p></div>
318
+ </div>
319
+ <div class="op-demo">
320
+ <div class="op-demo-preview" id="d-tooltips" style="padding-top:3.5rem;">
321
+ <div class="op-row">
322
+ <button class="op-btn op-btn-secondary" data-op-tip="Tooltip em CSS puro"><i class="ph ph-cursor"></i> Passe o mouse</button>
323
+ <button class="op-btn op-btn-icon" data-op-tip="Configurações"><i class="ph ph-gear"></i></button>
324
+ <span class="op-badge op-badge-brand" data-op-tip="Serviço saudável há 42 dias"><span class="op-dot op-dot-pulse"></span> Uptime</span>
325
+ </div>
326
+ </div>
327
+ <div class="op-demo-bar">
328
+ <button class="op-btn op-btn-ghost op-btn-sm" data-op-code="#d-tooltips"><i class="ph ph-code"></i> Ver código</button>
329
+ <button class="op-btn op-btn-primary op-btn-sm" data-op-copy="#d-tooltips"><i class="ph ph-copy"></i> Copiar</button>
330
+ </div>
331
+ </div>
332
+ </section>
333
+
334
+ <section id="tour" class="op-mb-4 op-reveal" style="scroll-margin-top:1rem;">
335
+ <div class="op-section-head">
336
+ <i class="ph ph-signpost"></i>
337
+ <h2>Tour Guiado</h2>
338
+ </div>
339
+ <p class="op-text-muted op-text-sm"><code>OptagoUI.tour([passos])</code> carrega o driver.js sob demanda, já com o tema. Passo sem <code>element</code> vira um aviso no centro da tela.</p>
340
+ <div class="op-manual">
341
+ <div><p class="op-manual-title">Quando usar</p><p>Na primeira visita a uma tela nova ou para apresentar uma mudança. Deixe a pessoa pular.</p></div>
342
+ <div><p class="op-manual-title">Cuidados</p><p>O tour não substitui uma tela clara: se precisa de muitos passos, simplifique a tela.</p></div>
343
+ </div>
344
+
345
+ <p style="color:var(--op-muted); margin-bottom:1.5rem; max-width:640px;">
346
+ Integração com <strong style="color:var(--op-text);">driver.js</strong> via
347
+ <code>OptagoUI.tour(steps, options?)</code>. A biblioteca é carregada do CDN
348
+ sob demanda (só quando o tour for iniciado) e o popover já sai estilizado com o
349
+ tema Óptago — escuro e claro, sem nenhuma configuração extra.
350
+ </p>
351
+
352
+ <!-- Demo ao vivo -->
353
+ <div class="op-card" style="margin-bottom:1.5rem; padding:1.25rem;">
354
+ <div style="display:flex; align-items:center; gap:.75rem; flex-wrap:wrap;">
355
+ <button id="btn-tour-demo" class="op-btn op-btn-primary" onclick="iniciarTourDemo()">
356
+ <i class="ph ph-play"></i> Iniciar tour de exemplo
357
+ </button>
358
+ <span style="color:var(--op-muted); font-size:.875rem;">
359
+ Percorre as principais seções desta documentação.
360
+ </span>
361
+ </div>
362
+ </div>
363
+
364
+ <!-- Como usar -->
365
+ <div class="op-grid-2" style="gap:1rem; margin-bottom:1.5rem;">
366
+ <div class="op-card" style="padding:1.25rem;">
367
+ <h3 class="op-h4" style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
368
+ <i class="ph ph-code" style="color:var(--op-accent);"></i> Uso básico
369
+ </h3>
370
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin:0;"><code>OptagoUI.tour([
371
+ {
372
+ element: '#meu-elemento',
373
+ popover: {
374
+ title: 'Bem-vindo!',
375
+ description: 'Este é o ponto de partida.',
376
+ }
377
+ },
378
+ {
379
+ element: '#outro-elemento',
380
+ popover: {
381
+ title: 'Passo 2',
382
+ description: 'Continue por aqui.',
383
+ }
384
+ },
385
+ // step sem element = modal centralizado
386
+ {
387
+ popover: {
388
+ title: 'Pronto!',
389
+ description: 'Tour concluído com sucesso.',
390
+ }
391
+ }
392
+ ]).then(function(d) {
393
+ // d = instância driver.js (opcional)
394
+ });</code></pre>
395
+ </div>
396
+ <div class="op-card" style="padding:1.25rem;">
397
+ <h3 class="op-h4" style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
398
+ <i class="ph ph-sliders" style="color:var(--op-accent);"></i> Opções
399
+ </h3>
400
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin:0;"><code>OptagoUI.tour(steps, {
401
+ // Padrões já configurados pelo OptagoUI:
402
+ animate: true,
403
+ smoothScroll: true,
404
+ showProgress: true,
405
+ progressText: '{{current}} de {{total}}',
406
+ nextBtnText: 'Próximo →',
407
+ prevBtnText: '← Anterior',
408
+ doneBtnText: 'Concluir',
409
+
410
+ // Qualquer opção nativa do driver.js:
411
+ allowClose: true, // fecha com ESC/clique no overlay
412
+ onDestroyed: function() {
413
+ console.log('tour encerrado');
414
+ }
415
+ });</code></pre>
416
+ <p style="font-size:.8125rem; color:var(--op-muted); margin-top:.75rem; margin-bottom:0;">
417
+ Todas as opções nativas do
418
+ <a href="https://driverjs.com/docs/configuration" target="_blank" rel="noopener">driver.js</a>
419
+ são aceitas e passadas diretamente à instância.
420
+ </p>
421
+ </div>
422
+ </div>
423
+
424
+ <!-- Tabela de referência dos steps -->
425
+ <h3 class="op-h4" style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Estrutura de um step</h3>
426
+ <div style="overflow-x:auto; margin-bottom:1.5rem;">
427
+ <table class="op-table op-table-hover" style="font-size:.875rem;">
428
+ <thead>
429
+ <tr><th>Propriedade</th><th>Tipo</th><th>Descrição</th></tr>
430
+ </thead>
431
+ <tbody>
432
+ <tr><td><code>element</code></td><td>string</td><td>Seletor CSS do elemento a destacar (omita para um modal genérico centralizado)</td></tr>
433
+ <tr><td><code>popover.title</code></td><td>string</td><td>Título do popover (aceita HTML)</td></tr>
434
+ <tr><td><code>popover.description</code></td><td>string</td><td>Corpo do popover (aceita HTML)</td></tr>
435
+ <tr><td><code>popover.side</code></td><td>string</td><td>Lado de abertura: <code>top</code> <code>bottom</code> <code>left</code> <code>right</code> (padrão: automático)</td></tr>
436
+ <tr><td><code>popover.align</code></td><td>string</td><td>Alinhamento: <code>start</code> <code>center</code> <code>end</code></td></tr>
437
+ <tr><td><code>onHighlightStarted</code></td><td>function</td><td>Callback antes de destacar o elemento</td></tr>
438
+ <tr><td><code>onHighlighted</code></td><td>function</td><td>Callback após destacar o elemento</td></tr>
439
+ <tr><td><code>onDeselected</code></td><td>function</td><td>Callback ao sair do step</td></tr>
440
+ </tbody>
441
+ </table>
442
+ </div>
443
+
444
+ <!-- Destaque simples de um elemento -->
445
+ <h3 class="op-h4" style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Destaque avulso (sem tour)</h3>
446
+ <p style="color:var(--op-muted); font-size:.875rem; margin-bottom:.75rem;">
447
+ Para destacar um único elemento sem navegar por steps, passe um array de um único step.
448
+ O driver.js também expõe <code>highlight()</code> nativamente se você precisar da instância.
449
+ </p>
450
+ <pre style="background:var(--op-panel-3); border-radius:var(--op-radius-sm); padding:1rem; font-size:.8125rem; overflow-x:auto; margin-bottom:1.5rem;"><code>OptagoUI.tour([
451
+ {
452
+ element: '#meu-campo',
453
+ popover: { title: 'Atenção', description: 'Preencha este campo.' }
454
+ }
455
+ ]);</code></pre>
456
+ </section>
457
+
458
+ <script>
459
+ function iniciarTourDemo() {
460
+ OptagoUI.tour([
461
+ {
462
+ popover: {
463
+ title: '<i class="ph ph-hand-waving"></i> Bem-vindo à UI Óptago!',
464
+ description: 'Este tour percorre os principais componentes da biblioteca. Use os botões abaixo para navegar.'
465
+ }
466
+ },
467
+ {
468
+ element: '#botoes',
469
+ popover: {
470
+ title: '<i class="ph ph-cursor-click"></i> Botões',
471
+ description: 'Variações de estilo, tamanho e estado — incluindo <code>is-loading</code> para ações assíncronas.',
472
+ side: 'top'
473
+ }
474
+ },
475
+ {
476
+ element: '#formularios',
477
+ popover: {
478
+ title: '<i class="ph ph-text-aa"></i> Formulários',
479
+ description: 'Inputs, selects, switches, ranges e estados de validação (<code>is-error</code>, <code>is-success</code>).',
480
+ side: 'top'
481
+ }
482
+ },
483
+ {
484
+ element: '#alertas',
485
+ popover: {
486
+ title: '<i class="ph ph-warning"></i> Alertas',
487
+ description: 'Quatro variantes semânticas (info, success, warning, danger) com fundo sólido em ambos os temas.',
488
+ side: 'top'
489
+ }
490
+ },
491
+ {
492
+ element: '#toasts',
493
+ popover: {
494
+ title: '<i class="ph ph-bell-ringing"></i> Toasts',
495
+ description: 'Notificações temporárias disparadas via <code>OptagoUI.toast(msg, tipo)</code>.',
496
+ side: 'top'
497
+ }
498
+ },
499
+ {
500
+ element: '#modais',
501
+ popover: {
502
+ title: '<i class="ph ph-square-half"></i> Modais',
503
+ description: 'Diálogos com tamanhos (sm/lg), drawer lateral e animação de entrada/saída.',
504
+ side: 'top'
505
+ }
506
+ },
507
+ {
508
+ element: '#customizando',
509
+ popover: {
510
+ title: '<i class="ph ph-sliders"></i> Customizando',
511
+ description: 'Sobreponha qualquer token com <code>OptagoUI.customize()</code> — ideal para cor por sistema ou tenant vinda de uma API.',
512
+ side: 'top'
513
+ }
514
+ },
515
+ {
516
+ element: '#tour',
517
+ popover: {
518
+ title: '<i class="ph ph-signpost"></i> Tour Guiado',
519
+ description: 'É aqui que você está! <code>OptagoUI.tour(steps)</code> carrega o driver.js sob demanda e já aplica o tema Óptago.',
520
+ side: 'top'
521
+ }
522
+ },
523
+ {
524
+ popover: {
525
+ title: '<i class="ph ph-check-circle"></i> Tour concluído!',
526
+ description: 'Esses são os componentes principais. Explore o restante da documentação à vontade.'
527
+ }
528
+ }
529
+ ]);
530
+ }
531
+ </script>
532
+
533
+ <!-- manual:pager -->
534
+ <nav class="op-chapter-pager" aria-label="Outros capítulos">
535
+ <a class="op-card op-card-hover op-chapter-pager-prev" href="feedback.html" rel="prev"><p class="op-stat-label">Capítulo anterior</p><p class="op-h4" style="margin:.25rem 0 0;"><i class="ph ph-arrow-left"></i> Avisos e retorno</p></a>
536
+ <a class="op-card op-card-hover op-chapter-pager-next" href="paginas.html" rel="next"><p class="op-stat-label">Próximo capítulo</p><p class="op-h4" style="margin:.25rem 0 0;">Páginas e modelos <i class="ph ph-arrow-right"></i></p></a>
537
+ </nav>
538
+ <!-- /manual:pager -->
539
+ </div>
540
+ </main>
541
+
542
+ <!-- FOOTER (fixo) -->
543
+ <footer class="op-footer">
544
+ <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>
545
+ <a class="bb-optago-credit" href="https://optago.com.br" target="_blank" rel="noopener">
546
+ <span class="bb-optago-mark op-oct"></span> Desenvolvido por Óptago
547
+ </a>
548
+ </footer>
549
+
550
+ <!-- Aparece depois que a página rola -->
551
+ <button class="op-fab op-back-top" type="button" data-op-back-top hidden><i class="ph ph-arrow-up"></i></button>
552
+ </div>
553
+
554
+ <!-- ==================== SIDEBAR DIREITA (fixa, colapsável) ==================== -->
555
+ <aside class="op-sidebar">
556
+ <div class="op-sidebar-header">
557
+ <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>
558
+ <button class="op-btn op-btn-icon op-btn-sm" data-op-sidebar-toggle>
559
+ <i class="ph ph-sidebar-simple"></i>
560
+ </button>
561
+ </div>
562
+ <nav class="op-sidebar-nav">
563
+ <!-- manual:nav -->
564
+ <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>
565
+ <details class="op-nav-group">
566
+ <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>
567
+ <div class="op-nav-sub">
568
+ <a class="op-nav-item" href="comecando.html#instalacao" data-op-desc="instalar cdn npm script head começar"><span class="op-nav-text">Instalação</span></a>
569
+ <a class="op-nav-item" href="comecando.html#convencoes" data-op-desc="nomes prefixo op is data-op eventos api padrão"><span class="op-nav-text">Convenções</span></a>
570
+ <a class="op-nav-item" href="comecando.html#layout" data-op-desc="app shell header sidebar footer estrutura"><span class="op-nav-text">Layout</span></a>
571
+ <a class="op-nav-item" href="comecando.html#tema" data-op-desc="claro escuro sistema dark light mode"><span class="op-nav-text">Tema</span></a>
572
+ <a class="op-nav-item" href="comecando.html#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>
573
+ <a class="op-nav-item" href="comecando.html#idioma" data-op-desc="tradução locale i18n codeigniter lang inglês textos"><span class="op-nav-text">Idioma</span></a>
574
+ <a class="op-nav-item" href="comecando.html#conteudo-dinamico" data-op-desc="ajax dinâmico refresh observer mutation"><span class="op-nav-text">HTML inserido depois</span></a>
575
+ </div>
576
+ </details>
577
+ <details class="op-nav-group">
578
+ <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>
579
+ <div class="op-nav-sub">
580
+ <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>
581
+ <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>
582
+ <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>
583
+ <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>
584
+ </div>
585
+ </details>
586
+ <details class="op-nav-group">
587
+ <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>
588
+ <div class="op-nav-sub">
589
+ <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>
590
+ <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>
591
+ <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>
592
+ <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>
593
+ <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>
594
+ <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>
595
+ <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>
596
+ </div>
597
+ </details>
598
+ <details class="op-nav-group">
599
+ <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>
600
+ <div class="op-nav-sub">
601
+ <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>
602
+ <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>
603
+ <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>
604
+ <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>
605
+ <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>
606
+ <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>
607
+ <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>
608
+ <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>
609
+ <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>
610
+ <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>
611
+ <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>
612
+ <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>
613
+ <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>
614
+ <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>
615
+ </div>
616
+ </details>
617
+ <details class="op-nav-group">
618
+ <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>
619
+ <div class="op-nav-sub">
620
+ <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>
621
+ <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>
622
+ <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>
623
+ <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>
624
+ <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>
625
+ <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>
626
+ <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>
627
+ <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>
628
+ <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>
629
+ <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>
630
+ <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>
631
+ <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>
632
+ <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>
633
+ <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>
634
+ <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>
635
+ <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>
636
+ <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>
637
+ </div>
638
+ </details>
639
+ <details class="op-nav-group">
640
+ <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>
641
+ <div class="op-nav-sub">
642
+ <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>
643
+ <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>
644
+ <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>
645
+ <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>
646
+ <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>
647
+ <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>
648
+ <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>
649
+ <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>
650
+ </div>
651
+ </details>
652
+ <details class="op-nav-group">
653
+ <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>
654
+ <div class="op-nav-sub">
655
+ <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>
656
+ <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>
657
+ <a class="op-nav-item" href="feedback.html#toasts" data-op-desc="notificações mensagens flash"><span class="op-nav-text">Toasts</span></a>
658
+ <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>
659
+ <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>
660
+ <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>
661
+ <a class="op-nav-item" href="feedback.html#carregamento" data-op-desc="loading overlay tela aguarde"><span class="op-nav-text">Carregamento</span></a>
662
+ <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>
663
+ <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>
664
+ </div>
665
+ </details>
666
+ <details class="op-nav-group" open>
667
+ <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>
668
+ <div class="op-nav-sub">
669
+ <a class="op-nav-item" href="#modais" data-op-desc="modal diálogo drawer janela popup"><span class="op-nav-text">Modais</span></a>
670
+ <a class="op-nav-item" href="#confirmacao" data-op-desc="confirmar excluir apagar destrutiva diálogo"><span class="op-nav-text">Confirmação</span></a>
671
+ <a class="op-nav-item" href="#popover" data-op-desc="balão flutuante ajuda conteúdo"><span class="op-nav-text">Popover</span></a>
672
+ <a class="op-nav-item" href="#tooltips" data-op-desc="dica balão ajuda hover"><span class="op-nav-text">Tooltips</span></a>
673
+ <a class="op-nav-item" href="#tour" data-op-desc="tour guiado onboarding passos"><span class="op-nav-text">Tour Guiado</span></a>
674
+ </div>
675
+ </details>
676
+ <details class="op-nav-group">
677
+ <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>
678
+ <div class="op-nav-sub">
679
+ <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>
680
+ <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>
681
+ <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>
682
+ <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>
683
+ </div>
684
+ </details>
685
+ <details class="op-nav-group">
686
+ <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>
687
+ <div class="op-nav-sub">
688
+ <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>
689
+ <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>
690
+ <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>
691
+ <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>
692
+ </div>
693
+ </details>
694
+ <details class="op-nav-group">
695
+ <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>
696
+ <div class="op-nav-sub">
697
+ <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>
698
+ <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>
699
+ <a class="op-nav-item" href="projeto.html#sobre" data-op-desc="empresa contato óptago"><span class="op-nav-text">Sobre</span></a>
700
+ </div>
701
+ </details>
702
+ <!-- /manual:nav -->
703
+ </nav>
704
+ </aside>
705
+
706
+ <!-- ==================== MODAIS DE EXEMPLO ==================== -->
707
+ <div id="d-modal-src">
708
+ <div class="op-modal" id="modalExemplo">
709
+ <div class="op-modal-box">
710
+ <div class="op-modal-header">
711
+ <h3 class="op-modal-title">
712
+ <span class="op-oct" style="width:36px; height:36px; background:color-mix(in srgb, var(--op-accent) 14%, transparent); display:flex; align-items:center; justify-content:center;">
713
+ <i class="ph ph-rocket-launch op-text-accent" style="font-size:1.125rem;"></i>
714
+ </span>
715
+ Nova Instância
716
+ </h3>
717
+ <button class="op-modal-close" data-op-modal-close><i class="ph ph-x"></i></button>
718
+ </div>
719
+ <div class="op-modal-body">
720
+ <p class="op-text-sm">Confirme as configurações antes de provisionar o servidor na rede principal da Óptago.</p>
721
+ <div class="op-card op-text-mono op-text-sm" style="padding:1rem; border-radius:var(--op-radius);">
722
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Região:</span> <strong>sa-east-1</strong></div>
723
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Tipo:</span> <strong>t3.micro</strong></div>
724
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Storage:</span> <strong>20GB SSD</strong></div>
725
+ </div>
726
+ </div>
727
+ <div class="op-modal-footer">
728
+ <button class="op-btn op-btn-secondary" data-op-modal-close><i class="ph ph-x"></i> Cancelar</button>
729
+ <button class="op-btn op-btn-primary" data-op-modal-close onclick="OptagoUI.toast('Servidor provisionado com sucesso!', 'success')"><i class="ph ph-check"></i> Confirmar</button>
730
+ </div>
731
+ </div>
732
+ </div>
733
+
734
+ <!-- Modal centrado (confirmação) -->
735
+ <div class="op-modal op-modal-centered op-modal-sm" id="modalConfirm">
736
+ <div class="op-modal-box">
737
+ <div class="op-modal-body">
738
+ <div class="op-modal-icon is-danger"><i class="ph ph-warning-octagon"></i></div>
739
+ <h3 style="margin-bottom:.25rem;">Excluir instância?</h3>
740
+ <p class="op-text-muted op-text-sm" style="margin:0;">Essa ação é <strong>irreversível</strong>. Todos os dados da instância <code>srv-prod-01</code> serão apagados.</p>
741
+ </div>
742
+ <div class="op-modal-footer">
743
+ <button class="op-btn op-btn-secondary" data-op-modal-close><i class="ph ph-x"></i> Cancelar</button>
744
+ <button class="op-btn op-btn-danger" data-op-modal-close onclick="OptagoUI.toast('Instância excluída.', 'error')"><i class="ph ph-trash"></i> Excluir</button>
745
+ </div>
746
+ </div>
747
+ </div>
748
+
749
+ <!-- Modal centrado (sucesso) -->
750
+ <div class="op-modal op-modal-centered" id="modalSucesso">
751
+ <div class="op-modal-box">
752
+ <div class="op-modal-body">
753
+ <div class="op-modal-icon is-success"><i class="ph-bold ph-check"></i></div>
754
+ <h3 style="margin-bottom:.25rem;">Tudo certo!</h3>
755
+ <p class="op-text-muted op-text-sm" style="margin:0;">Seu pagamento foi confirmado e a fatura enviada para <strong>cowork@optago.com.br</strong>.</p>
756
+ </div>
757
+ <div class="op-modal-footer">
758
+ <button class="op-btn op-btn-primary" data-op-modal-close><i class="ph ph-arrow-right"></i> Continuar</button>
759
+ </div>
760
+ </div>
761
+ </div>
762
+
763
+ <!-- Modal com formulário -->
764
+ <div class="op-modal" id="modalForm">
765
+ <div class="op-modal-box">
766
+ <div class="op-modal-header">
767
+ <h3 class="op-modal-title"><i class="ph ph-user-plus op-text-accent"></i> Novo usuário</h3>
768
+ <button class="op-modal-close" data-op-modal-close><i class="ph ph-x"></i></button>
769
+ </div>
770
+ <div class="op-modal-body op-stack">
771
+ <div class="op-field">
772
+ <label class="op-label" for="m-nome">Nome <span class="req">*</span></label>
773
+ <input class="op-input" id="m-nome" type="text" placeholder="Nome completo">
774
+ </div>
775
+ <div class="op-field">
776
+ <label class="op-label" for="m-email">E-mail <span class="req">*</span></label>
777
+ <div class="op-input-icon">
778
+ <i class="ph ph-envelope"></i>
779
+ <input class="op-input" id="m-email" type="email" placeholder="usuario@empresa.com.br">
780
+ </div>
781
+ </div>
782
+ <div class="op-field">
783
+ <label class="op-label" for="m-funcao">Função</label>
784
+ <select class="op-select" id="m-funcao">
785
+ <option>Administrador</option>
786
+ <option>Desenvolvedor</option>
787
+ <option>Suporte</option>
788
+ </select>
789
+ </div>
790
+ <label class="op-switch"><input type="checkbox" checked> <span>Enviar convite por e-mail</span></label>
791
+ </div>
792
+ <div class="op-modal-footer">
793
+ <button class="op-btn op-btn-secondary" data-op-modal-close><i class="ph ph-x"></i> Cancelar</button>
794
+ <button class="op-btn op-btn-primary" data-op-modal-close onclick="OptagoUI.toast('Usuário criado com sucesso!', 'success')"><i class="ph ph-check"></i> Criar usuário</button>
795
+ </div>
796
+ </div>
797
+ </div>
798
+
799
+ <!-- Drawer lateral (abre pela esquerda; some op-modal-drawer-end para abrir pela direita) -->
800
+ <div class="op-modal op-modal-drawer" id="modalDrawer">
801
+ <div class="op-modal-box">
802
+ <div class="op-modal-header">
803
+ <h3 class="op-modal-title"><i class="ph ph-cube op-text-accent"></i> Detalhes da instância</h3>
804
+ <button class="op-modal-close" data-op-modal-close><i class="ph ph-x"></i></button>
805
+ </div>
806
+ <div class="op-modal-body op-stack">
807
+ <div class="op-row" style="justify-content:space-between;">
808
+ <div>
809
+ <strong style="color:var(--op-strong); font-family:var(--op-font-display); font-size:1.125rem;">srv-prod-01</strong><br>
810
+ <span class="op-text-mono op-text-xs op-text-muted">i-0f2e88c1a9b3</span>
811
+ </div>
812
+ <span class="op-badge op-badge-success op-badge-pill"><span class="op-dot op-dot-pulse"></span> Rodando</span>
813
+ </div>
814
+ <hr class="op-divider" style="margin:.25rem 0;">
815
+ <div>
816
+ <div class="op-progress-header"><span class="lbl">CPU</span><span class="val">64%</span></div>
817
+ <div class="op-progress"><div class="op-progress-bar is-success" style="width:64%"></div></div>
818
+ </div>
819
+ <div>
820
+ <div class="op-progress-header"><span class="lbl">Memória</span><span class="val">81%</span></div>
821
+ <div class="op-progress"><div class="op-progress-bar is-warning" style="width:81%"></div></div>
822
+ </div>
823
+ <div class="op-card op-text-mono op-text-sm" style="padding:1rem; border-radius:var(--op-radius); box-shadow:none;">
824
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Região:</span> <strong>sa-east-1</strong></div>
825
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Tipo:</span> <strong>t3.medium</strong></div>
826
+ <div style="display:flex; justify-content:space-between; padding:.25rem 0;"><span class="op-text-muted">Uptime:</span> <strong>42 dias</strong></div>
827
+ </div>
828
+ <ul class="op-timeline" style="margin-top:.5rem;">
829
+ <li class="op-timeline-item">
830
+ <span class="op-timeline-marker is-brand is-pulse"></span>
831
+ <span class="op-timeline-time">14:32</span>
832
+ <p class="op-timeline-title" style="font-size:.8125rem;">Deploy v3.4.0 iniciado</p>
833
+ </li>
834
+ <li class="op-timeline-item">
835
+ <span class="op-timeline-marker is-success"></span>
836
+ <span class="op-timeline-time">13:58</span>
837
+ <p class="op-timeline-title" style="font-size:.8125rem;">Backup concluído</p>
838
+ </li>
839
+ </ul>
840
+ </div>
841
+ <div class="op-modal-footer">
842
+ <button class="op-btn op-btn-ghost-danger"><i class="ph ph-power"></i> Desligar</button>
843
+ <button class="op-btn op-btn-primary" data-op-modal-close><i class="ph ph-x"></i> Fechar</button>
844
+ </div>
845
+ </div>
846
+ </div>
847
+ </div>
848
+
849
+ </body>
850
+ </html>