@ac-base/ac-demo-content 0.1.1 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -4
- package/package.json +10 -5
- package/src/demo-content.js +110 -21
package/README.md
CHANGED
|
@@ -52,14 +52,57 @@ Siempre presentes, sin atributo que los active:
|
|
|
52
52
|
|
|
53
53
|
## Eventos
|
|
54
54
|
|
|
55
|
-
| Evento
|
|
56
|
-
|
|
|
57
|
-
| `ac-demo-content-copy`
|
|
55
|
+
| Evento | Cuándo | `detail` |
|
|
56
|
+
| ------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------- |
|
|
57
|
+
| `ac-demo-content-copy` | El usuario copió un comando de instalación (solo si el copiado tuvo éxito) | `{ text: string }` |
|
|
58
|
+
| `ac-demo-content-state-change` | Cambió el caso, idioma, tema, dispositivo, vista, el log de eventos o el modo embebido | El mismo objeto que `demoState` (ver abajo) |
|
|
58
59
|
|
|
59
|
-
|
|
60
|
+
Ambos son `bubbles` y `composed`.
|
|
60
61
|
|
|
61
62
|
Todos los controles de 2+ opciones (idioma, tema, tamaño de dispositivo, vista) comparten el mismo patrón visual: un contenedor con borde redondeado, opciones separadas por un divisor vertical, y la opción activa resaltada — nunca un switch deslizante ni texto plano de estado ("Modo claro"/"Modo oscuro").
|
|
62
63
|
|
|
64
|
+
## Modo embebido
|
|
65
|
+
|
|
66
|
+
Para incrustar una demo dentro de otra página que dibuja sus propios controles (por ejemplo el catálogo visual, que carga cada demo en un `<iframe>` del mismo origen), activa `embedded`:
|
|
67
|
+
|
|
68
|
+
```js
|
|
69
|
+
const demo = iframe.contentDocument.querySelector('ac-demo-content');
|
|
70
|
+
demo.embedded = true; // o el atributo `embedded` en el HTML
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Con `embedded`, `ac-demo-content` **no dibuja la cabecera ni el toolbar** — solo el escenario (marco de dispositivo o vista de código) y el panel de eventos cuando está abierto. Quien lo incrusta maneja el mismo estado desde afuera:
|
|
74
|
+
|
|
75
|
+
| Método | Efecto |
|
|
76
|
+
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
|
|
77
|
+
| `selectCase(index)` | Activa el caso de ese índice. Ignora índices fuera de rango. |
|
|
78
|
+
| `selectLanguage(index)` | Activa el idioma `0` o `1` de `language`. Se ignora si no hay exactamente 2 idiomas o el índice no existe. |
|
|
79
|
+
| `selectAmbient(value)` | Setea `ambient` en los elementos del caso activo que tengan esa propiedad. |
|
|
80
|
+
| `selectTheme(theme)` | `'light'` o `'dark'` — togglea `data-theme` en el `<html>` de la demo. Otros valores se ignoran. |
|
|
81
|
+
| `selectDevice(key)` | `'mobile'`, `'tablet'` o `'desktop'`. Otros valores se ignoran. |
|
|
82
|
+
| `selectViewMode(mode)` | `'visual'` o `'code'`. Otros valores se ignoran. |
|
|
83
|
+
| `openEventsPanel()` / `closeEventsPanel()` | Abre/cierra el panel lateral de eventos (se dibuja dentro de la propia demo). |
|
|
84
|
+
|
|
85
|
+
El getter `demoState` devuelve una foto del estado actual, con todo lo necesario para dibujar los controles afuera:
|
|
86
|
+
|
|
87
|
+
```js
|
|
88
|
+
{
|
|
89
|
+
cases: [{ index: 0, header: 'Básico' }], // `header` cae a "Caso N" si el caso no lo define
|
|
90
|
+
activeCase: 0,
|
|
91
|
+
languages: ['es-PE', 'en-EN'],
|
|
92
|
+
activeLanguage: 0,
|
|
93
|
+
ambients: ['primary', 'secondary'],
|
|
94
|
+
darkMode: true, // si la demo declara `dark-mode`
|
|
95
|
+
theme: 'light',
|
|
96
|
+
devices: [{ key: 'mobile', label: 'Móvil' } /* tablet, desktop */],
|
|
97
|
+
device: 'mobile',
|
|
98
|
+
viewMode: 'visual',
|
|
99
|
+
eventNames: ['ac-mi-componente-click'],
|
|
100
|
+
eventCount: 0,
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Para mantenerse sincronizado (por ejemplo el contador de eventos), escucha `ac-demo-content-state-change`: su `detail` es ese mismo objeto. Los métodos y `demoState` funcionan también sin `embedded` — los controles propios del toolbar usan exactamente los mismos métodos.
|
|
105
|
+
|
|
63
106
|
## `<ac-demo-case>`
|
|
64
107
|
|
|
65
108
|
| Atributo | Descripción |
|
package/package.json
CHANGED
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ac-base/ac-demo-content",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"repository": {
|
|
5
|
+
"type": "git",
|
|
6
|
+
"url": "https://github.com/RenzoCordovaDev/ac-lit.git",
|
|
7
|
+
"directory": "packages/base/ac-demo-content"
|
|
8
|
+
},
|
|
4
9
|
"description": "Contenedor centralizado para demos de componentes ac-lit (casos, idioma, ambient, modo oscuro, tamaños, panel de eventos)",
|
|
5
10
|
"license": "MIT",
|
|
6
11
|
"type": "module",
|
|
@@ -23,15 +28,15 @@
|
|
|
23
28
|
"lit": "^3.0.0"
|
|
24
29
|
},
|
|
25
30
|
"devDependencies": {
|
|
26
|
-
"@ac-base/ac-core": "^0.1.0",
|
|
27
|
-
"@ac-base/ac-e2e-testing": "^0.1.0",
|
|
28
|
-
"@ac-base/cli": "^0.2.0",
|
|
29
31
|
"@open-wc/testing": "^4.0.0",
|
|
30
32
|
"@web/test-runner": "^0.18.0",
|
|
31
33
|
"concurrently": "^9.1.0",
|
|
32
34
|
"lit": "^3.0.0",
|
|
33
35
|
"sass": "^1.79.4",
|
|
34
|
-
"vite": "^5.4.8"
|
|
36
|
+
"vite": "^5.4.8",
|
|
37
|
+
"@ac-base/ac-core": "^0.1.0",
|
|
38
|
+
"@ac-base/cli": "^0.2.1",
|
|
39
|
+
"@ac-base/ac-e2e-testing": "^0.1.0"
|
|
35
40
|
},
|
|
36
41
|
"scripts": {
|
|
37
42
|
"component:lint": "eslint .",
|
package/src/demo-content.js
CHANGED
|
@@ -14,6 +14,17 @@ const DEVICE_PRESETS = [
|
|
|
14
14
|
{ key: 'desktop', label: 'Desktop', width: 1280, height: 800 },
|
|
15
15
|
];
|
|
16
16
|
const MAX_EVENT_LOG_ENTRIES = 50;
|
|
17
|
+
const THEMES = ['light', 'dark'];
|
|
18
|
+
const VIEW_MODES = ['visual', 'code'];
|
|
19
|
+
const STATE_PROPERTIES = [
|
|
20
|
+
'_activeCaseIndex',
|
|
21
|
+
'_activeDevice',
|
|
22
|
+
'_viewMode',
|
|
23
|
+
'_langIndex',
|
|
24
|
+
'_theme',
|
|
25
|
+
'_eventLog',
|
|
26
|
+
'embedded',
|
|
27
|
+
];
|
|
17
28
|
const COPIED_FEEDBACK_MS = 1600;
|
|
18
29
|
|
|
19
30
|
const COPY_ICON = html`<svg
|
|
@@ -108,6 +119,9 @@ function renderToken(token) {
|
|
|
108
119
|
* y ALTURA fijos por preset — el contenido scrollea adentro, no empuja el
|
|
109
120
|
* marco), vista visual/código (código muestra el HTML fuente del caso
|
|
110
121
|
* activo) y un panel lateral de eventos con el detalle de cada uno.
|
|
122
|
+
*
|
|
123
|
+
* Con `embedded` no dibuja cabecera ni toolbar: quien lo incrusta maneja los
|
|
124
|
+
* mismos controles desde afuera con los métodos `select*()` y lee `demoState`.
|
|
111
125
|
*/
|
|
112
126
|
export class DemoContent extends ComponentMixin(LitElement) {
|
|
113
127
|
static get is() {
|
|
@@ -128,6 +142,7 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
128
142
|
ambients: { type: String },
|
|
129
143
|
events: { type: String },
|
|
130
144
|
darkMode: { type: Boolean, reflect: true, attribute: 'dark-mode' },
|
|
145
|
+
embedded: { type: Boolean, reflect: true },
|
|
131
146
|
_activeCaseIndex: { state: true },
|
|
132
147
|
_activeDevice: { state: true },
|
|
133
148
|
_viewMode: { state: true },
|
|
@@ -149,6 +164,7 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
149
164
|
this.ambients = '';
|
|
150
165
|
this.events = '';
|
|
151
166
|
this.darkMode = false;
|
|
167
|
+
this.embedded = false;
|
|
152
168
|
this._activeCaseIndex = 0;
|
|
153
169
|
this._activeDevice = 'mobile';
|
|
154
170
|
this._viewMode = 'visual';
|
|
@@ -179,6 +195,26 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
179
195
|
return Array.from(this.querySelectorAll(':scope > ac-demo-case'));
|
|
180
196
|
}
|
|
181
197
|
|
|
198
|
+
get demoState() {
|
|
199
|
+
return {
|
|
200
|
+
cases: this._cases.map((caseEl, index) => ({
|
|
201
|
+
index,
|
|
202
|
+
header: caseEl.header || `Caso ${index + 1}`,
|
|
203
|
+
})),
|
|
204
|
+
activeCase: this._activeCaseIndex,
|
|
205
|
+
languages: this._languages,
|
|
206
|
+
activeLanguage: this._langIndex,
|
|
207
|
+
ambients: this._ambientOptions,
|
|
208
|
+
darkMode: this.darkMode,
|
|
209
|
+
theme: this._theme,
|
|
210
|
+
devices: DEVICE_PRESETS.map(({ key, label }) => ({ key, label })),
|
|
211
|
+
device: this._activeDevice,
|
|
212
|
+
viewMode: this._viewMode,
|
|
213
|
+
eventNames: this._eventNames,
|
|
214
|
+
eventCount: this._eventLog.length,
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
|
|
182
218
|
connectedCallback() {
|
|
183
219
|
super.connectedCallback();
|
|
184
220
|
for (const name of this._eventNames) {
|
|
@@ -205,6 +241,18 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
205
241
|
}
|
|
206
242
|
}
|
|
207
243
|
|
|
244
|
+
updated(changedProperties) {
|
|
245
|
+
if (STATE_PROPERTIES.some(property => changedProperties.has(property))) {
|
|
246
|
+
this.dispatchEvent(
|
|
247
|
+
new CustomEvent('ac-demo-content-state-change', {
|
|
248
|
+
detail: this.demoState,
|
|
249
|
+
bubbles: true,
|
|
250
|
+
composed: true,
|
|
251
|
+
}),
|
|
252
|
+
);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
|
|
208
256
|
_onEvent(event) {
|
|
209
257
|
const entry = { time: new Date().toLocaleTimeString(), name: event.type, detail: event.detail };
|
|
210
258
|
this._eventLog = [entry, ...this._eventLog].slice(0, MAX_EVENT_LOG_ENTRIES);
|
|
@@ -218,17 +266,18 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
218
266
|
this._activeCaseIndex = index;
|
|
219
267
|
}
|
|
220
268
|
|
|
221
|
-
|
|
222
|
-
|
|
269
|
+
selectCase(index) {
|
|
270
|
+
if (!Number.isInteger(index) || index < 0 || index >= this._cases.length) return;
|
|
271
|
+
this._activateCase(index);
|
|
223
272
|
}
|
|
224
273
|
|
|
225
|
-
|
|
274
|
+
selectLanguage(index) {
|
|
275
|
+
if (this._languages.length !== 2 || (index !== 0 && index !== 1)) return;
|
|
226
276
|
this._langIndex = index;
|
|
227
277
|
setGlobalLocale(this._languages[index]);
|
|
228
278
|
}
|
|
229
279
|
|
|
230
|
-
|
|
231
|
-
const value = event.target.value;
|
|
280
|
+
selectAmbient(value) {
|
|
232
281
|
const activeCase = this._cases[this._activeCaseIndex];
|
|
233
282
|
if (!activeCase) return;
|
|
234
283
|
|
|
@@ -239,6 +288,44 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
239
288
|
}
|
|
240
289
|
}
|
|
241
290
|
|
|
291
|
+
selectTheme(theme) {
|
|
292
|
+
if (!THEMES.includes(theme)) return;
|
|
293
|
+
this._theme = theme;
|
|
294
|
+
document.documentElement.setAttribute('data-theme', theme);
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
selectDevice(key) {
|
|
298
|
+
if (!DEVICE_PRESETS.some(preset => preset.key === key)) return;
|
|
299
|
+
this._activeDevice = key;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
selectViewMode(mode) {
|
|
303
|
+
if (!VIEW_MODES.includes(mode)) return;
|
|
304
|
+
this._viewMode = mode;
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
openEventsPanel() {
|
|
308
|
+
this._eventsPanelOpen = true;
|
|
309
|
+
document.addEventListener('keydown', this._onPanelKeydown);
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
closeEventsPanel() {
|
|
313
|
+
this._eventsPanelOpen = false;
|
|
314
|
+
document.removeEventListener('keydown', this._onPanelKeydown);
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
_onCaseChange(event) {
|
|
318
|
+
this.selectCase(Number(event.target.value));
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
_onLanguageSelect(index) {
|
|
322
|
+
this.selectLanguage(index);
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
_onAmbientChange(event) {
|
|
326
|
+
this.selectAmbient(event.target.value);
|
|
327
|
+
}
|
|
328
|
+
|
|
242
329
|
// Un modal/toast/transition "contenido" de un caso renuncia a la capa
|
|
243
330
|
// superior nativa (`showModal()`/`popover` SIEMPRE bloquean toda la página
|
|
244
331
|
// real e ignoran cualquier ancestro para medirse — ver "Superposiciones" en
|
|
@@ -265,16 +352,15 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
265
352
|
}
|
|
266
353
|
|
|
267
354
|
_onThemeSelect(theme) {
|
|
268
|
-
this.
|
|
269
|
-
document.documentElement.setAttribute('data-theme', theme);
|
|
355
|
+
this.selectTheme(theme);
|
|
270
356
|
}
|
|
271
357
|
|
|
272
358
|
_onDeviceSelect(key) {
|
|
273
|
-
this.
|
|
359
|
+
this.selectDevice(key);
|
|
274
360
|
}
|
|
275
361
|
|
|
276
362
|
_onViewModeSelect(mode) {
|
|
277
|
-
this.
|
|
363
|
+
this.selectViewMode(mode);
|
|
278
364
|
}
|
|
279
365
|
|
|
280
366
|
async _onInstallCommandClick(command) {
|
|
@@ -296,18 +382,16 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
296
382
|
}
|
|
297
383
|
|
|
298
384
|
_onEventsButtonClick() {
|
|
299
|
-
this.
|
|
300
|
-
document.addEventListener('keydown', this._onPanelKeydown);
|
|
385
|
+
this.openEventsPanel();
|
|
301
386
|
}
|
|
302
387
|
|
|
303
388
|
_onEventsPanelClose() {
|
|
304
|
-
this.
|
|
305
|
-
document.removeEventListener('keydown', this._onPanelKeydown);
|
|
389
|
+
this.closeEventsPanel();
|
|
306
390
|
}
|
|
307
391
|
|
|
308
392
|
_onPanelKeydown(event) {
|
|
309
393
|
if (event.key === 'Escape') {
|
|
310
|
-
this.
|
|
394
|
+
this.closeEventsPanel();
|
|
311
395
|
}
|
|
312
396
|
}
|
|
313
397
|
|
|
@@ -316,8 +400,19 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
316
400
|
const devicePreset = DEVICE_PRESETS.find(preset => preset.key === this._activeDevice);
|
|
317
401
|
|
|
318
402
|
return html`
|
|
319
|
-
${hasHeader ? this._renderHeader() : ''}
|
|
403
|
+
${hasHeader && !this.embedded ? this._renderHeader() : ''}
|
|
404
|
+
${this.embedded ? '' : this._renderToolbar()}
|
|
320
405
|
|
|
406
|
+
<div class="ac-demo-content__stage">
|
|
407
|
+
${this._viewMode === 'code' ? this._renderCodeView() : this._renderDeviceStage(devicePreset)}
|
|
408
|
+
</div>
|
|
409
|
+
|
|
410
|
+
${this._eventsPanelOpen ? this._renderEventsPanel() : ''}
|
|
411
|
+
`;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
_renderToolbar() {
|
|
415
|
+
return html`
|
|
321
416
|
<div part="toolbar" class="ac-demo-content__toolbar">
|
|
322
417
|
<div class="ac-demo-content__toolbar-cases">${this._renderCaseSwitcher(this._cases)}</div>
|
|
323
418
|
<div class="ac-demo-content__toolbar-controls">
|
|
@@ -328,12 +423,6 @@ export class DemoContent extends ComponentMixin(LitElement) {
|
|
|
328
423
|
${this._eventNames.length ? this._renderEventsButton() : ''}
|
|
329
424
|
</div>
|
|
330
425
|
</div>
|
|
331
|
-
|
|
332
|
-
<div class="ac-demo-content__stage">
|
|
333
|
-
${this._viewMode === 'code' ? this._renderCodeView() : this._renderDeviceStage(devicePreset)}
|
|
334
|
-
</div>
|
|
335
|
-
|
|
336
|
-
${this._eventsPanelOpen ? this._renderEventsPanel() : ''}
|
|
337
426
|
`;
|
|
338
427
|
}
|
|
339
428
|
|