Skip to content

WidgetDateTimeReadOnly ​

Overview ​

Read-only presentation for date, time, and datetime fields. Wraps {@link WidgetReadOnly} so the row keeps its label association, theme slots, and lookup behavior, and fills the value with {@link DateTimeDisplay} instead of the raw serialized string.

fieldMappings selects this widget through readOnlyWidget and supplies the per-type display options through readOnlyWidgetProps, which mirror the columnProps that columnMappings gives ColumnDateTime. A read view and a list therefore format the same field the same way, and an empty value renders the same dash in both.

A consumer's own default slot still wins: this widget supplies the date rendering only when the field has no widget(fieldName)default override.

Props ​

NameTypeRequiredDefaultDescription
formatstring|object"absolute"Display layout passed to DateTimeDisplay; "absolute" matches the list column adapter.
showTimebooleantrueWhether to include the time portion in the absolute output.
showRelativebooleantrueWhether to show the relative time label.
showTooltipbooleantrueWhether to show the complementary representation as a hover tooltip.
tooltipFormatstring|object"default"Luxon format used for the tooltip when a custom format is active.

Slots ​

slotName ​

Scoped slot.

Source ​

client/lib/widgets/WidgetDateTimeReadOnly.vue