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:
| Bisher | Jetzt |
|---|---|
link | value |
backgroundSize: "cover" / "contain" | objectFit: "cover" / "contain" |
backgroundSize: "auto" | objectFit: "none" |
radius oder borderRadius | border.radius |
borderColor | border.color (Linie 1px solid) |
style | styles |
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, setztbackgroundColor: "#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%" }
}
}