开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
导航栏
tabbar
路由
交互反馈
下拉刷新
联系人
选择城市
选择日期
动画
画布
地图
计算路径
键盘
滚动
节点查询
选项选择器
级联选择
设置窗口背景
设置页面是否支持下拉
字体
跳转
多媒体
缓存
文件
位置
网络
设备
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 界面 > 交互反馈 > my.showappmodal
收藏
订阅更新
我的文档
设置

my.showappmodal(object object)

基础库  或更高版本; 若版本较低,建议采取 兼容处理

支小宝客户端 支持

安诊儿客户端 支持

小程序开发者工具: 不支持。

插件: 支持。

主体: 企业支付宝小程序个人支付宝小程序

小程序官方弹窗组件,可实现在小程序页面上悬浮展示弹窗,弹窗类型目前暂只开放“图文、纯图片、纯文本”三种形式。
注意:为保障用户体验,弹窗展示默认有疲劳度管控,每种弹窗类型每日只可对一个用户曝光一次。
效果示例如图:

object object

查看示例

属性 类型 默认值 必填 描述
id string -

业务自定义 id,长度限制最多为 10 位

type string -

弹窗类型

属性 类型 描述
image string

纯图片类型

text string

纯文本类型

image_text string

图文类型

src string true

当弹窗类型为 image 或 image_text 时,为必填。仅支持传入网络图片链接地址

mode string scaletofill

图片模式,枚举值同 image 组件 mode 属性一致

title string -

标题,最多可输入12个汉字,类型为图文、纯文本时,必填

content string -

内容,类型为图文、纯文本时,必填。
当类型为 text 时最多可输入500个汉字;
当类型为 image_text 时最多可输入20个汉字,注意:如果超过2行会截断

confirmbuttontext string 确定

主操作按钮文案
当类型为 text 时最多可输入 8 个汉字,超过截取
当类型为 image_text 时最多可输入12个汉字,超过截取。

url boolean -

跳转的小程序页面地址(主操作按钮、图片点击时)

  • 图文、纯文本类型弹窗,不传该参数,点击(主操作按钮、图片点击时)关闭弹窗
  • 图片类型,不传该参数,点击(主操作按钮、图片点击时)点击无动作
    • url 可携带参数,如/pages/sub/sub?key=value。可参阅 url 详解。注意:目标页面不能为 tabbar 页面,否则会导致 tabbar 不展示。

success 回调函数

参数

object res

查看示例

属性 类型 描述
success boolean

当弹窗关闭,接口返回success为true

fail 回调的参数为 object,error 属性为错误码,errormessage 属性为错误消息。

错误码 错误消息 凯发app官方网站的解决方案
60001 请确认入参是否正确

请确认入参是否正确

60002 风控校验失败

请不要上传带有敏感内容的图片/文字

60003 疲劳度校验失败

超出单日曝光上限;疲劳度为 1日/1次,用户今天曝光过后,该类型弹窗组件今日不再展示,次日再次访问可展示。

60004 无权限调用

请申请调用权限

60005 超出调用次数上限

在小程序的生命周期下,每个页面,每个弹窗类型,限制只能展示一次。

纯图弹窗组件
纯文本弹窗组件
图文弹窗组件
my.showappmodal({
  id: '11xxxxx', // 实际开发中请使用业务自定义的 id 
  type: 'image',
  src: 'https://img.alicdn.com/imgextra/i4/3751-0-tps-457-1002.jpg'// 实际开发中请使用目标图片
  url: '/pages/demo/demo',// 图片弹窗模式下,若不传该参数,点击图片则无动作。
  success: (res) => {
    console.log(res);
  },
  fail: (err) => {
    console.log(err);
  },
});

type 值为 image

纯图片类型

my.showappmodal({
  id: '11xxxxx', // 实际开发中请使用业务自定义的 id 
  type: 'text',
  title: '纯文本弹窗标题',
  content: '内容区域的文字描述,不支持富文本',
  confirmbuttontext: '主操作',
  url: '/pages/demo/demo',// 纯文本弹窗模式下,若不传该参数,点击会关闭弹窗
  success: (res) => {
    console.log(res);
  },
  fail: (err) => {
    console.log(err);
  },
});

type 值为 text

纯文本类型

my.showappmodal({
  id: '11xxxxx', // 实际开发中请使用业务自定义的 id 
  type: 'image_text',
  src: 'https://img.alicdn.com/imgextra/i4/3751-0-tps-457-1002.jpg'// 实际开发中请使用目标图片
  title: '纯文本弹窗标题',
  content: '内容区域的文字描述,不支持富文本',
  confirmbuttontext: '按钮文案',
  url: '/pages/demo/demo',// 图文弹窗模式下,若不传该参数,点击图片则关闭弹窗。
  success: (res) => {
    console.log(res);
  },
  fail: (err) => {
    console.log(err);
  },
});

type 值为 image_text

图文类型

内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图