Button
Runs actions on click — trigger a workflow, refresh data, or update app state.
Runs actions on click — trigger a workflow, refresh data, or update app state.
Add it to an app
- Open the app builder and find Button in the component palette.
- Insert it into the intended region or container.
- Set its properties in the inspector. Use a literal for a fixed value or a binding for a value supplied by the app.
- Connect its events where the app should respond to a user gesture.
- Preview with representative data and save after resolving validation problems.
The type name in the builder’s code view is button.
Settings
| Setting | Accepted value | Required | Default | What it controls |
|---|---|---|---|---|
Busy (busy) | boolean | No | Not specified | Supports expression bindings. Truthy disables the button and blocks onClick. |
Text (text) | string | No | "Button" | The button label. The listed default is inserted when adding a new component. |
Layout controls
Additional host-rendered controls: sectionTitle. These control the surrounding component region rather than the record values.
Values available to bindings
This component declares no published values. Use its settings and any events to configure its behaviour.
Events
onClick— Clicked while not busy.
Connect only the actions the app needs. An event can fetch results, run an enabled data source, set state, update another component, show a notification, or navigate where supported.
Keyboard and accessible labels
Accessible label source: text.
- Enter/Space activate it.
Example: Run a workflow
| Setting | Example value |
|---|---|
text | "Check now" |
When onClick occurs, the example performs:
triggerDataSourcewith {"dataSourceId":"checks","inputRecords":[{"url":"{{ components.UrlInput.value }}"}],"mode":"run"}
Example: Sidebar refresh, busy while running
| Setting | Example value |
|---|---|
busy | "{{ dataSources.news.isRunning }}" |
sectionTitle | "Actions" |
text | "Refresh" |
When onClick occurs, the example performs:
triggerDataSourcewith {"dataSourceId":"news","mode":"run"}
If it is empty or unavailable
Check the source binding, the selected item, and the app’s access. A hosted document, table, review, or storage component needs the corresponding app capability; an offline preview cannot supply live private data. A source running with no results is different from an invalid binding. Inspect the app’s workflow and data source before changing the presentation.