NUI / Components / Scroll, Lists & Data

DynamicEntryBox

ImplementedScroll, Lists & Data

DynamicEntryBox generates repeated entries from inline items or a data source.

Supported as a repeated-entry data component.

Overview

DynamicEntryBox generates repeated entries from inline items or a data source.

When to use

  • Repeated buttons.
  • Quick actions.
  • Generated rows.
  • Generated tiles.
  • Data-driven entry groups.

Children

Uses data/template fields instead of normal children.

Basic syntax

nui
DynamicEntryBox ActionEntries {
    items: "attack|Attack|1;defend|Defend|2"
}

Supported properties

PropertyTypeRequiredDefaultDescription
itemsstringNoEmptyInline item data.
dataSourcestringNoEmptyNamed external data source.
itemKeystringNoEmptyField or static key binding.
itemTextstringNoEmptyField or static display text binding.
itemValuestringNoEmptyField or static value binding.
itemCommandstringNoEmptyCommand when an entry is used.
layoutenumNoverticalEntry layout mode.
entryWidthnumberNoDefaultEntry width.
entryHeightnumberNoDefaultEntry height.
entrySpacingnumberNo0Space between entries.
recycleEntriesboolNotrueReuses entry widgets.
recyclePoolSizeintegerNoDefaultRecycle pool size.
widthnumberNoAutoDesired width.
heightnumberNoAutoDesired height.
visibleboolNotrueVisibility flag.

Contextual properties

Contextual property rules

DynamicEntryBox may receive stack, canvas, grid, wrap, or ExpandableArea slot properties only when it is authored as a direct child of the matching parent. It does not support normal authored child nodes.

Full syntax example

nui
DynamicEntryBox ActionEntries {
    items: "attack|Attack|1;defend|Defend|2"
    itemKey: "id"
    itemText: "label"
    itemValue: "value"
    itemCommand: "RunAction"
    layout: horizontal
    entryWidth: 120
    entryHeight: 36
    entrySpacing: 8
    recycleEntries: true
    recyclePoolSize: 16
    width: 420
    height: 80
    visible: true
}

Limitations

  • Normal children { ... } blocks are not public syntax for this component.
  • For radial layout, document radialStartAngle and radialArc only on a dedicated radial example page after verification.