此接口用于顯示一個弱提示,可選擇多少秒之后消失。
toast 接口的使用方法
AlipayJSBridge.call('toast', {
content: '操作成功',
type: 'success',
duration: 2000
}, function() {
alert("toast消失后執行");
});
// 可以通過 hideToast 接口隱藏已經彈出的 toast
AlipayJSBridge.call('hideToast', {}, function() {
});
代碼示例
<h1>點擊以下按鈕看不同效果</h1>
<a href="javascript:void(0)" class="btn success">顯示成功信息</a>
<a href="javascript:void(0)" class="btn fail">顯示失敗信息</a>
<a href="javascript:void(0)" class="btn exception">顯示異常信息</a>
<a href="javascript:void(0)" class="btn none">只顯示信息</a>
<a href="javascript:void(0)" class="btn duration">3.5s信息顯示</a>
<script>
function toast(config, callback){
AlipayJSBridge.call('toast',config, callback);
}
function ready(callback) {
// 如果 jsbridge 已經注入則直接調用
if (window.AlipayJSBridge) {
callback && callback();
} else {
// 如果沒有注入則監聽注入的事件
document.addEventListener('AlipayJSBridgeReady', callback, false);
}
}
ready(function() {
document.querySelector('.success').addEventListener('click', function() {
toast({
content: '操作成功',
type: 'success'
});
});
document.querySelector('.fail').addEventListener('click', function() {
toast({
content: '網絡繁忙,請稍后再試',
type: 'fail'
});
});
document.querySelector('.exception').addEventListener('click', function() {
toast({
content: '發生異常,請注意',
type: 'exception'
});
});
document.querySelector('.none').addEventListener('click', function() {
toast({
content: '歡迎光臨',
});
});
document.querySelector('.duration').addEventListener('click', function() {
toast({
content: '請稍等',
duration: 3500,
}, function(e){
alert('toast消失回調');
});
});
});
</script>
API 說明
重要
toast 雖然會自動關閉,但是也可以通過 hideLoading 來關閉,這種使用方式不常見,但是要防止被 hideLoading 關閉。
對于 Android 系統,如果系統通知關閉,則此彈框不會出現。
在 Android 10.1.2 以下版本中,duration 顯示時長只支持 2000/3500 兩種,小于或等于 2000 的選擇 2000,大于 2000 的選擇 3500。
AlipayJSBridge.call('toast', {
content, type, duration
}, fn)
入參
屬性 | 類型 | 描述 | 必填 | 默認值 |
content | string | 文字內容。 | Y | “” |
type | string | 參數值可以是 none、success、fail、exception。 當為 excption 類型時,必須傳遞文案。 | N | “none” |
duration | int | 顯示時長,單位為毫秒。 | N | 2000 |
xOffset | float | 左為正方向,單位為 px。 | N | 0 |
yOffset | float | 上為正方向,單位為 px。 | N | 0 |
fn | function | 回調函數,當 toast 消失后被調用。 | N | - |
文檔內容是否對您有幫助?