Toast是应用中常用的微妙(subtle )通知。它用于提示有关操作的反馈或显示系统消息。Toast显示在app内容的顶部(覆盖内容),app可以将其关闭,以恢复用户与app的交互。
1.创建
toast的所有选项都应该在create方法的第一个参数中传递:create(opts)。message选项设置要显示的消息。showCloseButton选项设置为true,在Toast上将显示一个关闭按钮。有关所有可用选项,请参阅下面的create方法。
2.显示的位置
Toast可以显示在视口的顶部,中间,或底部。position选项可以传递给Toast.create(opts)方法。position选项的值是一个字符串,可选值有top,middle和bottom。如果未指定position的值,则默认在视口的底部显示Toast。
3.关闭(三种关闭)
①Toast可以通过传递毫秒数给Toast的duration选项,在特定时间后自动关闭。②如果showCloseButton选项设置为true,则关闭按钮也可关闭Toast。③也可以调用 Toast实例上的dismiss()方法来关闭Toast。
当Toast被关闭之后,将会触发onDidDismiss函数。
4.用法
import { ToastController } from 'ionic-angular';
constructor(private toastCtrl: ToastController) {
}
presentToast() {
let toast = this.toastCtrl.create({
message: 'User was added successfully',
duration: 3000,
position: 'top'
});
toast.onDidDismiss(() => {
console.log('Dismissed toast');
});
toast.present();
}
实例成员
config
create(opts)
创建一个Toast。见下面的选项
参数 | 类型 | 细节 |
---|---|---|
opts | ToastOptions | Toast选项。请参阅下表以了解可用选项。 |
高级
属性 | 类型 | 默认 | 描述 |
---|---|---|---|
message | string | - | Toast显示的信息 |
duration(持续时间) | number | - | 多少毫秒后关闭Toast。默认情况下,它会一直显示直到dismiss() 被调用。 |
position | string | "bottom" | Toast在屏幕上的位置。值可为:"top","middle"或"bottom"。 |
cssClass | string | - | 自定义的样式,以空格分隔。 |
showCloseButton | boolean | false | 是否显示一个按钮来关闭Toast。 |
closeButtonText | string | "Close" | 关闭按钮中显示的文本。 |
dismissOnPageChange | boolean | false | 是否导航到新页面后关闭Toast。 |