Widget reference

HTML widget: vrije content, toelichting en sfeerblokken

De HTML widget is bedoeld voor content die geen datasource nodig heeft: uitlegblokken, waarschuwingen, onboardingpanelen, call-to-actions en andere rich-text onderdelen die een dashboard vriendelijker en begrijpelijker maken.

1. Wanneer gebruik je deze widget?

Intro of context

Gebruik HTML voor uitleg boven een dashboard, definities van KPI’s of instructies bij een operationele workflow.

Callout of waarschuwing

Handig voor opvallende berichten zoals onderhoud, datakwaliteitsopmerkingen of actiepunten.

Visuele rust

Een slim ontworpen HTML-blok kan een druk dashboard structureren zonder extra databron of chartlogica.

Niet voor

Gebruik geen HTML widget voor interactieve data-analyse; daarvoor zijn standaard widgets of een Element meestal geschikter.

2. Beschikbare instellingen

HTML widget editor

Je beheert hier ruwe HTML-content, sanitizing en de uiteindelijke weergave.
Laat sanitize aan tenzij je een heel concrete reden hebt om dit uit te zetten.
Gebruik deze widget voor begeleidende content, niet als vervanging voor echte databronwidgets.

Controleer altijd zowel de bronmarkup als het uiteindelijke renderresultaat op dezelfde pagina.

Kernvelden

content: de markup die Dashview rendert.
sanitizeHtml: standaard true; laat dit aan tenzij je exact weet waarom je ongefilterde markup nodig hebt.

Een lege widget is meestal een signaal dat er nog geen bruikbare content is ingevuld.

Key	Type	Gedrag
`content`	string	Wordt opgeslagen als HTML-string, ook wanneer die slechts uit tekst bestaat.
`sanitizeHtml`	boolean	Beveiligt de widget tegen onveilige markup. Alleen uitzetten voor gecontroleerde, vertrouwde content.

3. Best practices

Schrijf voor mensen, niet voor markup. Gebruik korte blokken, duidelijke koppen en voldoende witruimte.
Gebruik HTML widget voor vriendelijke begeleiding, niet als verborgen technische configuratieplek.
Stem kleuren en typografie af op het tenant-thema, zodat de widget niet los voelt van de rest van het dashboard.
Houd rekening met mobiel. Grote tabellen of ingewikkelde nested layouts werken slecht in deze widget.

4. Veiligheid en onderhoud

Sanitize standaard aan

Dat is de veilige keuze voor vrijwel alle gewone contentwidgets.

Geen scripts

Voeg geen scripts, inline event handlers of externe injecties toe. Dat maakt dashboards onvoorspelbaar en onveilig.

Gebruik de juiste tool

Wanneer je logica, externe requests of runtime-data nodig hebt, gebruik dan liever een Form-, Webhook- of Element-widget.

HTML widgets zijn krachtig, maar blijven bedoeld als presentatielaag. Houd businesslogica buiten de markup.

5. Voorbeeldconfiguratie

{
  "content": "<section class='help-card'><h3>Dagstart</h3><p>Controleer eerst de open meldingen en daarna de afwijkingen in de omzetgrafiek.</p></section>",
  "sanitizeHtml": true
}