Arc Rider Docs · Markdown

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 clic
  • true / 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