Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-10-03

Editor, páginas, diseños y temas

Cómo funciona por dentro el editor de paneles — canvas con imán y ajuste fino, selección múltiple, deshacer, páginas, modo TV, borrador × publicado, diseño por dispositivo y temas.

En esta página (8)

El editor es 100 % web (sin app de escritorio). Armas el dashboard en un canvas en cuadrícula, con arrastrar y soltar, deshacer/rehacer, autoguardado, versiones y temas. Los ejemplos usan el workspace sintético Comércio Aurora Ltda.

¿Buscas un botón?

Esta página explica los conceptos. El nombre de cada botón está en Las cintas del editor, El panel del visual, Campos, medidas y variables y El menú del clic derecho.


Canvas: arrastrar, soltar y redimensionar#

  1. Qué es — una pantalla en cuadrícula (48 columnas) donde posicionas y redimensionas visuales.
  2. Cuándo usarlo — en todo armado/edición de dashboard.
  3. Cómo funciona — en Herramientas → Mover y ajustar, arrastras la tarjeta por el medio y la redimensionas con las asas de las esquinas y los lados. La tarjeta queda exactamente donde la soltaste: la posición va a la celda más cercana de la cuadrícula (48 columnas) más un ajuste fino, sin saltos. El imán muestra una guía cuando el borde o el centro de la tarjeta se alinea con otra tarjeta, en un eje a la vez; mantén presionado Alt para desactivar el imán. Un clic sin arrastrar no mueve nada. Arrastrar un campo al canvas crea un visual; arrastrar un campo a un visual lo coloca en el lugar correcto (eje/valor/leyenda). Terminar diseño guarda y sale del modo.
  4. Requisitos previos — un dashboard (nace vacío, como borrador) y un modelo con campos.
  5. Cómo validar — arrastra produtos.categoria al canvas (crea un visual), después vendas.valor dentro de él; mueve la tarjeta hasta que aparezca la guía del imán, suéltala y confirma que quedó donde la dejaste.

Modo Mover y ajustar con la guía del imán alineando dos tarjetas
6. Límites y salvedades — las pruebas automáticas cubren la lógica de cuadrícula y de soltar la tarjeta; la apariencia final depende del navegador. 7. Datos de ejemplo (sintéticos) — visual "Ingresos por categoría" a partir de produtos.categoria + vendas.valor. 8. Evidencia — la lógica de cuadrícula, soltar y antisuperposición (funciones puras) está cubierta por una suite determinística; el renderizado en el DOM no tiene prueba visual.


Alineación, selección múltiple y copiar/pegar#

  1. Qué es — alinear/distribuir, orden Z, bloquear, ocultar; selección múltiple (⌘-clic); copiar/pegar entre páginas y dashboards. Los comandos están en el menú del clic derecho (Posición, Tamaño, Organizar) y en el panel Selección de la cinta Herramientas.
  2. Cuándo usarlo — ordenar varios visuales a la vez, reutilizar un bloque.
  3. Cómo funciona — operaciones de diseño puras (probadas); el portapapeles usa localStorage (Ctrl+C / Ctrl+V), incluso entre dashboards.
  4. Requisitos previos — dos o más visuales.
  5. Cómo validar — selecciona tres visuales con ⌘-clic, alinéalos a la izquierda, cópialos y pégalos en otra página; confirma que llegan juntos.
  6. Límites y salvedades — el portapapeles depende del navegador (localStorage).
  7. Datos de ejemplo (sintéticos) — bloque "KPI de ventas" (3 KPI) copiado de la página "Resumen" a "Detalle".
  8. Evidencia — operaciones de alineación/distribución y copiar-pegar (funciones puras de diseño) cubiertas por una suite determinística.

Deshacer/rehacer y autoguardado#

  1. Qué es — pila de deshacer/rehacer (20 pasos) y guardado automático con debounce.
  2. Cuándo usarlo — siempre; recuperación rápida de un error de edición.
  3. Cómo funciona — deshacer/rehacer 100 % optimista (Ctrl+Z / Ctrl+Shift+Z); el autoguardado graba solo si el diseño cambió.
  4. Requisitos previos — dashboard en edición.
  5. Cómo validar — mueve un visual, presiona Ctrl+Z y confirma que vuelve; espera el debounce y recarga la página para ver el estado persistido.
  6. Límites y salvedades — la pila es de la sesión de edición (20 pasos). Cambiar de página, insertar o quitar un visual y el Organizar de la página no entran en Deshacer (quitar siempre pide confirmación).
  7. Datos de ejemplo (sintéticos) — mover "Ingresos por categoría" y deshacer.
  8. Evidencia — pila de deshacer/rehacer y guardado automático (graba solo si el diseño cambió) cubiertos por una suite determinística.

Páginas, presentación y enfoque#

  1. Qué es — múltiples páginas/pestañas (con tope), modo pantalla completa/presentación (←/→ cambia de página), modo ENFOQUE (1 visual) y modo TV (páginas que rotan en la pantalla grande).
  2. Cuándo usarlo — separar "Resumen" y "Detalle"; presentar en una pantalla grande.
  3. Cómo funciona — pestañas de página con tope; las páginas de tooltip quedan ocultas de la barra (se usan como tooltip pages — consulta Filtros e interacciones).
  4. Requisitos previos — dashboard con al menos una página.
  5. Cómo validar — crea las páginas "Resumen" y "Detalle", entra en presentación y navega con las flechas.
  6. Límites y salvedades — las páginas de tooltip quedan fuera de la barra de pestañas. Para una pantalla grande que rote las páginas sola, usa el modo TV (Página → Diseño → TV ▾ y el Enlace de TV en Compartir) — consulta Diseño por dispositivo y modo TV.
  7. Datos de ejemplo (sintéticos) — páginas "Resumen" (KPI) y "Detalle" (tabla de vendas).
  8. Evidencia — páginas, modo presentación y modo enfoque cubiertos por la lógica probada del editor.

Borrador × publicado y versionado#

  1. Qué es — separación entre el borrador (lo que editas) y lo publicado (lo que ven los lectores), con control de versiones y restauración.
  2. Cuándo usarlo — editar sin afectar a quien consume; volver a una versión anterior.
  3. Cómo funciona — los lectores ven la versión congelada; hay un diff de pendientes entre borrador y publicado; hasta 20 versiones (512KB cada una) con diff por widget, restaurar y poda automática.
  4. Requisitos previos — permiso de edición/publicación.
  5. Cómo validar — publica, edita el borrador, mira el diff de pendientes; restaura una versión anterior y confirma que vuelve.
  6. Límites y salvedades — tope de 20 versiones/512KB; mejor que el .pbix binario para el diff, pero no es una integración con Git.
  7. Datos de ejemplo (sintéticos) — v1 "3 KPI" → v2 "3 KPI + tabla"; restaurar v1.
  8. Evidencia — publicación (borrador×publicado), diff de pendientes e historial de versiones cubiertos por una suite determinística; historial en la página /versoes.

Diseño por dispositivo: computadora, tablet, celular y TV#

  1. Qué es — una disposición propia para cada dispositivo: Computadora (desde 1024px), Tableta (de 640 a 1023px), Celular (menos de 640px) y TV (enlace de TV, pantalla 16:9).
  2. Cuándo usarlo — paneles consultados en el celular, en la tablet de la tienda o en una pantalla grande.
  3. Cómo funciona — en Página → Diseño, elige el dispositivo y ordena las tarjetas; el diseño de la computadora no cambia. Sin disposición propia, el celular apila los visuales en el orden de la computadora, la tablet dibuja como la computadora y la TV usa el de la computadora escalado. Puntos de partida: Apilar automático (celular) y Copiar de la computadora (tablet y TV), ambos con confirmación.
  4. Requisitos previos — dashboard existente, en edición.
  5. Cómo validar — ordena el celular, abre el enlace público en un teléfono (o en una ventana angosta) y revisa la disposición; vuelve a Computadora y confirma que allí no cambió nada.
  6. Límites y salvedades — al tocar, se abre el tooltip común, pero la página de tooltip solo aparece con el mouse. Es web responsiva; no hay app nativa/push (eso está en Roadmap).
  7. Datos de ejemplo (sintéticos) — "Resumen" con 3 KPI apilados en el celular y lado a lado en la tablet.
  8. Evidencia — elección del dispositivo por el ancho, apilado automático, copia de la computadora y protección del diseño del celular cubiertos por una suite determinística.

Paso a paso completo en Diseño por dispositivo y modo TV.


Temas y plantillas#

  1. Qué es — tema del dashboard (paleta de 6 colores hex validados, fuente, fondo, estilo de tarjeta) y plantillas mediante importación/exportación JSON.
  2. Cuándo usarlo — estandarizar la identidad visual; reutilizar la estructura de un dashboard sin llevar datos.
  3. Cómo funciona — los colores se sanean contra inyección; hay verificación de contraste y plantillas brasileñas listas; la plantilla nunca lleva datos (solo estructura), con protección anti-__proto__ en la importación.
  4. Requisitos previos — nada además del dashboard.
  5. Cómo validar — cambia la paleta y confirma el cambio en todos los visuales; exporta la plantilla, impórtala en un dashboard nuevo y confirma que nace sin datos.
  6. Límites y salvedades — no hay galería de plantillas al crear: las plantillas son archivos JSON, en Página → Tema y plantilla ▾ (Descargar tema, Importar tema, Guardar plantilla, Usar plantilla, Nuevo desde plantilla).
  7. Datos de ejemplo (sintéticos) — tema "Aurora" (6 colores) exportado y reimportado.
  8. Evidencia — saneamiento de colores contra inyección, verificación de contraste, plantillas brasileñas e importación protegida (anti-__proto__) cubiertos por una suite determinística.

Estados vacío / cargando / error#

  1. Qué es — tarjetas de "Sin datos", tarjeta de error con el motivo, skeletons de carga y sello de muestra cuando el resultado se truncó.
  2. Cuándo usarlo — automático; garantiza que la falla de un visual no tumbe el panel.
  3. Cómo funciona — el error de consulta se convierte en una tarjeta con el motivo limpio (cleanQueryError quita el ruido técnico del datalake); el truncamiento propaga la marca "muestra".
  4. Requisitos previos — ninguno.
  5. Cómo validar — fuerza un visual sin datos y confirma "Sin datos"; fuerza un error y confirma la tarjeta con el motivo en lugar de una pantalla rota.
  6. Límites y salvedades — el texto del error se sanea para la lectura; no es el stack técnico.
  7. Datos de ejemplo (sintéticos) — visual sobre vendas filtrado a un período sin filas → "Sin datos".
  8. Evidencia — tarjeta de error con motivo limpio, skeletons de carga y propagación de la marca "muestra" cubiertos por una suite determinística.

Última revisión: 2026-10-03.

Enlaces relacionados