全部產品
Search
文件中心

Mobile Platform as a Service:弱提示

更新時間:Jul 23, 2024

此介面用於顯示一個弱提示,可選擇多少秒之後消失。

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

-