LIST
Lista de elementos: con itemTemplate + items (una plantilla por dato) o con hijos LIST_ITEM.
En esta página
Props
Tabla generada desde el esquema real (ui-schema.ts); si el esquema cambia, cambia esta tabla.
| Prop | Tipo | Requerido | Valores permitidos | Por defecto | Descripción |
|---|---|---|---|---|---|
| items | cualquiera | No | — | — | Datos (arreglo). |
| itemTemplate | componente | No | — | — | Plantilla por dato (usa item). |
| empty | componente | No | — | — | Que mostrar si no hay datos. |
| columns | enum | No | 1234 | 1 | Columnas. |
| gap | enum | No | 012345681012 | 2 | Espacio en escala de 4px (0-12). |
| variant | enum | No | "plain""divided""cards" | "plain" | Aspecto. |
| maxHeight | enum | No | "sm""md""lg""xl" | — | Limita la altura y activa el scroll. |
Props comunes a todos los componentes
| Prop | Tipo | Valores permitidos | Por defecto | Descripción |
|---|---|---|---|---|
| hidden | booleano | truefalse | — | true oculta el componente (admite expresiones). |
| onLoad | accion(es)acción | — | — | Accion que se ejecuta una vez al montar. |
| onLoadWhen | cualquiera | — | — | Condicion: onLoad se ejecuta cuando pasa a verdadera. |
| ariaLabel | texto | — | — | Nombre accesible explicito. |
Eventos y acciones que acepta
Props que ejecutan una acción (o cadena de acciones). Las variables disponibles en ${...} dentro de la acción son las que recibe cada evento.
No tiene eventos propios (solo onLoad, común a todos).
| Evento | Recibe | Descripción |
|---|---|---|
| onLoad | — | Accion que se ejecuta una vez al montar. |
Estado y contexto que usa
Cómo interactúa con state y context (expresiones ${...}).
items / data / rows / optionsLos datos suelen venir de
${state.<clave>}(rellenada porresultKeyde CALL_BACKEND) o de${context.*}.hidden / onLoadWhenCondiciones comunes:
hidden: "${!state.x}"oculta el componente;onLoadWhenejecutaonLoadal pasar a verdadera.
Simulador interactivo
Renderiza el JSON validado con el mismo renderer y el mismo kit que la app, con el tema actual de esta página. Nada sale a la red: CALL_BACKEND usa una respuesta simulada.
Acciones relacionadas
Acciones que este componente puede disparar desde sus props de acción (cualquiera de UI_ACTIONS) y las que lo controlan. Detalle de cada acción en la sección de acciones.
Usadas en sus ejemplos y manifests
- INSERT_CONTENT
Inserta HTML/texto en el editor del composer.
Obligatorios:
content· Campos:contentcloseOverlay
Acciones que lo controlan
Ninguna.
Ejemplo en un manifest real
Tomado de bloomx-extensions/google-drive/manifest.json (core-google-drive), en mounts[1].component.props.children[1].props.tabs[0].content[1].props.true[0] (punto OVERLAY).
{
"type": "LIST",
"props": {
"items": "${state.files}",
"itemTemplate": {
"type": "BUTTON",
"props": {
"label": "${item.name}",
"className": "w-full justify-start",
"variant": "outline",
"onClick": {
"action": "INSERT_CONTENT",
"content": "<a href='${item.webViewLink}' target='_blank' rel='noreferrer'>${item.name}</a>",
"closeOverlay": true
}
}
}
}
}{
"manifestVersion": "1.0",
"id": "my-extension",
"version": "1.0.0",
"name": "My extension",
"permissions": [],
"mounts": [
{
"point": "OVERLAY",
"component": {
"type": "LIST",
"props": {
"items": "${state.files}",
"itemTemplate": {
"type": "BUTTON",
"props": {
"label": "${item.name}",
"className": "w-full justify-start",
"variant": "outline",
"onClick": {
"action": "INSERT_CONTENT",
"content": "<a href='${item.webViewLink}' target='_blank' rel='noreferrer'>${item.name}</a>",
"closeOverlay": true
}
}
}
}
}
}
]
}