程序开发之API界面交互

网友投稿 169 2024-07-09

交互

#showToast

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

小程序开发之API界面交互

showToast(Object object)

显示消息提示框。

参数

Object object

属性类型默认值必填说明
titlestring
提示的内容
iconstring'success'图标
imagestring
自定义图标的本地路径,image 的优先级高于 icon
durationnumber1500提示的显示时长
maskbooleanfalse是否显示透明蒙层
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

object.icon 的合法值

说明
success显示成功图标,此时 title 文本最多显示两行
loading显示加载图标,此时 title 文本最多显示两行
error显示失败图标,此时 title 文本最多显示两行
none不显示图标,此时 title 文本最多可显示两行

示例代码

ft.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000})
        已复制代码

注意

  • ft.showLoading 和 ft.showToast 同时只能显示一个

  • ft.showToast 应与 ft.hideToast 配对使用

#showModal

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

showModal(Object object)

显示模态对话框

参数

Object object

属性类型默认值必填说明
titlestring
提示的标题
contentstring
提示的内容
showCancelbooleantrue是否显示取消按钮
cancelTextstring'取消'取消按钮的文字
cancelColorstring浅色主题#191919;深色主题#A5A5A5取消按钮的文字颜色,必须是 16 进制的颜色字符串
confirmTextstring'确定'确认按钮的文字
confirmColorstring浅色主题#409EFF;深色主题#368CE4确认按钮的文字颜色,必须是 16 进制的颜色字符串
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性类型说明
confirmboolean为 true 时,表示用户点击了确定按钮
cancelboolean为 true 时,表示用户点击了取消(用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭)

示例代码

ft.showModal({
  title: '提示',
  content: '这是一个模态弹窗',
  success(res) {
    if (res.confirm) {
      console.log('用户点击确定')
    } else if (res.cancel) {
      console.log('用户点击取消')
    }
  }})
        已复制代码

#showLoading

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

showLoading(Object object)

显示 loading 提示框。需主动调用 ft.hideLoading 才能关闭提示框。

参数

Object object

属性类型默认值必填说明
titlestring
提示的内容
maskbooleanfalse是否显示透明蒙层
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

ft.showLoading({
  title: '加载中',})setTimeout(function () {
  ft.hideLoading()}, 2000)
        已复制代码

注意

  • ft.showLoading 和 ft.showToast 同时只能显示一个

  • ft.showLoading 应与 ft.hideLoading 配对使用

#showActionSheet

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

showActionSheet(Object object)

显示操作菜单

参数

Object object

属性类型默认值必填说明
itemListArray.<string>
按钮的文字数组,数组长度最大为 6
itemColorstring#000000按钮的文字颜色
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性类型说明
tapIndexnumber用户点击的按钮序号,从上到下的顺序,从0开始

示例代码

ft.showActionSheet({
  itemList: ['A', 'B', 'C'],
  success(res) {
    console.log(res.tapIndex)
  },
  fail(res) {
    console.log(res.errMsg)
  }})
        已复制代码

#hideToast

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

hideToast(Object object)

隐藏消息提示框。

参数

Object object

属性类型默认值必填说明
noConflictbooleanfalse目前 toast 和 loading 相关接口可以相互混用,此参数可用于取消混用特性
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

#hideLoading

基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38

hideLoading(Object object)

隐藏 loading 提示框。

参数

Object object

属性类型默认值必填说明
noConflictbooleanfalse目前 toast 和 loading 相关接口可以相互混用,此参数可用于取消混用特性
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

#enableAlertBeforeUnload

基础库2.11.5开始支持,iOS版本2.35.1,Android版本2.35.1

enableAlertBeforeUnload(Object object)

开启小程序页面返回询问对话框

参数

Object object

属性类型默认值必填说明
messagestring
接口调用成功的回调函数
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)

#disableAlertBeforeUnload

基础库2.11.5开始支持,iOS版本2.35.1,Android版本2.35.1

disableAlertBeforeUnload(Object object)

关闭小程序页面返回询问对话框

参数

Object object

属性类型默认值必填说明
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)


版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:小程序开发之API转发说明
下一篇:小程序开发之API界面导航栏参数说明
相关文章

 发表评论

暂时没有评论,来抢沙发吧~