Además de los widgets integrados, tu organización puede tener los suyos propios. La forma más sencilla es guardar una tarjeta que hayas configurado como widget. Los administradores también pueden crear widgets a partir de una plantilla HTML, con su propio formulario de ajustes y sus propias ranuras de datos, y publicar versiones de ellos. Los widgets se encuentran en la biblioteca de widgets.
La biblioteca de widgets
Abre Widgets en el menú (en Configuración). «Todo lo que puede colocarse en un panel.»
| Estantería | Contiene |
|---|---|
| Sistema | Los widgets integrados y los que añaden los módulos («Los módulos aportan widgets al habilitarse.») |
| Organización | Widgets compartidos con toda la organización |
| Mis widgets | Tus widgets privados («Los widgets que creas aparecen en esta estantería.») |
| Favoritos | Los widgets que has marcado con estrella, de cualquier estantería |
La tabla muestra Nombre, Categoría y Usado por (cuántas tarjetas lo usan), con un filtro Tipo: Integrado, Plantilla HTML, Marco de plugin. Editar abre un widget que puedes modificar.
| Quién | Puede |
|---|---|
| Todos los miembros (Crear y editar tus propios widgets privados) | Crear widgets privados para sí mismos |
| Administradores (Crear y editar widgets, Publicar versiones de widgets) | Crear, editar y publicar widgets para todos |
Tu plan determina cuántos widgets personalizados compartidos puede tener tu organización. Los widgets privados de cada miembro cuentan con su propio cupo dentro del mismo límite, de modo que los widgets privados nunca consumen los compartidos.
Guardar una tarjeta como widget
- Configura una tarjeta en un panel como quieras.
- En sus ajustes, selecciona Guardar como widget… («Guarda los ajustes y datos actuales de esta tarjeta como un widget reutilizable en tu biblioteca.»).
- El widget aparece en Mis widgets: «Guardado como widget en tu biblioteca.» Colócalo en cualquier panel desde Añadir widget > Mis widgets.
Crear un widget
- En la biblioteca de widgets, selecciona Nuevo widget.
- Elige cómo empezar: Desde un gráfico listo (un gráfico integrado con tus valores predeterminados) o Desde una plantilla HTML.
- Introduce un Nombre y una Categoría, y elige Solo yo o Todos (solo administradores).
- Selecciona Crear. Se abre el editor de widgets.
El editor de widgets
El editor muestra una Vista previa en directo a la izquierda y el formulario de Ajustes a la derecha. La vista previa se dibuja con el mismo marco aislado que usa un panel, así que lo que ves es lo que reciben los paneles. Las pestañas:
| Pestaña | Contiene |
|---|---|
| Plantilla | El HTML de un widget de plantilla HTML. Un widget integrado o de plugin indica que «se renderiza con código que incluimos, por lo que aquí no hay ninguna plantilla que editar». |
| Esquema | Los campos de ajustes: Clave, Etiqueta, Tipo. «Cada campo que añades aquí aparece en el panel de la derecha, y en el cajón que un operador abre en una ubicación.» Al eliminar un campo se elimina también su valor predeterminado. |
| Datos | Hasta 6 ranuras de datos: Clave de ranura, Etiqueta, Forma (escalar, serie, tabla, registro), Obligatoria. «Una ranura indica lo que el widget NECESITA (un escalar, una serie), nunca de dónde procede.» Cada tarjeta elige el origen. |
| Acciones | Solo lectura: las acciones se definen por tarjeta, en el cajón de ajustes del panel. |
Usar como valores predeterminados guarda los ajustes en pantalla como valores predeterminados del widget.
Escribir una plantilla HTML
- Un campo de ajustes es un token: un campo
titlees{{title}}. - Una ranura de datos escalar
maines{{data_main}}. Las formas más complejas están enwindow.WIDGET_DATA.<slot>para el script propio de la plantilla. - Para hacer clicable algo, llama a
window.widgetAction()o asigna a un elementodata-widget-action. La tarjeta ejecuta entonces las acciones que configuró su panel; la plantilla nunca nombra un destino.
<div style="font: 600 32px system-ui">{{data_main}} {{unit}}</div>
<div style="color: #666">{{caption}}</div>
<button data-widget-action>Details</button>La plantilla se ejecuta en un marco sin acceso a Hermetry, a tu sesión ni a otras tarjetas, con su propia política de seguridad de contenido. Los widgets de plantilla se muestran en pantallas de visualización.
Borradores, versiones y publicación
Un widget tiene un estado: Borrador, Publicado o Archivado. Tus cambios se guardan en el borrador y se guardan mientras escribes (también con Ctrl+S); la cabecera muestra «sin guardar…» y después Guardado. Deshacer y rehacer (Ctrl+Z, Ctrl+Mayús+Z) funcionan mientras editas. Los paneles solo ven las versiones publicadas, de modo que un borrador nunca cambia un panel.
| Acción | Efecto |
|---|---|
| Publicar | Convierte el borrador en una nueva versión (desde Borrador o Publicado). Las tarjetas de los paneles la siguen. |
| Despublicar | Devuelve un widget publicado a Borrador. |
| Archivar | Retira un borrador o un widget publicado (Archivado). |
| Restaurar | Devuelve un widget archivado como Borrador. |
El editor solo ofrece las acciones que permite el estado del widget.
When a publish changes settings that cards already use, the dialog Settings changes since the last publish lists them: renamed, removed, retyped, narrowed or deprecated fields. If a new field replaces a removed one, say so («
Widgets del sistema
Un widget del sistema se incluye con la plataforma. Al editarlo se muestra «Este es un widget del sistema. Se incluye con la plataforma, así que los cambios aquí no son los que conservará una actualización.» Un widget compartido propio no puede usar el nombre de tipo de un widget de la plataforma.
Mover widgets
Moving widgets
A board file names the widgets its cards use but does not carry their definitions. Before you import a board that uses your own widgets into another organisation, recreate those widgets there. See Board templates and board files.