In this article, you will learn:
- What are widget triggers?
- How can you use widget triggers?
- Example widget trigger use cases
Widget Triggers are configured logic that automatically runs when users interact with Widgets.
Widget triggers can streamline how your users interact with Tulip Player by removing the need for Next buttons.
How to use widget triggers
Widget triggers are available for all buttons, Input Widgets, and the interactive table widget. Often, these triggers run when the value of that input changes. So, when users toggle a checkbox or select a value from a single select, the triggers will run.
Learn more about input widgets.
Text and number inputs
Text and number inputs work slightly differently than other input widgets, in that they fire when the [Enter] key is pressed.
In the case of the text input widget, users may need to enter multi-line values to enter content. These inputs will cause the widget triggers to run; ensure this behavior is supported by your widget trigger logic.
Example
I want users to enter an order number at the beginning of our application (to eventually process that order). Users will be manually entering this order number, but we have been having issues where users arent following the correct order number format.
My order numbers follow the pattern: Order 1234-567 and I want to make sure users have entered this order correctly before allowing them to proceed. This behavior can be achieved with a Regular Expression (Regex), but we can leverage input triggers to do this validation automatically in the background, streamling the process for our users.
In this case, the correct regular expression is "Order: [0-9]{4}-[0-9]{3}". To check this automatically, I can add this Widget trigger.
Interactive table widget
When a row is selected in the interactive table widget, the row will be loaded into a Linked Placeholder, if a Linked Placeholder has been mapped.
On top of loading the selected record into a Record Placeholder, a trigger is also run when a Record is loaded.
Learn more about interactive table widgets.
Example
When users select an order from our backlog of open orders, we need to set the status of that order to IN PROGRESS. This could be done with a normal button Trigger, but we can streamline the user experience by building this directly into the Widget.
Additionally, when users select an order, we will move users to the next step in our application, where users can act on that order
Further reading
- Working with Time in Triggers
- How to add a Regular Expression to a Trigger
- How to use the Expression Editor
Did you find what you were looking for?
You can also head to community.tulip.co to post your question or see if others have solved a similar topic!