Skip to content
Verified

Component events

The event types a component can react to, and what each one is for.

What events do

Events tell a component when to do something. Give an event a workflow and the component can react on its own, instead of waiting for someone to trigger every action by hand.

Event types

A component has more event types available than any other program:

Screen ready vs. On refresh

Putting refresh work in Screen ready re-runs your create code against DOM that already exists, and stacks a second widget on top of the first. Create widgets in Screen ready; hand new data to them in On refresh.

Add an event

An empty Events tab shows an Add event button. Choosing it creates a new row and selects it, ready to shape from the Properties panel.

Event properties

Use Properties to set the event's type, name a User defined event, add an optional condition, pass parameters in, and build its workflow.

Condition

A condition controls whether the event runs at all: only when a record exists, or a value matches what you expect.

Parameters

Parameters pass values into the event, such as which record, field or value it should work with.

Workflow

The workflow is what actually happens when the event fires. See Events, Workflow for the full action catalog.