Builtin Library
README.md
bottomPanel
Bottom-docked panel. Root-only — must be the top-level widget of its
registered screen. Pairs with centralPanel (and optionally topPanel /
leftPanel / rightPanel) for a docked app shell — register each as
its own screen with appropriate layer ordering.
Exports
This module returns the widget factory directly. There is no returned table.
bottomPanel(children: { Node }?, opts: PanelOpts?) -> Node— build a bottom-docked panel node.
Types:
Node = { [string]: any }— opaque widget node.PanelOpts = { id: string?, classes: ({ string } | string)?, class: ({ string } | string)?, props: { [string]: any }?, style: { [string]: any }? }
Usage
local bottomPanel = require("@builtin::modules.zui.widget.bottomPanel")
local statusBar = bottomPanel({
Z.hbox{ Z.lbl("Status: OK"), Z.flex(), Z.lbl("v0.1.0") },
}, { id = "status" })
ui.registerScreen("statusBar", statusBar)
Notes
- Root-only — the widget MUST be the top-level node of its registered screen.
- Children can be a single Node or an array;
nodenormalises a single child to{ child }so callers don't have to wrap manually. classes/classaccept either an array of strings or a single space-separated string —nodenormalises both forms.- Pairs with the other panel widgets for a docked app shell; register each on its own screen so layer ordering / visibility can be controlled independently.