Alert
Alerts are useful components for displaying important messages while users are in the app itself
To add an Alert component to your app:
Go to your Blocks tab
Click the ⊕ icon next to the
Alertsdrawer
You will see a dialog with options to enter certain properties for your Alert component. Click Submit to create the Alert component, or Delete to dismiss the dialog without creating the component.
Once you have added at least one Web API component to your app, you will be able to view all of your Alert components under the Alerts drawer on the Blocks tab.
To edit the properties of an Alert component, click on the ⚙ icon next to the component's name to bring up the properties dialog. You will be able to change the properties and click Submit to save your changes, or click Delete to delete the component.
A one button alert, also known as a notification, displays a message and one button to confirm user has viewed the message
.png?alt=media&token=8a1577b2-7204-4f3d-be65-5137d369d073)
To set up an alert, simply fill in the following simple properties. The Cancel Button Text only needs to be filled out for a two-button alert. You can use blocks to start an event when
Property | Description |
Title | The title of the alert |
Message | The subtitle of the alert |
Confirm Button Text | The text of the button |
Cancel Button Text |
|
Two button alerts have two buttons, one that dismisses the notification and one that can be programmed to start an event
To set one up, simply add the following simple properties
.png?alt=media&token=c6fc4a62-e587-4a2b-a554-e836a5280cb9)
Property | Description |
Title | The title of the alert |
Message | The subtitle of the alert |
Confirm Button Text | The text of the right confirm button; If the |
Cancel Button Text | The text of the left cancel button |
If you want to start an event from a confirm button, you will want to add the blocks below:
It is possible to add buttons to an alert for more sophisticated use cases.
This can be done using the set Button List to block by creating a list of objects.
You can set the Text of the Alert. You can set the Style of the Alert to ok, destructive or cancel.
On iOS, the Alert can show more than 3 Buttons. On Android, the Alert can show up to 3 buttons. If more than 3 buttons are specified, the first 3 will be shown.
.png?alt=media&token=321a2c11-4fd3-4557-bde5-d6199eb40755)
Property | Description |
Title | The title of the alert |
Message | The subtitle of the alert |
Text | The text of the button |
Style | The style of the button; |
The 'showButtonList' block will return an output called 'buttonPressed'. This will return the position of the Button in your Button List. You can take some action based on which button was pressed.
Note: the Buttons may appear in a different order when testing the app on a device. The number that ‘buttonPressed’ returns is the order that the Buttons are added in the app project.
