ToastMessage¶
Toast messages appear as pop-ups that are automatically dismissed after a defined duration. In Mobile Development Kit, you can create toast messages and define their behavior.
Note: Failure event handlers cannot be defined for toast messages. On the other hand, you must use success event handlers while binding other actions to a toast message. Once the toast message appears, subsequent actions are executed immediately.
All the properties defined under Action are applicable to this action.
ToastMessage Properties¶
| Property | Type | Required | Default |
|---|---|---|---|
| Duration | integer |
No | 2 |
| Icon | Image | No | |
| IsIconHidden | boolean |
No | false |
| Message | string |
Yes | |
| NumberOfLines | integer |
No | 1 |
| Style | string |
No | |
| _Type | const |
Yes |
Duration¶
Indicates the number of seconds the toast message has to be displayed.
-
type:
integer -
default:
2
Icon¶
This parameter allows the users to define the path to the image file that has to be displayed as icon in the message. Default image is a check-mark. This parameter is not applicable for Android.
- type: Image
IsIconHidden¶
If set to True, the icon is hidden. This parameter is not applicable for Android.
-
type:
boolean -
default:
false
Message¶
Text that conveys the message.
- type:
string
NumberOfLines¶
Number of lines to displayed from the text defined in the Message.
-
type:
integer -
default:
1
Style¶
A string value that defines the style class name of Icon. Style is applicable for SAP icon/font icon types (CSS properties like font-size and color are supported).
- type:
string
_Type¶
- type:
const
The value of this property must be:
"Action.Type.ToastMessage"
Action Result¶
This action has no ActionResult.
Examples¶
// ToastMessage.action
{
"Message": "This is a toast message test",
"Icon": "test.png",
"IsIconHidden": false,
"NumberOfLines": 2,
"Duration": 3,
"_Type": "Action.Type.ToastMessage"
}
// ToastMessage.action with font icon and style example
{
"Message": "This is a toast message test with font icon styling",
"Icon": "test.png",
"IsIconHidden": false,
"NumberOfLines": 2,
"Duration": 3,
"Style": "font-icon-class",
"_Type": "Action.Type.ToastMessage"
}
Style Classes Definition¶
.font-icon-class {
font-size: 4;
color: red;
}