交互反馈

my.alert

alert 警告框。扫码体验:

img.jpg

入参

名称类型必填描述
titleStringalert框的标题
contentStringalert框的内容
buttonTextString按钮文字,默认确定
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

代码示例

  1. my.alert({
  2. title: '亲',
  3. content: '您本月的账单已出',
  4. buttonText: '我知道了',
  5. success: () => {
  6. my.alert({
  7. title: '用户点击了「我知道了」',
  8. });
  9. },
  10. });

my.confirm

confirm 确认框。扫码体验:

img.jpg

入参

名称类型必填描述
titleStringconfirm框的标题
contentStringconfirm框的内容
confirmButtonTextString确认按钮文字,默认‘确定’
cancelButtonTextString确认按钮文字,默认‘取消’
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称类型描述
confirmBoolean点击 confirm 返回 true,点击 cancel 返回false

代码示例

  1. my.confirm({
  2. title: '温馨提示',
  3. content: '您是否想查询快递单号:
  4. 1234567890',
  5. confirmButtonText: '马上查询',
  6. cancelButtonText: '暂不需要',
  7. success: (result) => {
  8. my.alert({
  9. title: `${result.confirm}`,
  10. });
  11. },
  12. });

my.prompt

基础库1.7.2,支付宝10.1.10开始支持

入参


名称

类型

必填

描述

title

String



prompt框标题

message

String



prompt框文本,默认‘请输入内容’

placeholder

String



输入框内的提示文案

align

String



message对齐方式,可用枚举left/center/right,iOS ‘center’, android ‘left’

okButtonText

String



确认按钮文字,默认‘确定’

cancelButtonText

String



确认按钮文字,默认‘取消’

success

Function



调用成功的回调函数

fail

Function



调用失败的回调函数

complete

Function



调用结束的回调函数(调用成功、失败都会执行)

success 返回值

名称类型描述
o​kB​oolean点击 ok 返回 true,点击 cancel 返回false
inputValueString当ok为true时,返回用户输入的内容

代码示例

  1. my.prompt({
  2. title: '标题单行',
  3. message: '说明当前状态、提示用户解决方案,最好不要超过两行。',
  4. placeholder: '给朋友留言',
  5. okButtonText: '确定',
  6. cancelButtonText: '取消',
  7. success: (result) => {
  8. my.alert({
  9. title: JSON.stringify(result),
  10. });
  11. },
  12. });

my.showToast

显示一个弱提示,可选择多少秒之后消失。扫码体验:

img.jpg

入参

名称类型必填描述
contentString文字内容
typeStringtoast 类型,展示相应图标,默认 none,支持 success / fail / exception / none’。其中 exception 类型必须传文字信息
durationNumber显示时长,单位为 ms,默认 2000
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

代码示例

  1. my.showToast({
  2. type: 'success',
  3. content: '操作成功',
  4. duration: 3000,
  5. success: () => {
  6. my.alert({
  7. title: 'toast 消失了',
  8. });
  9. },
  10. });

my.hideToast

隐藏弱提示。

代码示例

  1. my.hideToast()

my.showLoading

显示加载提示。扫码体验:

image.png

入参

名称类型必填描述
contentStringloading的文字内容
delayNumber延迟显示,单位 ms,默认 0。如果在此时间之前调用了 my.hideLoading 则不会显示
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

代码示例

  1. my.showLoading({
  2. content: '加载中...',
  3. delay: 1000,
  4. });

my.hideLoading

隐藏加载提示。

入参

名称类型必填描述
pageObject具体指当前page实例,某些场景下,需要指明在哪个page执行hideLoading。

代码示例

  1. my.hideLoading();
  2. Page({
  3. onLoad() {
  4. my.showLoading();
  5. const that = this;
  6. setTimeout(() => {
  7. my.hideLoading({
  8. page: that, // 防止执行时已经切换到其它页面,page指向不准确
  9. });
  10. }, 4000);
  11. }
  12. })

my.showNavigationBarLoading

显示导航栏 loading。扫码体验:

img.jpg

代码示例

  1. my.showNavigationBarLoading()
  • 如果页面的标题文本长度设置的过长,将有可能导致 loading 图标不显示。

my.hideNavigationBarLoading

隐藏导航栏 loading。

代码示例

  1. my.hideNavigationBarLoading()

my.showActionSheet

显示操作菜单。扫码体验:

img.jpg

入参

名称类型必填描述
titleString菜单标题
itemsString Array菜单按钮文字数组
cancelButtonTextString取消按钮文案。默认为‘取消’。注:Android平台此字段无效,不会显示取消按钮。
destructiveBtnIndexNumber(iOS特殊处理)指定按钮的索引号,从0开始,使用场景:需要删除或清除数据等类似场景,默认红色
badgesObject Array需飘红选项的数组,数组内部对象字段见下表1.9.0
successFunction调用成功的回调函数
failFunction调用失败的回调函数
completeFunction调用结束的回调函数(调用成功、失败都会执行)

badges数组内部对象字段


名称

类型

描述

index

Number

需要飘红的选项的索引,从0开始

type

String

飘红类型,支持 none(无红点)/ point(纯红点) / num(数字红点)/ text(文案红点)/ more(…)

text

String

自定义飘红文案:

1、type为none/point/more时本文案可不填

2、type为num时本文案为小数或<=0均不显示, >100 显示"…"

代码示例

  1. my.showActionSheet({
  2. title: '支付宝-ActionSheet',
  3. items: ['菜单一', '菜单二', '菜单三', '菜单四', '菜单五'],
  4. badges: [
  5. { index: 0, type: 'none' },
  6. { index: 1, type: 'point' },
  7. { index: 2, type: 'num', text: '99' },
  8. { index: 3, type: 'text', text: '推荐' },
  9. { index: 4, type: 'more' },],
  10. cancelButtonText: '取消好了',
  11. success: (res) => {
  12. const btn = res.index === -1 ? '取消' : '第' + res.index + '个';
  13. my.alert({
  14. title: `你点了${btn}按钮`
  15. });
  16. },
  17. });

原文: https://docs.alipay.com/mini/api/ui-feedback