leftPanel

Left-docked panel. Root-only — must be a top-level child of the screen builder, not nested inside another container. Wraps the supplied children in a leftPanel node that the layout engine docks against the left edge of its parent screen.

Exports

• leftPanel(children: { WidgetNode }, opts: table?) -> WidgetNode — module returns the builder function directly.

opts is forwarded verbatim to the underlying node.

Usage

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

Z.app(function()
    return {
        Z.leftPanel({
            Z.lbl("Sidebar"),
            -- ...
        }),
        Z.centralPanel({
            -- main view
        }),
    }
end)

Notes

• Must be a root-level child of the screen builder; nesting it inside another container is unsupported.
• nil children are treated as an empty array.
• Stateless.