Arc Rider Docs · Markdown

Mini Widgets

Images

Images

AI Defaults
Function name
`arcCustomImage`.
value
Bild-URL, Ninox-Share-Link oder Data-URL. Ältere Formeln mit `link` funktionieren weiter.
uniqueId
pro Bild eindeutig, z. B. `"ProjektBild" + Nr`.
alt
Textalternative für Screenreader; ohne `alt` wird `title` verwendet.
width
, **height**: Größe der Box. Ohne beides erscheint das Bild in natürlicher Größe, höchstens so breit wie der Container.
initials
Kürzel statt Platzhalter-Icon, solange es kein Bild gibt oder es nicht lädt, z. B. `initials: substr(text(Vorname), 0, 1) + substr(text(Nachname), 0, 1)`. Dazu die Person in **alt** benennen.
objectFit
`"cover"` (füllt und schneidet zu) oder `"contain"` (zeigt alles, Standard). Ältere Formeln mit `backgroundSize` funktionieren weiter.
border
`{ color, width, style, radius, sides }`, z. B. `border: { radius: "50%" }` für einen Kreis. Ältere Formeln mit `radius` / `borderColor` funktionieren weiter.

Custom Image

Mit Images zeigst du Bilder in Tabellen, Kanban, Layouts oder anderen Widgets: Fotos, Logos, Avatare. Die Box behält ihre Größe, während das Bild lädt. Gibt es kein Bild oder lädt die URL nicht, erscheint ein Platzhalter-Icon.

arcCustomImage({
    uniqueId: "ProjektBild" + Nr,
    value: text(Projekt.'Bild URL'),
    alt: "Projektfoto",
    title: "Projektfoto",
    width: "80px",
    height: "80px",
    objectFit: "cover",
    border: {
        color: "#E4E4E7",
        radius: "8px"
    }
})

Bestehende Formeln

Formeln mit den bisherigen Parametern laufen unverändert weiter. Sie werden so übersetzt:

BisherJetzt
linkvalue
backgroundSize: "cover" / "contain"objectFit: "cover" / "contain"
backgroundSize: "auto"objectFit: "none"
radius oder borderRadiusborder.radius
borderColorborder.color (Linie 1px solid)
stylestyles

Prozent- und Pixelwerte in backgroundSize (z. B. "50%") gibt es nicht mehr; solche Bilder werden mit contain eingepasst. Die Größe stellst du über width und height ein.

Zwei Dinge sehen jetzt etwas anders aus:

  • Hinter einem geladenen Bild ist die Box transparent statt hellgrau. Wer die graue Fläche um ein contain-Bild behalten will, setzt backgroundColor: "#f0f2f6".
  • Mit height: "auto" war die Box bisher leer und null Pixel hoch. Jetzt folgt die Höhe dem Bild.

Allgemeine Settings

uniqueId

Die uniqueId vergibst du pro Bild eindeutig, z. B. mit der Datensatz-Nummer. Fehlt sie, vergibt das Widget selbst eine ID und schreibt eine Warnung in die Konsole.

uniqueId: "ProjektBild" + Nr // Text + Ninox Nr

value

Die Bildquelle: eine URL, ein Ninox-Share-Link oder eine Data-URL. Ohne Wert erscheint der Platzhalter.

value: text(Projekt.'Bild URL'),

alt

Textalternative für Screenreader. Ohne alt wird title verwendet. Bei rein dekorativen Bildern beides weglassen.

alt: "Logo der Firma " + Firma.Name,

title

Tooltip beim Überfahren mit der Maus.

title: "Logo",

width

Mit width stellst du die Breite der Box ein. Ohne width ist die Box so breit wie das Bild, höchstens so breit wie der Container.

width: "100%", // volle Breite
width: "100px", // Pixel-Werte

height

Mit height stellst du die Höhe der Box ein. Ohne height (oder mit "auto") folgt die Höhe dem Bild.

height: "auto",
height: "300px",

aspectRatio

Seitenverhältnis der Box. Die Box nimmt die volle Breite (oder width), die Höhe folgt dem Verhältnis. Praktisch für Karten, deren Bilder unterschiedliche Formate haben.

aspectRatio: "16/9",
aspectRatio: "1", // quadratisch

objectFit

Mit objectFit bestimmst du, wie das Bild eine Box mit fester Größe füllt.

objectFit: "cover", // füllt die Box komplett, schneidet dabei zu
objectFit: "contain", // zeigt das ganze Bild (Standard)
objectFit: "fill", // verzerrt auf die Box
objectFit: "none", // Originalgröße

objectPosition

Welcher Teil sichtbar bleibt, wenn das Bild zugeschnitten wird.

objectPosition: "top",
objectPosition: "50% 20%",

backgroundColor

Mit backgroundColor bestimmst du die Farbe hinter dem Bild, sichtbar um ein contain-Bild und hinter transparenten Pixeln. Ohne Wert ist die Box transparent; beim Laden und im Platzhalter ist sie hellgrau.

backgroundColor: "#1D8C96",
backgroundColor: "transparent",

initials

Mit initials zeigst du ein kurzes Kürzel statt des Platzhalter-Icons, solange es kein Bild gibt oder es nicht lädt. Ideal für Profile ohne Foto. Angezeigt werden höchstens drei Zeichen in Großbuchstaben, die Schrift wächst mit der Box. Während das Bild lädt, bleibt die Box grau. Benenne die Person zusätzlich in alt, damit Screenreader den Namen vorlesen.

initials: "JJ",
initials: substr(text(Vorname), 0, 1) + substr(text(Nachname), 0, 1),

fontColor

Farbe der initials. Standard: dunkelgrau.

fontColor: "#FFFFFF",

border

Linie und Abrundung der Box. Die Linie erscheint, sobald color, width, style oder sides gesetzt ist; radius allein rundet nur die Ecken.

border: { radius: "8px" },
border: { color: "#E4E4E7", width: "1px", radius: "50%" },

loading

Bilder laden erst, wenn sie ins Bild scrollen ("lazy", Standard). Das spart in langen Tabellen viel Ladezeit. "eager" lädt sofort.

loading: "eager",

styles

Eigene CSS-Deklarationen, die zuletzt auf die Box angewendet werden.

styles: "opacity: 0.3;",

Verschachtelt in anderen Widgets

In Layout-Blöcken, Tabellenzellen und anderen Slots kannst du das Bild als Descriptor einsetzen:

value: {
    widget: "arc-widget-image",
    uniqueId: "Avatar" + Nr,
    data: {
        value: text(Mitarbeiter.'Foto URL'),
        alt: Mitarbeiter.Name,
        width: "32px",
        height: "32px",
        objectFit: "cover",
        border: { radius: "50%" }
    }
}