Widgets

/

interact

Input

A labelled text input. .fnc runs on change with the new value.

Also written TextField; layr format rewrites these to Input.

A labelled field

Input is a text field with its label (always present for screen readers). .fnc { … } runs on every change with the new value; store it in state and show it anywhere. kind picks the keyboard and validation (email, password, number, search, tel, url), and multiline: true makes a text area.

LAYROpen in playground
Page(
  .name(Signup)
  .route('/')
  var txt name = ''
  Scaffold(
    .config(color: canvas)
    .body(
      Column(
        .config(w: 320, gap: 12, padding: all(24))
        Input(
          .preset(default)
          .config(label: 'Your name', placeholder: 'Ada', value: name)
          .fnc { name = value }
        )
        Text(
          .config(color: muted)
          .obj(name == '' ? 'Type your name above.' : 'Hello, $name.')
        )
      )
    )
  )
)

Config keys

KeyTypeDefaultMeaning
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.
color (bg, background, colorBG)paintBackground paint: a colour or gradient.
padding (pad)insetsSpace inside the object.
cornerRadius (radius, borderRadius, corner)radiusCorner radius: one length or only(topLeft: 8, …).
borderWidthlenBorder width.
borderColorcolorBorder colour.
borderAlignin | mid | outinWhere the border sits relative to the edge: in, mid or out.
borderStylesolid | dashed | dottedsolidBorder line style.
borderSidesall | top | bottom | left | right | x | yallWhich sides draw the border (inside the box).
shadowshadowDrop shadow(s): shadow(y: 4, blur: 12, color: black.alpha(20%)).
clipboolClip children to the object's bounds (and corner radius).
zintStacking order among siblings.
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).
valuetxtCurrent value (bind a var to make it two-way).
labeltxtLabel (required for accessibility).
placeholdertxtPlaceholder.
kindtext | email | password | number | search | tel | urltextInput kind.
multilineboolA multi-line text area.
rowsintVisible rows for multiline.
disabledboolDisabled.
requiredboolRequired.

Group .border(align, color, width, style, sides): Border settings grouped: .border(align: in, color: #0d0d0d, width: 2).

Events

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