vbox

Vertical layout container. Children stacked top-to-bottom; spacing via style.gap; horizontal alignment via style.align ("start" | "center" | "end").

Exports

• vbox(children, opts?) -> Node — returns the vertical-layout widget node. Module returns the builder function directly.

Types:

• VboxOpts = { id?, classes?, props?, style? }

Usage

local vbox = require("@builtin::modules.zui.widget.vbox")

vbox({ header, body, footer }, { style = { gap = 8, align = "center" } })

Notes

• Pairs with hbox for horizontal layouts and wrap/grid widgets for more complex flows.
• style.gap is the spacing between children, not padding around the container — use style.padding for the latter.