Pages, Foregrounds and Components can have Actions added to them. Pages, Foregrounds and Components have Events listed under the ‘Actions’ tab in the ‘Properties Inspector’ that are used to trigger the Actions. Multiple Actions can be added to any Event.
How to add Actions to a Component
Select the component in the scene tree that you want to add an action to. We are using a ‘Button’ component in this example. When the user presses the button component we want them to be taken to the ‘About’ page.
Select the event you want to add the Action to. In this example we are using the ‘On Press’ event.
Click the “plus” symbol to the right of the ‘On Press’ event.
Clicking the ‘plus’ symbol takes you to the ‘Action Selector’, ‘Basic’ tab (or the last category of actions you had open). There are currently over 80 actions and they are sorted into categories with similar functionality.
In this example, we are going to select the ‘Navigation‘ tab because when the user presses the button component we want them to be shown the specific ‘About’ page.
NOTE: There is also a handy search panel on the top right of the ‘Action Selector’. You can type in key words for the type of action you want and get a list of Actions related to the keyword. Results may cross categories.
After selecting the ‘Navigation’ tab, select the ‘Show Page’ action and click ‘Insert’ down the bottom right of the Action Selector. This adds this ‘Show Page’ action to our ‘On Press’ event on our ‘About’ button.
With the ‘Button’ component still selected and the ‘Actions’ panel in the ‘Properties Inspector’ open, we can add the instructions for our ‘Show Page’ action. From the dropdowns, we select the page we want to navigate to, the style of animation and the direction of page movement.
As you can see in the screenshot below, we have completed the instructions for our ‘Show Page’ action. When the user presses the ‘About’ button they will be taken to Page 5, with a ‘Slide’ animation in an ‘Auto’ direction.
When you add an Action to a Component a lightning strike icon is displayed on the name panel in the scene tree. (See screenshot above) Selecting that icon will open the Action panel of the Property Inspector and display all the actions you have added to that component or Page etc.
Now when the user presses the ‘About’ button on our Landing Page they will automatically be taken to the ‘About’ page.
The ‘On Press’ event is the commonest event available on components and pages. In this example we added a simple navigation action but events can have many different and more complex actions added to them. For example, we can add actions to send emails, dial phone numbers, link to websites, play animations, time page views before an action takes place, play sound and use maps. We can set many actions that are driven by data stored in the Dashboard/ Cloud Services.
The 80 different actions are detailed under their category headings below. When selected, every action has a description of its functionality on the right hand side of the screen.
Events that can have Actions attached
Pages have 9 Events
|On Press||On First Load||Before Page Loads||After Page Loads||On Swipe Up||On Swipe Left||On Swipe Down||On Swipe Right||On Back Button|
Foregrounds Have 1 Event - After Foreground Loads
Components each have a variable range and number of Events. The Events are related to the functionality of the component.
Basic Component Events
|3D Model||Animation||Button||HTML Article||Image||Image Zoomer||Nine Slice||Rectangle||Text||Tiler||Toggle Button|
|On Press||On Press||On Press||On URL clicked||On Press||On Press||On Press||On Press||On Press||On Select|
|On Completion||On Completion||On Up||On Complete||On Deselect|
Navigation Component Events
|Carousel||Dropdown Menu||Glass Shelf||Hamburger Menu||Tool Bar|
|On Stop||On Menu Opened||On Stop||On Menu Opened|
|On Change||On Menu Closed||On Change||On Menu Closed|
Data Driven Component Events
|Animated Feed||Dynamic Article||Feed Item View||Feed List||Product List|
|On Press||On Press||On Press||On Press||On Press|
|On Empty||On Change||On Change|
|On Items||On Items|
|On Pull to Refresh|
Forms Component Events
|Dynamic Form||Form||Quiz||Text Entry|
|On Submission||On Press||On Completion||On Focus|
|On Before Submit||On Pass||On Typing|
|On Validation Fail||On Fail||On Tab|
|On Send Success||On Enter|
|On Send Fail||On Before Validation|
|On Page Show||On Fail Validation|
|On Pass Validation|
Layout Component Events
|Gallery||Group||Layout Group||Linear Box||Scroll Panel|
|On Press||On Press||On Press||On Scroll|
|On Change||On Pull to Refresh|
Media Components Events
|Game Gems||RenderKit||Particle||Photo Decal||Video Player|
|On Completion||On Press||OnPress||On Press|
|On Move||On Completion|
|On Down, On Up|
|On A, On B, On C, On D|
Commerce Component Events
|Loyalty Program||Loyalty Program Advanced||Store List|
IOT Component Events
|BLE||Camera Visualize||NFC||Touch Code||Voice Command|
|On Device Connected||On Press||On Recognize[touch_code]|
|On Device Disconnected|
|On Device Discovered|
|On Scan Start|
|On Scan End|
Maps Component Events
|On Press||On Long Press||On Map Move||On Beacon Close||On No Beacon Close||On Route Found||On No Route Found||On Point of Interest Click|
Masters Components have no Events.
Video of Configuring Actions
Please Note: This video was created using Umajin version 188.8.131.52 so there have been some changes to the UI and naming conventions since then. The main changes you will notice are the new action icons and the new categories the actions are sorted into. The process of adding actions, however, remains fundamentally the same.