Button

The Button element triggers an action when clicked. Three action types are available: submitting the form, navigating to a URL, or running a custom script.

Properties

Action

Property	Type	Description
type	submit / url / script	The action performed when the button is clicked
label	string	Button label text
script	string	JavaScript to execute — only used when type is script
url	string	URL to navigate to — only used when type is url
visibility	string	Conditional expression — the button is hidden when this evaluates to falsy. See Visibility

Appearance

Property	Type	Description
color	string	Colour token — primary, secondary, accent, positive, negative, warning, info, or a custom CSS colour
size	xs / sm / md / lg / xl	Button size
dense	boolean	Compact/reduced-padding style
fullWidth	boolean	Stretch the button to fill the full column width
rounded	boolean	Pill-shaped corners
outlined	boolean	Outline-only style — no background fill
unelevated	boolean	Remove drop shadow
push	boolean	3-D push-button style
glossy	boolean	Add a glossy sheen overlay

Plus shared layout properties.

Action types

• submit — validates the form and sends the submission to the server. The form's on_submit script runs before the request is sent.
• url — navigates the browser to the configured URL. Useful for linking to an external resource or another page after the user has reviewed the form.
• script — executes the JavaScript string in script in the context of the current form. Use for custom actions that don't fit the standard submit or navigate flows.

---

See also: Elements overview