• swan.showToast
  • 方法參數(shù)
    • object 參數(shù)說明
    • icon 有效值
  • 示例
    • 代碼示例 1：默認(rèn)樣式
    • 代碼示例 2：無圖標(biāo) toast
    • 代碼示例 3：顯示 loading 圖標(biāo)
    • 代碼示例 4：延遲 5000 毫秒的 toast
    • 代碼示例 5：隱藏 toast
    • 代碼示例 6：showModal 和 showToast 是否可共存
  • Bug & Tip
  • 錯誤碼
    • Android
    • iOS

swan.showToast

解釋：顯示消息提示框，用以提供成功、警告和錯誤等反饋信息。設(shè)計(jì)文檔詳見消息提示框。

創(chuàng)新互聯(lián)公司專注為客戶提供全方位的互聯(lián)網(wǎng)綜合服務(wù)，包含不限于成都做網(wǎng)站、網(wǎng)站制作、成都外貿(mào)網(wǎng)站建設(shè)、陽明網(wǎng)絡(luò)推廣、小程序制作、陽明網(wǎng)絡(luò)營銷、陽明企業(yè)策劃、陽明品牌公關(guān)、搜索引擎seo、人物專訪、企業(yè)宣傳片、企業(yè)代運(yùn)營等，從售前售中售后，我們都將竭誠為您服務(wù)，您的肯定，是我們最大的嘉獎；創(chuàng)新互聯(lián)公司為所有大學(xué)生創(chuàng)業(yè)者提供陽明建站搭建服務(wù)，24小時服務(wù)熱線：18980820575，官方網(wǎng)址：www.cdcxhl.com

方法參數(shù)

Object object

object 參數(shù)說明

title

String

是

提示的內(nèi)容

icon

String

否

success

圖標(biāo)，有效值“success”、”loading”、”none”

image

String

否

自定義圖標(biāo)的本地路徑，image 的優(yōu)先級高于 icon

duration

Number

否

2000

提示的延遲時間（單位：毫秒）

success

Function

否

接口調(diào)用成功的回調(diào)函數(shù)

fail

Function

否

接口調(diào)用失敗的回調(diào)函數(shù)

complete

Function

否

接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行）

mask

Boolean

否

false

是否顯示透明蒙層，防止觸摸穿透

屬性名	類型	必填	默認(rèn)值	說明

icon 有效值

有效值	說明
success	顯示成功圖標(biāo)，此時 title 文本最多顯示 7 個漢字長度。默認(rèn)值
loading	顯示加載圖標(biāo)，此時 title 文本最多顯示 7 個漢字長度
none	不顯示圖標(biāo)，此時 title 文本最多可顯示兩行

示例

跳轉(zhuǎn)編輯工具

在開發(fā)者工具中打開

在 WEB IDE 中打開

掃碼體驗(yàn)

代碼示例

請使用百度APP掃碼

代碼示例 1：默認(rèn)樣式

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 默認(rèn)樣式
  
  
  
 默認(rèn)toast
  
  
  
 
 

設(shè)計(jì)指南

默認(rèn)消息提示框自帶“Success”圖標(biāo)，建議在正向提示場景應(yīng)用，如“XX 成功”，“XX 完成”，并對反饋內(nèi)容精簡表達(dá)。

錯誤

圖標(biāo)與反饋的內(nèi)容不符合。

錯誤

反饋內(nèi)容過長會顯示不全。

代碼示例 2：無圖標(biāo) toast

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 
  
  
  
 設(shè)置不顯示圖標(biāo)
  
  
  
 icon: 'none'
  
  
  
 
  
  
  
 無圖標(biāo)toast
  
  
  
 
 

設(shè)計(jì)指南

無圖標(biāo)的消息提示框最多可顯示雙行 28 個字，需措辭精簡，并根據(jù)反饋內(nèi)容設(shè)置合理的折行位置。

正確

在“同步成功”處設(shè)置折行，閱讀體驗(yàn)更佳。

錯誤

行業(yè)術(shù)語、技術(shù)代碼均無法交代清楚原因，應(yīng)轉(zhuǎn)化為用戶語言。

錯誤

表述模糊冗余，且過長文案顯示不完整。

代碼示例 3：顯示 loading 圖標(biāo)

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 
  
  
  
 設(shè)置顯示loading圖標(biāo)
  
  
  
 icon: 'loading'
  
  
  
 
  
  
  
 loading toast
  
  
  
 
 

代碼示例 4：延遲 5000 毫秒的 toast

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 
  
  
  
 設(shè)置延遲時間
  
  
  
 duration: 5000
  
  
  
 
  
  
  
 延遲5000毫秒的toast
  
  
  
 
 

代碼示例 5：隱藏 toast

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 隱藏toast
  
  
  
 隱藏toast
  
  
  
 
 

代碼示例 6：showModal 和 showToast 是否可共存

在開發(fā)者工具中打開

在開發(fā)者工具中打開

在 WEB IDE 中打開

• SWAN
• JS

 
 
 
  
  
  
  
  
  
 
  
  
  
 showModal和showToast可共存
  
  
  
 點(diǎn)擊彈出toast
  
  
  
 點(diǎn)擊彈出modal
  
  
  
 
  
  
  
 
 

Bug & Tip

• Tip：swan.showLoading 和 swan.showToast 同時只能顯示一個。
• Tip：swan.showToast 應(yīng)與 swan.hideToast 配對使用。

錯誤碼

Android

202

解析失敗，請檢查參數(shù)是否正確

302

找不到調(diào)起協(xié)議對應(yīng)端能力方法

錯誤碼	說明

iOS

202

解析失敗，請檢查參數(shù)是否正確

錯誤碼	說明

當(dāng)前題目：創(chuàng)新互聯(lián)百度小程序教程：swan.showToast
網(wǎng)頁鏈接：http://www.dlmjj.cn/article/dpggpij.html