Triggers
Triggers let you perform Actions in your app, such as when interactive components like pressable, swipeable, or input components, are engaged by the user. Or when a Screen loads.
For example, a Button component has multiple Triggers, including the most obvious one - On Press. Using a Button's On Press Trigger, you can configure any of the available Actions to run when that Button is pressed.
If a component has any Triggers, they will be listed in the Interactions tab in the right panel of the Builder. The Triggers that are available will depend on the type of component you want to run Actions with. For example, our Button doesn't have an On Swiped Right Trigger, but our Deck Swiper component does.
Below is a list of some common Triggers, but it's not complete. Refer to the docs or Interactions tab for a specific component to see which Triggers are available to it.
Name | Description | Components |
|---|---|---|
On Blur | Starts the action when the element is blurred/unfocused | Text Area Text Input |
On Change | Starts the action when the value is changed | Stepper |
On Change Text | Starts the action when the text is changed | Text Area Text Input Number Input Styled Text Area Styled Text Field |
On Change Text Delayed | Starts the action after a given delay from when editing has stopped (debouncing) | Text Area Text Input |
On Check | Starts the action when the checkbox is checked | Checkbox Checkbox Row |
On Date Change | Starts the action when the date is changed | Date Picker |
On End Reached | Starts the action when the end threshold is reached | List FlashList Masonry List |
On Focus | Starts the action when the element is focused | Text Area Text Input |
On Index Changed | Starts the action when swiped | Swiper |
On Long Press | Starts the action when the element is long pressed. | Button Touchable Pressable |
On Press | Starts the action when the element is pressed. | Button Icon Button Link Touchable Checkbox Checkbox Row Radio Button Star Rating Action Sheet Item Action Sheet Cancel Map Callout |
On Refresh | Starts the action when the element is refreshed | List FlashList Masonry List |
On Return Key | Starts the action when the Return/Enter key is pressed | Text Input |
On Screen Focus | Runs every time the screen comes into focus | Screen |
On Uncheck | Starts the action when the checkbox is unchecked | Checkbox Checkbox Row |
On Value Change | Starts the action when the value is changed | Picker Radio Button Group Slider Switch Switch Row |
Updated 5 months ago