Actions

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.

Having selected the ‘Button’ component, in the ‘Properties Inspector’, we open the ‘Actions’ tab.

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
On Down

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 Tick
On Resize
On Pinch
On Down, On Up
On A, On B, On C, On D

Commerce Component Events

Loyalty Program Loyalty Program Advanced Store List
On Press

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 Enable
On Disabled
On Scan Start
On Scan End

Maps Component Events

Offline Map              
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 1.4.0.0 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.