The Toast or Snackbar component is useful for displaying dismissable information or simple actions at (normally) the bottom of the page.
This component does not block user input, allowing the app to continue its flow. For simple toasts, consider ons.notification.toast
instead.
There are three components used to show dialogs: Dialog
, AlertDialog
and Toast
. The Dialog
component is a general dialog where you can put any content. AlertDialog
has some default styles that make it easy to show errors, warnings or questions to the user.
And Toast
is a message (with optional button) that does not stop the app flow.
To show or hide the dialog the isOpen
prop is used.
<Dialog isOpen={this.state.dialogShown}>
Hi!
<Button onClick={this.hideDialog.bind(this)}>
Close
</Button>
</Dialog>
The ons.notification
object contains some useful methods to easily show alerts, confirmation dialogs and prompts:
ons.notification.alert(message, options)
ons.notificaiton.confirm(message, options)
ons.notification.prompt(message, options)
ons.notification.toast(message, options)
They all return a Promise
object that can be used to handle the input from the user.
ons.notification.confirm('Are you ready?')
.then((response) => {
// Handle response.
});
Name | Type | Description |
---|---|---|
animation |
String
default |
The animation used when showing and hiding the toast. Can be either "default" , "ascend" (Android), "lift" (iOS), "fall" , "fade" or "none" .
Optional.
|
animation-options | Expression |
Specify the animation’s duration, timing and delay with an object literal. E.g. {duration: 0.2, delay: 1, timing: 'ease-in'} .
Optional.
|
visible | Boolean | Whether the toast is visible or not. Optional. |
Name | Description |
---|---|
animationOptions |
Specify the animation’s duration, timing and delay with an object literal. E.g. {duration: 0.2, delay: 1, timing: 'ease-in'} .
|
onDeviceBackButton | Back-button handler. |
visible | Whether the element is visible or not. |
Signature | Description |
---|---|
show([options]) | Show the element. |
toggle([options]) | Toggle toast visibility. |
hide([options]) | Hide toast. |
Show the element.
Returns: Resolves to the displayed element
Name | Type | Description |
---|---|---|
options | Object | Parameter object. |
options.animation | String |
Animation name. Available animations are "default" , "ascend" (Android), "lift" (iOS), "fall" , "fade" or "none" .
|
options.animationOptions | String |
Specify the animation’s duration, delay and timing. E.g. {duration: 0.2, delay: 0.4, timing: 'ease-in'} .
|
Toggle toast visibility.
Name | Type | Description |
---|---|---|
options | Object | Parameter object. |
options.animation | String |
Animation name. Available animations are "default" , "ascend" (Android), "lift" (iOS), "fall" , "fade" or "none" .
|
options.animationOptions | String |
Specify the animation’s duration, delay and timing. E.g. {duration: 0.2, delay: 0.4, timing: 'ease-in'} .
|
Hide toast.
Returns: Resolves to the hidden element
Name | Type | Description |
---|---|---|
options | Object | Parameter object. |
options.animation | String |
Animation name. Available animations are "default" , "ascend" (Android), "lift" (iOS), "fall" , "fade" or "none" .
|
options.animationOptions | String |
Specify the animation’s duration, delay and timing. E.g. {duration: 0.2, delay: 0.4, timing: 'ease-in'} .
|
Name | Description |
---|---|
preshow | Fired just before the toast is displayed. |
postshow | Fired just after the toast is displayed. |
prehide | Fired just before the toast is hidden. |
posthide | Fired just after the toast is hidden. |
Fired just before the toast is displayed.
Name | Type | Description |
---|---|---|
event | Object | Event object. |
event.toast | Object | Toast object. |
event.cancel | Function | Execute to stop the toast from showing. |
Fired just after the toast is displayed.
Name | Type | Description |
---|---|---|
event | Object | Event object. |
event.toast | Object | Toast object. |
Fired just before the toast is hidden.
Name | Type | Description |
---|---|---|
event | Object | Event object. |
event.toast | Object | Toast object. |
event.cancel | Function | Execute to stop the toast from hiding. |
Fired just after the toast is hidden.
Name | Type | Description |
---|---|---|
event | Object | Event object. |
event.toast | Object | Toast object. |
If you have any questions, use our Community Forum or talk to us on Discord chat. The Onsen UI team and your peers in the community will work together to help solve your issues.
For bug reports and feature requests use our GitHub Issues page.