Widgets

/

interact

Select

A labelled choice from options.

A choice from a list

Select is a labelled drop-down. options is a list, value the chosen one, and .fnc { … } runs with the new value.

LAYROpen in playground
Page(
  .name(Booking)
  .route('/')
  var txt room = 'Room B'
  Scaffold(
    .config(color: canvas)
    .body(
      Column(
        .config(gap: 12, padding: all(24))
        Select(
          .config(
            label: 'Room'
            options: ['Room A', 'Room B', 'Room C']
            value: room
          )
          .fnc { room = value }
        )
        Text(.config(color: muted) .obj('Booking $room'))
      )
    )
  )
)

Config keys

KeyTypeDefaultMeaning
valuetxtSelected value.
optionsanyList of options or (value, label) tuples.
labeltxtLabel.
disabledboolDisabled.
w (width)len | fill | hugWidth: a length, fill (share the remaining space) or hug (fit content, default).
h (height)len | fill | hugHeight: a length, fill or hug (default).
size (s)sizeWidth and height together: size: 200 or size: (200, 120).
minW (minWidth)lenMinimum width.
maxW (maxWidth)lenMaximum width.
minH (minHeight)lenMinimum height.
maxH (maxHeight)lenMaximum height.
aspect (aspectRatio)numAspect ratio (width / height), e.g. 16/9.
margininsetsSpace outside the object: all(8), sym(x: 8, y: 4), only(top: 8).
opacitynumOpacity from 0 to 1.
hide (hidden)boolRemoves the object from layout and the accessibility tree.
shrinknum1Shrink priority when space runs out. Lower shrinks first; 0 never shrinks.
flexnum1Share of remaining space for fill sizes.
cursorauto | pointer | text | grab | grabbing | move | notAllowed | crosshair | nonePointer cursor.
className (class)txtExtra CSS class names: styling hooks for your own stylesheet (hover rules, third-party CSS).

Events

.fnc runs on change. .on(...) accepts tap, press, hover, hoverEnd, focus, blur, key, drag, swipe, mount, unmount, visible.