Premium Widgets
Custom Kanban
Custom Kanban
Custom Kanban
AI Defaults
- uniqueId
- Required, `"kanban-" + Nr`.
- height
- Use `"100%"` when embedded in a dashboard layout.
- Swimlane minWidth
- Set `minWidth: "300px"` for readable swimlanes.
- recordId
- Use raw `Nr` in swimlanes, NEVER `number(Nr)`. Stays on the formula; core never reads it. Drop handler looks up `ui.data.swimlanes[target_swimlane_index].recordId`.
- fieldId
- Use `fieldId(Nr, "Feldname")`, NOT the display name as string. Drop persistence is Ninox-handler only — core does not read `fieldId`.
- items mapping
- Use `.[{ itemId: Nr, ... }]` with `Nr` (not `number(Nr)`). `itemId` stays on the formula. Core emits swimlane/section/item **indices**; the handler reads `itemId` / `fieldId` from `ui.data.swimlanes[i]`.
- sections
- (optional pro Swimlane): `[{ id: "…", title: "…", items: [ … ], hideWhenEmpty: false, collapsed: false }]`. Ohne `sections` oder leer → flaches `items` wie bisher (eine implizite Gruppe, kein Gruppenkopf). `id` ist Pflicht sobald Gruppen genutzt werden (State).
- scrollSettings
- Root: `scrollX` / `scrollY` mit `scrollbar: { enabled: boolean }` fuer das gesamte Kanban (ersetzt/ergaenzt `showScrollbar` fuer X). Pro Swimlane: `scrollY.scrollbar.enabled` fuer vertikales Scrollen in der Spalte.
- scrollBar
- `showScrollBar`, `height`, `backgroundColor`, `handle` (aspecto de la tabla, track transparente). Oculta por defecto; `board` (horizontal) y `lanes` (vertical) cambian solo una barra. **styles.minWidth**: ancho mínimo de todas las columnas; las columnas nunca se desplazan lateralmente.
- dragAction
- Needs `fieldId` (field ID) for the status field being updated on drag. Adapter-only.
- Persistence
- Card drag saves in the **Ninox handler** (`type: "update"` from `item.fieldId` + target swimlane `recordId`). React hosts: `onItemDrop` / `onAction('item_drop')` — **no** global `database` stub.
- clickable
- Core gated nur darüber. Ninox: `clickAction: false` → nicht klickbar; sonst Default-Popup über `itemId`.
- Filter values
- Extract filter variables BEFORE the `(select ...)` query, never inline.
- Sections with different data
- Use `for section in sections do...end`, NOT a static array.
- empty
- Off by default. Opt-in pill: `empty: { enabled: true, value: "Keine Einträge", backgroundColor: "#fff", fontColor: "#888", fontWeight: 400 }` on the board or a swimlane.
- Header slots
- `slotLeft` (before the title) and `slotRight` (after the count) per swimlane — icon, badge, or button. Use them instead of a nested title layout with `showAmount: false`.
- Header without color
- `backgroundColorHeader: "transparent"` + dark `fontColor`. The drag outline keeps the dark default.
Custom Kanban
El Kanban representa datos de una tabla (tarjetas Kanban) en un estado determinado (en las swimlanes). Para ello, creas como es habitual una variable data, que luego emites en la función globalarcCustomKanban. Hay dos formas de crear un Kanban:
- dinámica (las swimlanes se refieren a una lista/tabla/bucle for)
- manual (las swimlanes se definen manualmente)
Código de aplicación dinámico
let current := this;
let listFirmen := (select Firmen);
let listStates := (select Status_Leads);
let data := {
uniqueId: "Kanban individuell",
height: "600px",
collapsible: true,
showScrollbar: true,
swimlanes: listStates.[{
title: Titel,
recordId: number(Nr),
backgroundColorHeader: text(color(Farbe)),
backgroundColorBody: "",
fontColor: "",
minWidth: "",
amount: let id := Nr;
cnt(listFirmen[number(Status) = number(id)]),
items: let id := Nr;
listFirmen[number(Status) = number(id)].[{
itemId: Nr,
fieldId: "D",
clickAction: false,
dragAction: true,
paddingX:",
paddingY: "",
borderPosition: "",
borderColor: "",
borderWidth: "",
title: Name,
subtitle: "Kunden-Nr.:" + Nr,
value: arcCustomProgressBar({
uniqueId: "progress" + Nr,
title: "",
width: "100%",
fontSize: "",
fontColor: "",
backgroundColor: "",
progressColor: "",
valueTotal: stateTotal,
valueProgress: stateCurrent,
valueText: stateCurrent + "/" + stateTotal
})
}]
}]
};
arcCustomKanban(data)
Configurar variables
let current := this; // Definiert diesen Record
let listFirmen := (select Firmen); // Definiert die Tabelle für die darzustellenden Inhalte
let listStates := (select Status_Leads); // Definiert die Liste für die Swimlanes
Ajustes generales en *data*
uniqueId es la denominación individual de tu Kanban. Asegúrate de asignar aquí un título único. Esto es importante si quieres representar varios Kanbans en una página y que tus ajustes de estilo no se sobrescriban entre sí.
uniqueId: "Kanban individuell",
height define la altura de tu Kanban.
height: "600px", // Pixel-Werte
height: "auto", // Passt die Höhe an die Inhalte an.
height: "100%", // Passt sich der Höhe des Funktionsfeldes an.
height: "", // Fallback-Wert: 100%
Con collapsible puedes configurar que el usuario pueda contraer o expandir las swimlanes con un clic en el control de la cabecera. El control es un chevron que gira al contraer.
collapsible: true, // Aktiviert die Funktion
collapsible: "", // Fallback-Wert = "false"
Como objeto, collapsible también acepta iconos propios para el control y el estado inicial. iconExpand se muestra mientras la swimlane está contraída (un clic la expande), iconCollapse mientras está abierta (un clic la contrae). Texto, string HTML o widget anidado — igual que title. Los iconos también valen para el control de los grupos (sections).
collapsible: {
defaultCollapsed: false, // true: todas las swimlanes empiezan contraídas
iconExpand: arcCustomIcon({ iconSet: "phosphor", name: "plus", iconSize: "14px" }),
iconCollapse: arcCustomIcon({ iconSet: "phosphor", name: "minus", iconSize: "14px" })
}
Con showScrollbar se puede mostrar la barra de scroll horizontal para todo el Kanban. Esto ayuda especialmente a los usuarios sin trackpad o tablet.
showScrollbar: true, // Scrollbar wird eingeblendet
showScrollbar: false, // keine Anzeige der Scrollbar
showScrollbar: "", // default: false
Con styles defines las medidas del Kanban.** *minWidth*** es el ancho mínimo de todas las swimlanes a la vez. Las swimlanes se reparten el ancho libre por igual; si fueran más estrechas, el Kanban se desplaza hacia los lados (actívalo con scrollSettings.scrollX). Un minWidth en una swimlane concreta tiene prioridad.
styles: { minWidth: "300px" }, // Pixel-Wert
styles: { minWidth: "" }, // Fallback-Wert: 150px
Con scrollBar muestras y diseñas las barras de scroll: la barra vertical dentro de cada swimlane y la barra horizontal de todo el Kanban bajo las swimlanes. Ambas están ocultas por defecto, el scroll sigue funcionando. Los campos son los mismos que en la tabla; el track no tiene color por defecto. board y lanes cambian solo una de las dos barras.
scrollBar: {
showScrollBar: true, // false: ausgeblendet (Standard), Scrollen funktioniert trotzdem
height: "8px",
backgroundColor: "", // Track, Standard: ohne Farbe
handle: { backgroundColor: "#9ca4a9", borderRadius: "5px" },
board: { showScrollBar: true }, // nur die horizontale Leiste
lanes: { showScrollBar: false } // nur die vertikalen Leisten
}
Ajustes de swimlane en *data*
El parámetro swimlane define la representación de cada una de las columnas de tu Kanban. Estas se definen dentro de los corchetes y llaves.
swimlanes: listStates.[{
}]</code></pre>
title define el título de cada swimlane. En este ejemplo puede ser el título de la tabla listStates - es decir, dinámico.
title: Titel, // Ninox-Feld im Textformat.
title: "Hans" // Text in ", wenn das Kanban manuell angelegt ist
title: "" // Kein Fallback hinterlegt.
recordId define el registro de la lista dinámica que has definido previamente. Aquí: listStates.
recordId: number(Nr), // Nr des jeweiligen Records aus der Liste
backgroundColorHeader define el color de fondo de la cabecera de cada swimlane.
backgroundColorHeader: text(color(Farbe)), // Ninox Feld , das Farbe referenziert (HEX Wert ausgibt)
backgroundColorHeader: "#000", // HEX Wert in "
backgroundColorHeader: " ,// Fallback-Wert: #18181b
backgroundColorBodydefine el color de fondo del cuerpo (Body) de la swimlane.
backgroundColorBody: text(color(Farbe)), // Ninox Feld , das Farbe referenziert (HEX Wert ausgibt)
backgroundColorBody: "#000", // HEX Wert in "
backgroundColorBody: "", // Fallback-Wert: #f4f4f5
fontColor define el color de fuente de la cabecera.
fontColor: "#000", // Hex-Wert in "
fontColor: "", // Fallback-Wert: #fff
minWidth indica el ancho mínimo de las swimlanes. Esto evita que las swimlanes se compriman cada vez más en pantallas pequeñas. Así tus contenidos siempre se muestran bien legibles, ya que se puede desplazar hacia la derecha.
minWidth: "300px", // Pixel-Wert in "
minWidth: "", // Fallback-Wert: 150px
empty muestra una pill en las columnas vacías. Por defecto: desactivado. En el board para todas las columnas, o por swimlane (sobrescribe el board). true / "true" es el antiguo interruptor abreviado.
empty: {
enabled: true,
value: "Keine Einträge",
backgroundColor: "#fff",
fontColor: "#888888",
fontWeight: 400
}
empty: true
empty: "" // Default: keine Pill
amount define qué cantidad se muestra en la cabecera de la swimlane. Número, string HTML o widget anidado — igual que title. Vacío / omitido oculta la burbuja. Un número se actualiza inmediatamente al mover una tarjeta. HTML o un widget permanece sin cambios (sin contador automático) y solo se actualiza con el siguiente reload de Ninox.
amount: let id := Nr; cnt(list[number(Status) = number(id)]),
amount: "<b>" + cnt(list[number(Status) = number(id)]) + "</b>",
amount: "" // Kein Fallback-Wert. Die Amount-Bubble wird in diesem Fall ausgeblendet.
slotLeft y slotRight añaden contenido a la cabecera de la swimlane: slotLeft delante del título, slotRight detrás de la burbuja de recuento. Texto, string HTML o widget anidado — igual que title. Lo típico: un punto de estado a la izquierda y un botón a la derecha. Los clics en un slot se quedan en su contenido y no contraen la swimlane.
slotLeft: arcCustomIcon({ iconSet: "phosphor", name: "circle", style: "fill", color: text(color(Farbe)), iconSize: "10px" }),
slotRight: arcCustomButton({ uniqueId: "lane-add-" + Nr, title: "+", paddingX: "0.6em", paddingY: "0.3em", actions: [...] }),
slotLeft: "" // Kein Fallback-Wert. Der Slot wird in diesem Fall ausgeblendet.
Para una cabecera sin color, pon la cabecera transparente y el texto oscuro. La burbuja de recuento sigue el color del texto; el contorno al arrastrar sigue siendo oscuro.
backgroundColorHeader: "transparent",
fontColor: "#18181b",
Ajustes de Item (Cards) dentro de *swimlanes*
El parámetro items define la representación de tus tarjetas dentro de la swimlane. Estos se definen dentro de los corchetes y llaves.
items: let id := Nr;
listFirmen[number(Status) = number(id)].[{
}]</code></pre>
itemId define el registro de la lista de items. aquí: listFirmen.
itemId: Nr, // Record-Id
fieldId define el campo que debe cambiar al pasar de swimlane. En la mayoría de los casos es el estado.
fieldId: "D", // Field ID findest du mit dem arcFieldFinder heraus
clickAction controla el clic sobre la tarjeta. Compatible con Legacy:
false → sin clictrue / omitir / "" → abre el registro mediante popupRecord (itemId)- Objeto (o array) → una acción como en Calendar/Layout (p. ej.
{ type: "popup", recordId: Nr })
clickAction: false, // Deaktiviert die Klick-Aktion
clickAction: true, // Fallback: popupRecord(itemId)
clickAction: {
type: "popup",
recordId: Nr
},
clickAction: {
type: "update",
recordId: helperRecordId,
fieldId: "A",
value: Nr
},
actions (Array) — vía preferida para varias acciones en el clic. Tiene prioridad sobre clickAction (excepto clickAction: false). Mismos tipos de acción que Calendar/Layout (popup, update, openRecord, create, …).
actions: [{
type: "popup",
recordId: Nr
}, {
type: "update",
recordId: helperRecordId,
fieldId: "A",
value: Nr
}],
dragAction define si el usuario puede mover la tarjeta mediante drag and drop.
dragAction: false, // Deaktiviert die Drag & Drop Funktion.
dragAction: "", // Fallback-Wert: true
paddingX define el espacio entre el borde y el contenido a la derecha e izquierda dentro de la tarjeta.
paddingX: "10px" // Pixel-Wert in "
paddingX:", // Fallback-Wert: 12px
paddingY define el espacio entre el borde y el contenido arriba y abajo dentro de la tarjeta.
paddingY: "10px" // Pixel-Wert in "
paddingY: "", // Fallback-Wert: 12px
borderPosition define si quieres mostrar un borde unilateral en la tarjeta. Este podría, mediante el color, representar otro atributo/categoría de tus contenidos (por ejemplo, Activo / Inactivo)
borderPosition: "left", // Border auf der linken Seite
borderPosition: "right", // Border auf der rechten Seite
borderPosition: "top", // Border auf der oberen Seite
borderPosition: "bottom", // Border auf der unteren Seite
borderPosition: "", // Fallback-Wert: keine border
borderStroke define el estilo de línea de un borde unilateral (borderPosition). La línea se dibuja dentro de la tarjeta con extremos redondeados y mantiene distancia a las esquinas redondeadas. Sin borderPosition no tiene efecto.
borderStroke: "solid", // Valor por defecto
borderStroke: "dashed",
borderStroke: "dotted",
Con borderPosition la línea mide 3px de ancho por defecto; con borderWidth lo cambias.
insetBorder dibuja dentro de la tarjeta una línea dividida en segmentos, p. ej. un color por persona. position (left es el valor por defecto, right, top, bottom), width, stroke y color valen para toda la línea; align (start, center, end) coloca los segmentos fijos que no la llenan. Los campos de insetBorder ganan frente a borderPosition, borderColor, borderWidth y borderStroke.
insetBorder: {
position: "left",
width: "3px",
stroke: "solid",
color: "#18181B", // valor por defecto de los segmentos
segments: [
{ color: "#DC2626", label: "Anna" }, // label = tooltip
{ color: "#2563EB", label: "Ben", size: "24px" }, // longitud fija
{ color: "#16A34A", label: "Clara", stroke: "dashed" } // size: "fraction" (o "auto") = repartir el resto
]
}
La línea está activa por defecto: cada tarjeta muestra una línea negra en su borde izquierdo. insetBorder: false (o { enabled: false }) la oculta; si defines insetBorder en los datos del tablero, cambias la línea de todas las tarjetas a la vez. Orden de prioridad: insetBorder del tablero, luego borderPosition / borderColor / borderWidth / borderStroke, luego el insetBorder propio de la tarjeta.
size es "fraction" o "auto" (ambos reparten el resto por igual, el valor por defecto) o una longitud como "24px" o "25%". Si los tamaños fijos suman más que la línea, todos los segmentos se reducen en la misma proporción. La línea queda a 6px del borde de la tarjeta y el texto mantiene 8px de distancia.
borderColor define el color de tu borde.
borderColor: if aktiv=true then "#c5f2b3" else "#ccc"// HEX-Wert in "
borderColor: "", // Fallback-Wert:
borderWidth: "1px", // Pixel-Wert in "
borderWidth: "", // Fallback-Wert:
title muestra el título superior en la tarjeta y aparece en negrita.
title: Name, // Ninox-feld in Text-Format
title: "" // Kein Fallback
subtitle: "Kunden-Nr.:" + Nr, // Text und/oder Ninox Felder in Textformat
subtitle: arcCustomLayout({ uniqueId: "sub-" + Nr, embedded: true, ... }), // gleiches Slot wie value
subtitle: "", // Kein Fallback
Con value puedes diseñar tu tarjeta de forma tan individual como quieras. Aquí puedes trabajar con texto o integrar cualquier otro widget. Por ejemplo, puedes usar <a href="/documentation/custom-layout">arcCustomLayout</a> para crear tarjetas más complejas o simplemente insertar una barra de progreso con <a href="/documentation/progress-bar">arcCustomProgressBar</a>.
value: "Hier steht Text" // Texte oder Werte aus Ninox-Feldern
value: arcCustomProgressBar({
uniqueId: "progress" + Nr,
title: "",
width: "100%",
fontSize: "",
fontColor: "",
backgroundColor: "",
progressColor: "",
valueTotal: stateTotal,
valueProgress: stateCurrent,
valueText: stateCurrent + "/" + stateTotal
}) // Andere Widgets
value: "", // Kein Fallback