ui-optago 1.2.2 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -1
- package/index.html +298 -5
- package/llms.txt +17 -6
- package/package.json +1 -1
- package/ui-optago.css +96 -3
- package/ui-optago.js +68 -3
package/README.md
CHANGED
|
@@ -65,7 +65,7 @@ Bloco pronto para o rodapé de qualquer site feito pela Óptago, mesmo sites que
|
|
|
65
65
|
</script>
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
Fixe a versão em produção: `https://unpkg.com/ui-optago@1.2.
|
|
68
|
+
Fixe a versão em produção: `https://unpkg.com/ui-optago@1.2.3/optago-credit-dark.html` (troque `dark` por `light` conforme o caso). Também funciona via jsDelivr: `https://cdn.jsdelivr.net/npm/ui-optago/optago-credit-dark.html`.
|
|
69
69
|
|
|
70
70
|
**Ou copie o arquivo direto** para o seu projeto e sirva/inclua localmente (ex. `include` no PHP, import estático, etc.); cada arquivo já vem com essas instruções comentadas no topo.
|
|
71
71
|
|
|
@@ -134,6 +134,14 @@ OptagoUI.openModal('#meuModal');
|
|
|
134
134
|
OptagoUI.closeModal('#meuModal');
|
|
135
135
|
OptagoUI.setTheme('light'); // 'dark' | 'light'
|
|
136
136
|
OptagoUI.toggleSidebar();
|
|
137
|
+
OptagoUI.customize({ accent: '#FF6B00', radius: '6px' }); // sobrescreve tokens (--op-*) em runtime
|
|
138
|
+
|
|
139
|
+
// Tour guiado (carrega driver.js do CDN sob demanda, já com tema Óptago)
|
|
140
|
+
OptagoUI.tour([
|
|
141
|
+
{ element: '#meu-elemento', popover: { title: 'Passo 1', description: 'Texto explicativo.' } },
|
|
142
|
+
{ element: '#outro', popover: { title: 'Passo 2', description: 'Continue aqui.' } },
|
|
143
|
+
{ popover: { title: 'Pronto!', description: 'Tour concluído.' } } // sem element = modal central
|
|
144
|
+
]).then(d => { /* instância driver.js, opcional */ });
|
|
137
145
|
|
|
138
146
|
// Tabela avançada (carrega o Tabulator do CDN sob demanda, já com tema Óptago)
|
|
139
147
|
OptagoUI.tabulator('#minhaTabela', {
|
|
@@ -161,6 +169,16 @@ Personalize sobrescrevendo as variáveis no seu próprio CSS:
|
|
|
161
169
|
}
|
|
162
170
|
```
|
|
163
171
|
|
|
172
|
+
Ou em runtime via JS (ex.: cor por tenant/cliente vinda de uma API), sem precisar de `<style>` próprio:
|
|
173
|
+
|
|
174
|
+
```js
|
|
175
|
+
OptagoUI.customize({ accent: '#FF6B00', cyan: '#00B8D9', radius: '6px' });
|
|
176
|
+
// nomes curtos viram --op-*, mas o nome completo também funciona:
|
|
177
|
+
OptagoUI.customize({ '--op-accent': '#FF6B00' });
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
Lista completa de tokens e exemplos ao vivo: seção **Customizando** do [showcase](index.html#customizando).
|
|
181
|
+
|
|
164
182
|
Tema claro = classe `light` no `<html>` (gerenciada automaticamente pelo JS).
|
|
165
183
|
|
|
166
184
|
### Tema compartilhado entre subdomínios
|
package/index.html
CHANGED
|
@@ -122,8 +122,8 @@
|
|
|
122
122
|
<div class="op-demo-preview">
|
|
123
123
|
<p class="op-alert-title">Usar via CDN</p>
|
|
124
124
|
<p class="op-alert-text op-mb-1">Sem baixar nada, adicione as duas linhas ao <code><head></code>:</p>
|
|
125
|
-
<pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;"><link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.
|
|
126
|
-
<script src="https://unpkg.com/ui-optago@1.2.
|
|
125
|
+
<pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;"><link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.3/ui-optago.css">
|
|
126
|
+
<script src="https://unpkg.com/ui-optago@1.2.3/ui-optago.js"></script></pre>
|
|
127
127
|
</div>
|
|
128
128
|
</div>
|
|
129
129
|
</section>
|
|
@@ -1133,7 +1133,298 @@ OptagoUI.tabulator('#minhaTabela', {
|
|
|
1133
1133
|
</div>
|
|
1134
1134
|
</section>
|
|
1135
1135
|
|
|
1136
|
-
<!-- ==================== 20.
|
|
1136
|
+
<!-- ==================== 20. CUSTOMIZANDO ==================== -->
|
|
1137
|
+
<section id="customizando" class="op-mb-4" style="scroll-margin-top:1rem;">
|
|
1138
|
+
<div class="op-section-head">
|
|
1139
|
+
<i class="ph ph-sliders"></i>
|
|
1140
|
+
<h2>Customizando</h2>
|
|
1141
|
+
</div>
|
|
1142
|
+
<p class="op-text-muted op-mb-2">
|
|
1143
|
+
Toda a aparência (cores, raio de borda, sombras, fontes, dimensões do app shell...) vive em
|
|
1144
|
+
variáveis CSS (tokens) declaradas no <code>:root</code> de <code>ui-optago.css</code>. Não
|
|
1145
|
+
precisa editar o arquivo da lib: sobrescreva só as variáveis que quiser, depois de carregá-la.
|
|
1146
|
+
</p>
|
|
1147
|
+
|
|
1148
|
+
<div class="op-grid-2 op-mb-2">
|
|
1149
|
+
<div class="op-card">
|
|
1150
|
+
<h3 class="op-mb-1" style="font-size:.9375rem;"><i class="ph ph-code"></i> Via CSS</h3>
|
|
1151
|
+
<p class="op-text-muted op-text-sm op-mb-1">Fixo, definido no seu CSS. Ideal pra marca própria de um sistema inteiro.</p>
|
|
1152
|
+
<pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;"><style>
|
|
1153
|
+
:root {
|
|
1154
|
+
--op-accent: #FF6B00;
|
|
1155
|
+
--op-cyan: #00B8D9;
|
|
1156
|
+
--op-radius: 6px;
|
|
1157
|
+
}
|
|
1158
|
+
</style></pre>
|
|
1159
|
+
</div>
|
|
1160
|
+
<div class="op-card">
|
|
1161
|
+
<h3 class="op-mb-1" style="font-size:.9375rem;"><i class="ph ph-lightning"></i> Via JS (runtime)</h3>
|
|
1162
|
+
<p class="op-text-muted op-text-sm op-mb-1"><code>OptagoUI.customize()</code>: dinâmico, ex. cor por tenant/cliente vinda de uma API.</p>
|
|
1163
|
+
<pre class="op-demo-code is-visible" style="border:1px solid var(--op-border); border-radius:var(--op-radius-sm); margin:0;">OptagoUI.customize({
|
|
1164
|
+
accent: '#FF6B00', // vira --op-accent
|
|
1165
|
+
cyan: '#00B8D9',
|
|
1166
|
+
'--op-radius': '6px' // nome completo também funciona
|
|
1167
|
+
});</pre>
|
|
1168
|
+
</div>
|
|
1169
|
+
</div>
|
|
1170
|
+
|
|
1171
|
+
<div class="op-demo">
|
|
1172
|
+
<div class="op-demo-preview" style="display:flex; flex-wrap:wrap; align-items:flex-end; gap:1.5rem;">
|
|
1173
|
+
<div class="op-field" style="margin:0;">
|
|
1174
|
+
<label class="op-label" for="custom-accent">Verde-lima (--op-accent)</label>
|
|
1175
|
+
<input type="color" id="custom-accent" value="#C0FF6B" style="width:64px; height:36px; padding:2px; border:1px solid var(--op-border); border-radius:var(--op-radius-sm); background:none; cursor:pointer;">
|
|
1176
|
+
</div>
|
|
1177
|
+
<div class="op-field" style="margin:0;">
|
|
1178
|
+
<label class="op-label" for="custom-cyan">Ciano (--op-cyan)</label>
|
|
1179
|
+
<input type="color" id="custom-cyan" value="#6BE0FF" style="width:64px; height:36px; padding:2px; border:1px solid var(--op-border); border-radius:var(--op-radius-sm); background:none; cursor:pointer;">
|
|
1180
|
+
</div>
|
|
1181
|
+
<div class="op-field" style="margin:0; min-width:180px;">
|
|
1182
|
+
<label class="op-label" for="custom-radius">Raio (--op-radius)</label>
|
|
1183
|
+
<input class="op-range" type="range" id="custom-radius" min="0" max="24" value="12">
|
|
1184
|
+
</div>
|
|
1185
|
+
<button class="op-btn op-btn-ghost op-btn-sm" id="custom-reset"><i class="ph ph-arrow-counter-clockwise"></i> Restaurar</button>
|
|
1186
|
+
</div>
|
|
1187
|
+
<div class="op-demo-bar">
|
|
1188
|
+
<span class="op-text-muted op-text-xs"><i class="ph ph-cursor-click"></i> Ao vivo: repare nos botões primários da página inteira ao mudar as cores acima.</span>
|
|
1189
|
+
</div>
|
|
1190
|
+
</div>
|
|
1191
|
+
<script>
|
|
1192
|
+
(function () {
|
|
1193
|
+
var accent = document.getElementById('custom-accent');
|
|
1194
|
+
var cyan = document.getElementById('custom-cyan');
|
|
1195
|
+
var radius = document.getElementById('custom-radius');
|
|
1196
|
+
var reset = document.getElementById('custom-reset');
|
|
1197
|
+
accent.addEventListener('input', function () { OptagoUI.customize({ accent: accent.value, 'accent-hover': accent.value }); });
|
|
1198
|
+
cyan.addEventListener('input', function () { OptagoUI.customize({ cyan: cyan.value }); });
|
|
1199
|
+
radius.addEventListener('input', function () { OptagoUI.customize({ radius: radius.value + 'px' }); });
|
|
1200
|
+
reset.addEventListener('click', function () {
|
|
1201
|
+
['--op-accent', '--op-accent-hover', '--op-cyan', '--op-radius'].forEach(function (p) {
|
|
1202
|
+
document.documentElement.style.removeProperty(p);
|
|
1203
|
+
});
|
|
1204
|
+
accent.value = '#C0FF6B'; cyan.value = '#6BE0FF'; radius.value = 12;
|
|
1205
|
+
});
|
|
1206
|
+
})();
|
|
1207
|
+
</script>
|
|
1208
|
+
|
|
1209
|
+
<h3 class="op-mt-3 op-mb-1" style="font-size:1rem;">Principais tokens</h3>
|
|
1210
|
+
<div class="op-table-wrap">
|
|
1211
|
+
<table class="op-table op-table-hover op-mb-2">
|
|
1212
|
+
<thead><tr><th>Variável</th><th>Padrão (escuro)</th><th>O que muda</th></tr></thead>
|
|
1213
|
+
<tbody>
|
|
1214
|
+
<tr><td><code>--op-accent</code></td><td>#C0FF6B</td><td>Cor de marca: botão primário, foco, glow</td></tr>
|
|
1215
|
+
<tr><td><code>--op-cyan</code></td><td>#6BE0FF</td><td>Cor secundária: detalhes, badges cyan</td></tr>
|
|
1216
|
+
<tr><td><code>--op-info / -success / -warning / -danger</code></td><td>azul / verde / laranja / vermelho</td><td>Cores semânticas (badges, alerts, toasts)</td></tr>
|
|
1217
|
+
<tr><td><code>--op-bg / -panel / -panel-2 / -panel-3</code></td><td>tons de preto</td><td>Superfícies: fundo da página, cards, sidebar</td></tr>
|
|
1218
|
+
<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>
|
|
1219
|
+
<tr><td><code>--op-radius-sm / -radius / -radius-lg</code></td><td>8px / 12px / 16px</td><td>Arredondamento de botões, cards, inputs...</td></tr>
|
|
1220
|
+
<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>
|
|
1221
|
+
<tr><td><code>--op-header-h / -footer-h / -sidebar-w</code></td><td>56px / 42px / 260px</td><td>Dimensões do app shell</td></tr>
|
|
1222
|
+
</tbody>
|
|
1223
|
+
</table>
|
|
1224
|
+
</div>
|
|
1225
|
+
<p class="op-text-muted op-text-xs" style="margin:0;">
|
|
1226
|
+
Lista completa: seção <strong>1. TOKENS</strong> no topo de <code>ui-optago.css</code>. O tema
|
|
1227
|
+
claro redefine boa parte desses tokens dentro de <code>html.light { ... }</code> — pra
|
|
1228
|
+
customizar só o modo claro (ou só o escuro), sobrescreva dentro do seletor correspondente.
|
|
1229
|
+
</p>
|
|
1230
|
+
</section>
|
|
1231
|
+
|
|
1232
|
+
<!-- ==================== 21. TOUR GUIADO ==================== -->
|
|
1233
|
+
<section id="tour" class="op-mb-4" style="scroll-margin-top:1rem;">
|
|
1234
|
+
<div class="op-section-head">
|
|
1235
|
+
<i class="ph ph-signpost"></i>
|
|
1236
|
+
<h2>Tour Guiado</h2>
|
|
1237
|
+
</div>
|
|
1238
|
+
|
|
1239
|
+
<p style="color:var(--op-muted); margin-bottom:1.5rem; max-width:640px;">
|
|
1240
|
+
Integração com <strong style="color:var(--op-text);">driver.js</strong> via
|
|
1241
|
+
<code>OptagoUI.tour(steps, options?)</code>. A biblioteca é carregada do CDN
|
|
1242
|
+
sob demanda (só quando o tour for iniciado) e o popover já sai estilizado com o
|
|
1243
|
+
tema Óptago — escuro e claro, sem nenhuma configuração extra.
|
|
1244
|
+
</p>
|
|
1245
|
+
|
|
1246
|
+
<!-- Demo ao vivo -->
|
|
1247
|
+
<div class="op-card" style="margin-bottom:1.5rem; padding:1.25rem;">
|
|
1248
|
+
<div style="display:flex; align-items:center; gap:.75rem; flex-wrap:wrap;">
|
|
1249
|
+
<button id="btn-tour-demo" class="op-btn op-btn-primary" onclick="iniciarTourDemo()">
|
|
1250
|
+
<i class="ph ph-play"></i> Iniciar tour de exemplo
|
|
1251
|
+
</button>
|
|
1252
|
+
<span style="color:var(--op-muted); font-size:.875rem;">
|
|
1253
|
+
Percorre as principais seções desta documentação.
|
|
1254
|
+
</span>
|
|
1255
|
+
</div>
|
|
1256
|
+
</div>
|
|
1257
|
+
|
|
1258
|
+
<!-- Como usar -->
|
|
1259
|
+
<div class="op-grid-2" style="gap:1rem; margin-bottom:1.5rem;">
|
|
1260
|
+
<div class="op-card" style="padding:1.25rem;">
|
|
1261
|
+
<h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
|
|
1262
|
+
<i class="ph ph-code" style="color:var(--op-accent);"></i> Uso básico
|
|
1263
|
+
</h3>
|
|
1264
|
+
<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([
|
|
1265
|
+
{
|
|
1266
|
+
element: '#meu-elemento',
|
|
1267
|
+
popover: {
|
|
1268
|
+
title: 'Bem-vindo!',
|
|
1269
|
+
description: 'Este é o ponto de partida.',
|
|
1270
|
+
}
|
|
1271
|
+
},
|
|
1272
|
+
{
|
|
1273
|
+
element: '#outro-elemento',
|
|
1274
|
+
popover: {
|
|
1275
|
+
title: 'Passo 2',
|
|
1276
|
+
description: 'Continue por aqui.',
|
|
1277
|
+
}
|
|
1278
|
+
},
|
|
1279
|
+
// step sem element = modal centralizado
|
|
1280
|
+
{
|
|
1281
|
+
popover: {
|
|
1282
|
+
title: 'Pronto!',
|
|
1283
|
+
description: 'Tour concluído com sucesso.',
|
|
1284
|
+
}
|
|
1285
|
+
}
|
|
1286
|
+
]).then(function(d) {
|
|
1287
|
+
// d = instância driver.js (opcional)
|
|
1288
|
+
});</code></pre>
|
|
1289
|
+
</div>
|
|
1290
|
+
<div class="op-card" style="padding:1.25rem;">
|
|
1291
|
+
<h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">
|
|
1292
|
+
<i class="ph ph-sliders" style="color:var(--op-accent);"></i> Opções
|
|
1293
|
+
</h3>
|
|
1294
|
+
<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, {
|
|
1295
|
+
// Padrões já configurados pelo OptagoUI:
|
|
1296
|
+
animate: true,
|
|
1297
|
+
smoothScroll: true,
|
|
1298
|
+
showProgress: true,
|
|
1299
|
+
progressText: '{{current}} de {{total}}',
|
|
1300
|
+
nextBtnText: 'Próximo →',
|
|
1301
|
+
prevBtnText: '← Anterior',
|
|
1302
|
+
doneBtnText: 'Concluir',
|
|
1303
|
+
|
|
1304
|
+
// Qualquer opção nativa do driver.js:
|
|
1305
|
+
allowClose: true, // fecha com ESC/clique no overlay
|
|
1306
|
+
onDestroyed: function() {
|
|
1307
|
+
console.log('tour encerrado');
|
|
1308
|
+
}
|
|
1309
|
+
});</code></pre>
|
|
1310
|
+
<p style="font-size:.8125rem; color:var(--op-muted); margin-top:.75rem; margin-bottom:0;">
|
|
1311
|
+
Todas as opções nativas do
|
|
1312
|
+
<a href="https://driverjs.com/docs/configuration" target="_blank" rel="noopener" style="color:var(--op-accent);">driver.js</a>
|
|
1313
|
+
são aceitas e passadas diretamente à instância.
|
|
1314
|
+
</p>
|
|
1315
|
+
</div>
|
|
1316
|
+
</div>
|
|
1317
|
+
|
|
1318
|
+
<!-- Tabela de referência dos steps -->
|
|
1319
|
+
<h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Estrutura de um step</h3>
|
|
1320
|
+
<div style="overflow-x:auto; margin-bottom:1.5rem;">
|
|
1321
|
+
<table class="op-table op-table-hover" style="font-size:.875rem;">
|
|
1322
|
+
<thead>
|
|
1323
|
+
<tr><th>Propriedade</th><th>Tipo</th><th>Descrição</th></tr>
|
|
1324
|
+
</thead>
|
|
1325
|
+
<tbody>
|
|
1326
|
+
<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>
|
|
1327
|
+
<tr><td><code>popover.title</code></td><td>string</td><td>Título do popover (aceita HTML)</td></tr>
|
|
1328
|
+
<tr><td><code>popover.description</code></td><td>string</td><td>Corpo do popover (aceita HTML)</td></tr>
|
|
1329
|
+
<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>
|
|
1330
|
+
<tr><td><code>popover.align</code></td><td>string</td><td>Alinhamento: <code>start</code> <code>center</code> <code>end</code></td></tr>
|
|
1331
|
+
<tr><td><code>onHighlightStarted</code></td><td>function</td><td>Callback antes de destacar o elemento</td></tr>
|
|
1332
|
+
<tr><td><code>onHighlighted</code></td><td>function</td><td>Callback após destacar o elemento</td></tr>
|
|
1333
|
+
<tr><td><code>onDeselected</code></td><td>function</td><td>Callback ao sair do step</td></tr>
|
|
1334
|
+
</tbody>
|
|
1335
|
+
</table>
|
|
1336
|
+
</div>
|
|
1337
|
+
|
|
1338
|
+
<!-- Destaque simples de um elemento -->
|
|
1339
|
+
<h3 style="font-size:.9375rem; margin-bottom:.75rem; color:var(--op-strong);">Destaque avulso (sem tour)</h3>
|
|
1340
|
+
<p style="color:var(--op-muted); font-size:.875rem; margin-bottom:.75rem;">
|
|
1341
|
+
Para destacar um único elemento sem navegar por steps, passe um array de um único step.
|
|
1342
|
+
O driver.js também expõe <code>highlight()</code> nativamente se você precisar da instância.
|
|
1343
|
+
</p>
|
|
1344
|
+
<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([
|
|
1345
|
+
{
|
|
1346
|
+
element: '#meu-campo',
|
|
1347
|
+
popover: { title: 'Atenção', description: 'Preencha este campo.' }
|
|
1348
|
+
}
|
|
1349
|
+
]);</code></pre>
|
|
1350
|
+
</section>
|
|
1351
|
+
|
|
1352
|
+
<script>
|
|
1353
|
+
function iniciarTourDemo() {
|
|
1354
|
+
OptagoUI.tour([
|
|
1355
|
+
{
|
|
1356
|
+
popover: {
|
|
1357
|
+
title: '<i class="ph ph-hand-waving"></i> Bem-vindo à UI Óptago!',
|
|
1358
|
+
description: 'Este tour percorre os principais componentes do design system. Use os botões abaixo para navegar.'
|
|
1359
|
+
}
|
|
1360
|
+
},
|
|
1361
|
+
{
|
|
1362
|
+
element: '#botoes',
|
|
1363
|
+
popover: {
|
|
1364
|
+
title: '<i class="ph ph-cursor-click"></i> Botões',
|
|
1365
|
+
description: 'Variações de estilo, tamanho e estado — incluindo <code>is-loading</code> para ações assíncronas.',
|
|
1366
|
+
side: 'top'
|
|
1367
|
+
}
|
|
1368
|
+
},
|
|
1369
|
+
{
|
|
1370
|
+
element: '#formularios',
|
|
1371
|
+
popover: {
|
|
1372
|
+
title: '<i class="ph ph-text-aa"></i> Formulários',
|
|
1373
|
+
description: 'Inputs, selects, switches, ranges e estados de validação (<code>is-error</code>, <code>is-success</code>).',
|
|
1374
|
+
side: 'top'
|
|
1375
|
+
}
|
|
1376
|
+
},
|
|
1377
|
+
{
|
|
1378
|
+
element: '#alertas',
|
|
1379
|
+
popover: {
|
|
1380
|
+
title: '<i class="ph ph-warning"></i> Alertas',
|
|
1381
|
+
description: 'Quatro variantes semânticas (info, success, warning, danger) com fundo sólido em ambos os temas.',
|
|
1382
|
+
side: 'top'
|
|
1383
|
+
}
|
|
1384
|
+
},
|
|
1385
|
+
{
|
|
1386
|
+
element: '#toasts',
|
|
1387
|
+
popover: {
|
|
1388
|
+
title: '<i class="ph ph-bell-ringing"></i> Toasts',
|
|
1389
|
+
description: 'Notificações temporárias disparadas via <code>OptagoUI.toast(msg, tipo)</code>.',
|
|
1390
|
+
side: 'top'
|
|
1391
|
+
}
|
|
1392
|
+
},
|
|
1393
|
+
{
|
|
1394
|
+
element: '#modais',
|
|
1395
|
+
popover: {
|
|
1396
|
+
title: '<i class="ph ph-square-half"></i> Modais',
|
|
1397
|
+
description: 'Diálogos com tamanhos (sm/lg), drawer lateral e animação de entrada/saída.',
|
|
1398
|
+
side: 'top'
|
|
1399
|
+
}
|
|
1400
|
+
},
|
|
1401
|
+
{
|
|
1402
|
+
element: '#customizando',
|
|
1403
|
+
popover: {
|
|
1404
|
+
title: '<i class="ph ph-sliders"></i> Customizando',
|
|
1405
|
+
description: 'Sobreponha qualquer token com <code>OptagoUI.customize()</code> — ideal para cor por sistema ou tenant vinda de uma API.',
|
|
1406
|
+
side: 'top'
|
|
1407
|
+
}
|
|
1408
|
+
},
|
|
1409
|
+
{
|
|
1410
|
+
element: '#tour',
|
|
1411
|
+
popover: {
|
|
1412
|
+
title: '<i class="ph ph-signpost"></i> Tour Guiado',
|
|
1413
|
+
description: 'É aqui que você está! <code>OptagoUI.tour(steps)</code> carrega o driver.js sob demanda e já aplica o tema Óptago.',
|
|
1414
|
+
side: 'top'
|
|
1415
|
+
}
|
|
1416
|
+
},
|
|
1417
|
+
{
|
|
1418
|
+
popover: {
|
|
1419
|
+
title: '<i class="ph ph-check-circle"></i> Tour concluído!',
|
|
1420
|
+
description: 'Esses são os componentes principais. Explore o restante da documentação à vontade.'
|
|
1421
|
+
}
|
|
1422
|
+
}
|
|
1423
|
+
]);
|
|
1424
|
+
}
|
|
1425
|
+
</script>
|
|
1426
|
+
|
|
1427
|
+
<!-- ==================== 22. SELO "DESENVOLVIDO POR ÓPTAGO" ==================== -->
|
|
1137
1428
|
<section id="creditos" class="op-mb-4" style="scroll-margin-top:1rem; position:relative;">
|
|
1138
1429
|
<!-- Perto do fim da página, lado direito, cor info pra variar
|
|
1139
1430
|
(mesmo padrão de cor secundária já usado no rodapé do topo). -->
|
|
@@ -1167,7 +1458,7 @@ OptagoUI.tabulator('#minhaTabela', {
|
|
|
1167
1458
|
<pre class="op-demo-code is-visible" id="d-creditos" style="margin-top:.75rem; border:1px solid var(--op-border); border-radius:var(--op-radius-sm);"><!-- Via CDN, sem copiar nada: -->
|
|
1168
1459
|
<div id="optago-credit"></div>
|
|
1169
1460
|
<script>
|
|
1170
|
-
fetch('https://unpkg.com/ui-optago@1.2.
|
|
1461
|
+
fetch('https://unpkg.com/ui-optago@1.2.3/optago-credit-dark.html')
|
|
1171
1462
|
.then(r => r.text())
|
|
1172
1463
|
.then(html => document.getElementById('optago-credit').innerHTML = html);
|
|
1173
1464
|
</script>
|
|
@@ -1189,7 +1480,7 @@ OptagoUI.tabulator('#minhaTabela', {
|
|
|
1189
1480
|
</script>
|
|
1190
1481
|
</section>
|
|
1191
1482
|
|
|
1192
|
-
<!-- ====================
|
|
1483
|
+
<!-- ==================== 22. SOBRE A ÓPTAGO ==================== -->
|
|
1193
1484
|
<section id="sobre" class="op-mb-4" style="scroll-margin-top:1rem;">
|
|
1194
1485
|
<div class="op-section-head">
|
|
1195
1486
|
<i class="ph ph-buildings"></i>
|
|
@@ -1280,6 +1571,8 @@ OptagoUI.tabulator('#minhaTabela', {
|
|
|
1280
1571
|
<a class="op-nav-item" href="#carregamento"><i class="ph ph-circle-notch"></i><span class="op-nav-text">Carregamento</span><span class="op-nav-tooltip">Carregamento</span></a>
|
|
1281
1572
|
<a class="op-nav-item" href="#modais"><i class="ph ph-app-window"></i><span class="op-nav-text">Modais</span><span class="op-nav-tooltip">Modais</span></a>
|
|
1282
1573
|
<a class="op-nav-item" href="#layout"><i class="ph ph-layout"></i><span class="op-nav-text">Layout</span><span class="op-nav-tooltip">Layout</span></a>
|
|
1574
|
+
<a class="op-nav-item" href="#customizando"><i class="ph ph-sliders"></i><span class="op-nav-text">Customizando</span><span class="op-nav-tooltip">Customizando</span></a>
|
|
1575
|
+
<a class="op-nav-item" href="#tour"><i class="ph ph-signpost"></i><span class="op-nav-text">Tour Guiado</span><span class="op-nav-tooltip">Tour Guiado</span></a>
|
|
1283
1576
|
<a class="op-nav-item" href="#creditos"><i class="ph ph-seal-check"></i><span class="op-nav-text">Créditos</span><span class="op-nav-tooltip">Créditos</span></a>
|
|
1284
1577
|
<a class="op-nav-item" href="#sobre"><i class="ph ph-buildings"></i><span class="op-nav-text">Sobre</span><span class="op-nav-tooltip">Sobre</span></a>
|
|
1285
1578
|
</nav>
|
package/llms.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UI Óptago
|
|
2
2
|
|
|
3
|
-
> Design system em CSS puro + JavaScript vanilla (sem build, sem dependências de framework) da Óptago. Todas as classes usam o prefixo `op-`, estados usam `is-` (`is-open`, `is-active`, `is-error`...), e a maior parte dos comportamentos interativos liga sozinha via atributos `data-op-*`, sem precisar escrever JS. API global em `window.OptagoUI`. Versão atual: `1.2.
|
|
3
|
+
> Design system em CSS puro + JavaScript vanilla (sem build, sem dependências de framework) da Óptago. Todas as classes usam o prefixo `op-`, estados usam `is-` (`is-open`, `is-active`, `is-error`...), e a maior parte dos comportamentos interativos liga sozinha via atributos `data-op-*`, sem precisar escrever JS. API global em `window.OptagoUI`. Versão atual: `1.2.3`.
|
|
4
4
|
|
|
5
5
|
Este arquivo é a referência otimizada para agentes de IA/LLMs que forem gerar HTML usando esta biblioteca. Para a documentação em prosa (humanos), veja [README.md](README.md). Para ver todos os componentes renderizados com exemplo de código, veja [index.html](index.html) (showcase).
|
|
6
6
|
|
|
@@ -9,8 +9,8 @@ Este arquivo é a referência otimizada para agentes de IA/LLMs que forem gerar
|
|
|
9
9
|
CDN, versão fixa (recomendado em produção, sem definir versão especifica ele estará sempre na versão mais atual da biblioteca):
|
|
10
10
|
|
|
11
11
|
```html
|
|
12
|
-
<link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.
|
|
13
|
-
<script src="https://unpkg.com/ui-optago@1.2.
|
|
12
|
+
<link rel="stylesheet" href="https://unpkg.com/ui-optago@1.2.3/ui-optago.css">
|
|
13
|
+
<script src="https://unpkg.com/ui-optago@1.2.3/ui-optago.js"></script>
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
npm:
|
|
@@ -118,7 +118,7 @@ Abre no foco do input, filtra as opções pelo texto digitado (case-insensitive)
|
|
|
118
118
|
| `data-op-loading-message="texto"` | Mensagem customizada pro `data-op-loading-form` (padrão: "Carregando...") |
|
|
119
119
|
| `data-op-reveal` (no wrapper) + `data-op-reveal-toggle` (no botão dentro) | Mostrar/ocultar senha; o wrapper envolve o `<input type="password">` e o botão |
|
|
120
120
|
| `data-op-toast='[{"type":"success","message":"Oi"}]'` | Dispara toast(s) a partir de flash messages vindas do servidor, sem `<script>` inline (funciona sob CSP estrito). Aceita um objeto único ou array. Campos: `type` (`success`/`error`/`warning`/`info`), `message`, `duration` (ms, opcional) |
|
|
121
|
-
| `data-op-version` | Elemento cujo texto é substituído pela versão da lib (ex.: `v1.2.
|
|
121
|
+
| `data-op-version` | Elemento cujo texto é substituído pela versão da lib (ex.: `v1.2.3`) no carregamento |
|
|
122
122
|
| `data-op-combobox` (wrapper) + `data-op-combobox-input` + `data-op-combobox-menu` + `data-op-combobox-option` | Combobox com busca/filtro; ver seção "Combobox" acima pra estrutura completa |
|
|
123
123
|
|
|
124
124
|
## API JavaScript (`window.OptagoUI`)
|
|
@@ -130,6 +130,8 @@ OptagoUI.openModal('#idDoModal');
|
|
|
130
130
|
OptagoUI.closeModal('#idDoModal');
|
|
131
131
|
OptagoUI.setTheme('light'); // 'dark' | 'light', também persiste em localStorage
|
|
132
132
|
OptagoUI.toggleTheme();
|
|
133
|
+
OptagoUI.customize({ accent: '#FF6B00', radius: '6px' }); // sobrescreve tokens (--op-*) em runtime;
|
|
134
|
+
// chave sem prefixo vira --op-<chave>, ou passe o nome completo (ex. '--op-accent')
|
|
133
135
|
OptagoUI.toggleSidebar(); // desktop: colapsa/expande; mobile: chama toggleSidebarMobile()
|
|
134
136
|
OptagoUI.toggleSidebarMobile();
|
|
135
137
|
OptagoUI.closeSidebarMobile();
|
|
@@ -137,7 +139,16 @@ OptagoUI.showLoading('Salvando...'); // mostra overlay de carregamento f
|
|
|
137
139
|
OptagoUI.hideLoading();
|
|
138
140
|
OptagoUI.copyHTML('#seletor', botaoOpcional); // usado internamente por data-op-copy
|
|
139
141
|
OptagoUI.toggleCode('#seletor', botao); // usado internamente por data-op-code
|
|
140
|
-
OptagoUI.version; // string, ex. "1.2.
|
|
142
|
+
OptagoUI.version; // string, ex. "1.2.3"
|
|
143
|
+
|
|
144
|
+
// Tour guiado: carrega driver.js via CDN sob demanda, já com tema Óptago aplicado
|
|
145
|
+
// Cada step: { element: '#seletor', popover: { title: 'Título', description: 'Texto' } }
|
|
146
|
+
// Step sem `element` vira modal genérico centralizado.
|
|
147
|
+
// Qualquer opção nativa do driver.js é aceita no segundo argumento (options).
|
|
148
|
+
OptagoUI.tour([
|
|
149
|
+
{ element: '#meu-el', popover: { title: 'Passo 1', description: 'Explicação.' } },
|
|
150
|
+
{ popover: { title: 'Fim', description: 'Tour concluído.' } }
|
|
151
|
+
]).then(instanciaDriver => { /* ... */ });
|
|
141
152
|
|
|
142
153
|
// Tabela avançada: carrega Tabulator via CDN sob demanda, já com tema Óptago aplicado
|
|
143
154
|
OptagoUI.tabulator('#minhaTabela', {
|
|
@@ -175,7 +186,7 @@ Para rodapé de QUALQUER site da Óptago, mesmo sites que não usam o resto da l
|
|
|
175
186
|
```html
|
|
176
187
|
<div id="optago-credit"></div>
|
|
177
188
|
<script>
|
|
178
|
-
fetch('https://unpkg.com/ui-optago@1.2.
|
|
189
|
+
fetch('https://unpkg.com/ui-optago@1.2.3/optago-credit-dark.html')
|
|
179
190
|
.then(r => r.text())
|
|
180
191
|
.then(html => document.getElementById('optago-credit').innerHTML = html);
|
|
181
192
|
</script>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ui-optago",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.3",
|
|
4
4
|
"description": "Design System Óptago: componentes UI em CSS puro + JS vanilla, com tema claro/escuro, verde-lima (#C0FF6B) e app shell com sidebar colapsável.",
|
|
5
5
|
"author": "Óptago <cowork@optago.com.br> (https://optago.com.br)",
|
|
6
6
|
"license": "MIT",
|
package/ui-optago.css
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ============================================================================
|
|
2
|
-
UI ÓPTAGO: Design System v1.2.
|
|
2
|
+
UI ÓPTAGO: Design System v1.2.3
|
|
3
3
|
CSS puro, sem dependências. Tema escuro por padrão.
|
|
4
4
|
Para tema claro: adicione a classe "light" ao <html> (o ui-optago.js
|
|
5
5
|
gerencia isso automaticamente via localStorage).
|
|
@@ -513,11 +513,12 @@ html.light .op-nav-item:hover { color: #000000; }
|
|
|
513
513
|
.op-sidebar {
|
|
514
514
|
position: fixed;
|
|
515
515
|
top: 0; right: 0; bottom: 0;
|
|
516
|
+
width: 100%; /* drawer ocupa a tela toda no mobile, mais fácil de tocar */
|
|
516
517
|
transform: translateX(100%);
|
|
517
518
|
box-shadow: var(--op-shadow-lg);
|
|
518
519
|
}
|
|
519
520
|
.op-sidebar.is-open { transform: translateX(0); z-index: 60; }
|
|
520
|
-
.op-sidebar.is-collapsed { width:
|
|
521
|
+
.op-sidebar.is-collapsed { width: 100%; } /* colapso (só ícones) é coisa de desktop */
|
|
521
522
|
.op-sidebar.is-collapsed .op-nav-text,
|
|
522
523
|
.op-sidebar.is-collapsed .op-sidebar-label,
|
|
523
524
|
.op-sidebar.is-collapsed .op-sidebar-header-text { display: block; }
|
|
@@ -734,7 +735,17 @@ html.light .op-alert-danger > i, html.light .op-alert-danger .op-alert-title {
|
|
|
734
735
|
/* ----------------------------------------------------------------------------
|
|
735
736
|
8. FORMULÁRIOS
|
|
736
737
|
---------------------------------------------------------------------------- */
|
|
737
|
-
.op-field { display: flex; flex-direction: column; gap: .375rem; }
|
|
738
|
+
.op-field { display: flex; flex-direction: column; gap: .375rem; margin-bottom: 1rem; }
|
|
739
|
+
.op-field:last-child { margin-bottom: 0; }
|
|
740
|
+
/* Dentro de containers que já controlam o espaçamento entre filhos via gap
|
|
741
|
+
(grid/stack/row), o margin-bottom do field somaria ao gap e dobraria o
|
|
742
|
+
espaço — zera aqui pra quem usa esses containers não precisar lutar contra
|
|
743
|
+
a margem. Fora deles (fields soltos, um embaixo do outro), o margin-bottom
|
|
744
|
+
é o que evita o label do próximo field colar no input do anterior. */
|
|
745
|
+
.op-row > .op-field, .op-stack > .op-field,
|
|
746
|
+
.op-grid-2 > .op-field, .op-grid-3 > .op-field, .op-grid-4 > .op-field {
|
|
747
|
+
margin-bottom: 0;
|
|
748
|
+
}
|
|
738
749
|
|
|
739
750
|
.op-label {
|
|
740
751
|
font-family: var(--op-font-mono);
|
|
@@ -2287,6 +2298,88 @@ html.light .op-text-accent { color: #3F6212; }
|
|
|
2287
2298
|
to { opacity: 0; transform: scale(.95) translateY(12px); }
|
|
2288
2299
|
}
|
|
2289
2300
|
|
|
2301
|
+
/* ----------------------------------------------------------------------------
|
|
2302
|
+
Tour Guiado (driver.js) — sobreposição de tema Óptago
|
|
2303
|
+
A classe .op-tour-popover é passada em popoverClass para o driver.
|
|
2304
|
+
Usa .driver-popover.op-tour-popover (dupla classe) para vencer os estilos
|
|
2305
|
+
base do driver.js quando ambos têm a mesma posição na cascata.
|
|
2306
|
+
Os tokens CSS já mudam automaticamente com html.light — sem precisar de
|
|
2307
|
+
seletores separados por tema para cor de texto/fundo/borda.
|
|
2308
|
+
---------------------------------------------------------------------------- */
|
|
2309
|
+
.driver-popover.op-tour-popover {
|
|
2310
|
+
background: var(--op-panel-2);
|
|
2311
|
+
border: 1px solid var(--op-border-2);
|
|
2312
|
+
border-radius: var(--op-radius);
|
|
2313
|
+
color: var(--op-text);
|
|
2314
|
+
font-family: var(--op-font-sans), system-ui, sans-serif;
|
|
2315
|
+
box-shadow: var(--op-shadow-lg);
|
|
2316
|
+
padding: 1.25rem 1.25rem 1rem;
|
|
2317
|
+
max-width: 340px;
|
|
2318
|
+
min-width: 240px;
|
|
2319
|
+
}
|
|
2320
|
+
.driver-popover.op-tour-popover .driver-popover-title {
|
|
2321
|
+
font-family: var(--op-font-display), system-ui, sans-serif;
|
|
2322
|
+
font-size: 1rem;
|
|
2323
|
+
font-weight: 600;
|
|
2324
|
+
color: var(--op-strong);
|
|
2325
|
+
margin-bottom: .375rem;
|
|
2326
|
+
}
|
|
2327
|
+
.driver-popover.op-tour-popover .driver-popover-description {
|
|
2328
|
+
font-size: .875rem;
|
|
2329
|
+
line-height: 1.55;
|
|
2330
|
+
color: var(--op-muted);
|
|
2331
|
+
}
|
|
2332
|
+
.driver-popover.op-tour-popover .driver-popover-progress-text {
|
|
2333
|
+
font-size: .75rem;
|
|
2334
|
+
color: var(--op-muted);
|
|
2335
|
+
}
|
|
2336
|
+
.driver-popover.op-tour-popover .driver-popover-navigation-btns {
|
|
2337
|
+
gap: .5rem;
|
|
2338
|
+
}
|
|
2339
|
+
.driver-popover.op-tour-popover .driver-popover-prev-btn,
|
|
2340
|
+
.driver-popover.op-tour-popover .driver-popover-next-btn,
|
|
2341
|
+
.driver-popover.op-tour-popover .driver-popover-close-btn {
|
|
2342
|
+
background: transparent;
|
|
2343
|
+
border: 1px solid var(--op-border-2);
|
|
2344
|
+
border-radius: var(--op-radius-sm);
|
|
2345
|
+
color: var(--op-text);
|
|
2346
|
+
font-family: var(--op-font-sans), system-ui, sans-serif;
|
|
2347
|
+
font-size: .8125rem;
|
|
2348
|
+
font-weight: 500;
|
|
2349
|
+
padding: .3125rem .75rem;
|
|
2350
|
+
cursor: pointer;
|
|
2351
|
+
text-shadow: none;
|
|
2352
|
+
transition: background .15s, color .15s, border-color .15s;
|
|
2353
|
+
}
|
|
2354
|
+
.driver-popover.op-tour-popover .driver-popover-prev-btn:hover,
|
|
2355
|
+
.driver-popover.op-tour-popover .driver-popover-close-btn:hover {
|
|
2356
|
+
background: var(--op-panel-3);
|
|
2357
|
+
border-color: var(--op-border-2);
|
|
2358
|
+
color: var(--op-text);
|
|
2359
|
+
}
|
|
2360
|
+
.driver-popover.op-tour-popover .driver-popover-next-btn {
|
|
2361
|
+
background: var(--op-accent);
|
|
2362
|
+
border-color: var(--op-accent);
|
|
2363
|
+
color: var(--op-accent-ink);
|
|
2364
|
+
text-shadow: none;
|
|
2365
|
+
}
|
|
2366
|
+
.driver-popover.op-tour-popover .driver-popover-next-btn:hover {
|
|
2367
|
+
background: var(--op-accent-hover);
|
|
2368
|
+
border-color: var(--op-accent-hover);
|
|
2369
|
+
color: var(--op-accent-ink);
|
|
2370
|
+
}
|
|
2371
|
+
/* setas do popover */
|
|
2372
|
+
.driver-popover.op-tour-popover .driver-popover-arrow-side-left { border-right-color: var(--op-border-2); }
|
|
2373
|
+
.driver-popover.op-tour-popover .driver-popover-arrow-side-right { border-left-color: var(--op-border-2); }
|
|
2374
|
+
.driver-popover.op-tour-popover .driver-popover-arrow-side-top { border-bottom-color: var(--op-panel-2); }
|
|
2375
|
+
.driver-popover.op-tour-popover .driver-popover-arrow-side-bottom { border-top-color: var(--op-panel-2); }
|
|
2376
|
+
|
|
2377
|
+
/* elemento destacado: outline na cor de acento */
|
|
2378
|
+
.driver-active-element {
|
|
2379
|
+
outline: 2px solid var(--op-accent) !important;
|
|
2380
|
+
outline-offset: 2px !important;
|
|
2381
|
+
}
|
|
2382
|
+
|
|
2290
2383
|
@media (prefers-reduced-motion: reduce) {
|
|
2291
2384
|
*, *::before, *::after {
|
|
2292
2385
|
animation-duration: .01ms !important;
|
package/ui-optago.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/* ============================================================================
|
|
2
|
-
UI ÓPTAGO: Design System v1.2.
|
|
2
|
+
UI ÓPTAGO: Design System v1.2.3 (JavaScript)
|
|
3
3
|
Sem dependências de build. Carregue no <head> SEM defer para evitar
|
|
4
4
|
flash de tema errado (FOUC):
|
|
5
5
|
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
|
|
52
52
|
// Fonte única da versão exibida no badge do header e no rodapé
|
|
53
53
|
// (elementos com o atributo data-op-version). Atualize só aqui.
|
|
54
|
-
var VERSION = '1.2.
|
|
54
|
+
var VERSION = '1.2.3';
|
|
55
55
|
OptagoUI.version = VERSION;
|
|
56
56
|
|
|
57
57
|
console.log(
|
|
@@ -105,6 +105,17 @@
|
|
|
105
105
|
OptagoUI.setTheme(document.documentElement.classList.contains('light') ? 'dark' : 'light');
|
|
106
106
|
};
|
|
107
107
|
|
|
108
|
+
// Sobrescreve tokens (--op-*) em runtime, ex.: OptagoUI.customize({ accent: '#FF6B00' })
|
|
109
|
+
// ou OptagoUI.customize({ '--op-radius': '4px' }) com o nome completo da variável.
|
|
110
|
+
// Útil pra marca por sistema/tenant sem precisar de um <style> próprio.
|
|
111
|
+
OptagoUI.customize = function (tokens) {
|
|
112
|
+
var root = document.documentElement.style;
|
|
113
|
+
Object.keys(tokens || {}).forEach(function (name) {
|
|
114
|
+
var prop = name.indexOf('--') === 0 ? name : '--op-' + name;
|
|
115
|
+
root.setProperty(prop, tokens[name]);
|
|
116
|
+
});
|
|
117
|
+
};
|
|
118
|
+
|
|
108
119
|
// Aplica já, sem esperar o DOM (evita FOUC)
|
|
109
120
|
document.documentElement.classList.toggle('light', currentTheme() === 'light');
|
|
110
121
|
|
|
@@ -336,7 +347,61 @@
|
|
|
336
347
|
};
|
|
337
348
|
|
|
338
349
|
/* --------------------------------------------------------------------------
|
|
339
|
-
5c.
|
|
350
|
+
5c. TOUR GUIADO (driver.js)
|
|
351
|
+
Carrega a biblioteca do CDN sob demanda e aplica o tema Óptago.
|
|
352
|
+
Uso: OptagoUI.tour(steps, options?) → Promise<instância driver>
|
|
353
|
+
|
|
354
|
+
Cada step: { element: '#seletor', popover: { title: 'Título', description: 'Texto' } }
|
|
355
|
+
O step sem `element` vira um modal genérico centralizado.
|
|
356
|
+
-------------------------------------------------------------------------- */
|
|
357
|
+
var DRIVER_CSS = 'https://cdn.jsdelivr.net/npm/driver.js/dist/driver.css';
|
|
358
|
+
var DRIVER_ESM = 'https://esm.run/driver.js';
|
|
359
|
+
|
|
360
|
+
OptagoUI.tour = function (steps, options) {
|
|
361
|
+
if (!document.getElementById('op-driver-css')) {
|
|
362
|
+
var css = document.createElement('link');
|
|
363
|
+
css.id = 'op-driver-css';
|
|
364
|
+
css.rel = 'stylesheet';
|
|
365
|
+
css.href = DRIVER_CSS;
|
|
366
|
+
// Inserido ANTES do ui-optago.css para que nosso CSS venha depois na
|
|
367
|
+
// cascata e vença os estilos base do driver.js com a mesma especificidade.
|
|
368
|
+
var ownCss = document.querySelector('link[href*="ui-optago.css"]');
|
|
369
|
+
if (ownCss && ownCss.parentNode) {
|
|
370
|
+
ownCss.parentNode.insertBefore(css, ownCss);
|
|
371
|
+
} else {
|
|
372
|
+
document.head.prepend(css);
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
return import(DRIVER_ESM).then(function (mod) {
|
|
377
|
+
var driverFn = mod.driver || mod.default;
|
|
378
|
+
var isLight = document.documentElement.classList.contains('light');
|
|
379
|
+
var defaults = {
|
|
380
|
+
animate: true,
|
|
381
|
+
smoothScroll: true,
|
|
382
|
+
showProgress: true,
|
|
383
|
+
progressText: '{{current}} de {{total}}',
|
|
384
|
+
nextBtnText: 'Próximo →',
|
|
385
|
+
prevBtnText: '← Anterior',
|
|
386
|
+
doneBtnText: 'Concluir',
|
|
387
|
+
popoverClass: 'op-tour-popover',
|
|
388
|
+
overlayColor: isLight ? '#0F172A' : '#000000',
|
|
389
|
+
overlayOpacity: isLight ? 0.5 : 0.75
|
|
390
|
+
};
|
|
391
|
+
var merged = {};
|
|
392
|
+
Object.keys(defaults).forEach(function (k) { merged[k] = defaults[k]; });
|
|
393
|
+
Object.keys(options || {}).forEach(function (k) { merged[k] = options[k]; });
|
|
394
|
+
merged.steps = steps;
|
|
395
|
+
var d = driverFn(merged);
|
|
396
|
+
d.drive();
|
|
397
|
+
return d;
|
|
398
|
+
}).catch(function (err) {
|
|
399
|
+
throw new Error('driver.js: falha ao carregar via CDN. ' + (err && err.message || ''));
|
|
400
|
+
});
|
|
401
|
+
};
|
|
402
|
+
|
|
403
|
+
/* --------------------------------------------------------------------------
|
|
404
|
+
5d. TELA DE CARREGAMENTO: overlay em tela cheia
|
|
340
405
|
Uso: OptagoUI.showLoading('Salvando...') ... OptagoUI.hideLoading()
|
|
341
406
|
ou data-op-loading-form no <form> para acionar sozinho no submit.
|
|
342
407
|
-------------------------------------------------------------------------- */
|