uni-app中的API

生命周期:

应用生命周期:

应用生命周期仅可在App.vue中监听,在其他页面监听无效。

  1. onLaunch:当uni-app 初始化完成时触发(全局只触发一次)。
  2. onShow:当 uni-app 启动,或从后台进入前台显示。
  3. onHide:当 uni-app 从前台进入后台。
页面生命周期:
  1. onLoad:监听页面加载,其参数为上个页面传递的数据,参数类型为Object(用于页面传参)。

  2. onShow:监听页面显示。页面每次出现在屏幕上都触发,包括从下级页面点返回露出当前页面。

  3. onHide:监听页面隐藏。

  4. onReady:监听页面初次渲染完成。

  5. onPageScroll:监听页面滚动,参数为Object。

  6. onPullDownRefresh:监听用户下拉动作,一般用于下拉刷新。

  7. onReachBottom:页面滚动到底部的事件,常用于上拉加载下一页数据。

    如使用scroll-view导致页面级没有滚动,则触底事件不会被触发。

  8. onTabItemTap:点击 tab 时触发,参数为Object。

路由与页面跳转:

  1. uni.navigateTo(OBJECT):保留当前页面,跳转到应用内的某个页面。使用uni.navigateBack()可以返回到原页面。

    OBJECT参数:

    1. url:必填,需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 ‘path?key=value&key2=value2’,path为下一个页面的路径,下一个页面的onLoad函数可得到传递的参数。
      url长度有限制,太长的字符串会传递失败。
    2. success:可选,接口调用成功的回调函数。
    3. fail:可选,接口调用失败的回调函数。
    4. complete: 可选,接口调用结束的回调函数(调用成功、失败都会执行)。

    页面跳转路径有层级限制,不能无限制跳转新页面。
    跳转到tabBar页面只能使用switchTab跳转。

  2. uni.redirectTo(OBJECT):关闭当前页面,跳转到应用内的某个页面。

  3. uni.reLaunch(OBJECT):关闭所有页面,打开应用内的某个页面。

  4. uni.switchTab(OBJECT):跳转到tabBar页面,并关闭其他所有非tabBar页面。

  5. uni.navigateBack(OBJECT):关闭当前页面,返回上一页面或多级页面。

    可通过getCurrentPages()获取当前的页面栈,决定需要返回几层。

    OBJECT参数:

    1. delta:可选,返回的页面数,默认值为1。如果delta大于现有页面数,则返回到首页。

提示框:

消息提示框:
  1. uni.showToast(OBJECT):显示消息提示框。

OBJECT参数:

  1. title:必选,提示的内容。
  2. icon:可选,图标,默认为success。属性值有:success显示成功图标,此时title文本最多显示7个汉字;loading显示加载图标,此时title文本最多显示7个汉字;none不显示图标,此时title文本在小程序最多可显示两行,在App仅显示一行。
  3. image:可选,自定义图片的本地路径。
  4. mask:可选,是否显示透明蒙层,防止触摸穿透,默认值为false。
  5. duration:可选,提示的延迟时间,默认1500毫秒。
  6. success:可选,接口调用成功的回调函数。
  7. fail:可选,接口调用失败的回调函数。
  8. complete: 可选,接口调用结束的回调函数(调用成功、失败都会执行)。
  1. uni.hideToast(OBJECT):隐藏消息提示框。
loading提示框:
  1. uni.showLoading(OBJECT):显示loading提示框,需主动调用uni.hideLoading()才能关闭提示框。
  2. uni.hideLoading(OBJECT):隐藏loading提示框。
模态弹框:
  1. uni.showModal(OBJECT):显示模态弹框。

OBJECT参数:

  1. title:可选,提示的标题。
  2. content:可选,提示的内容。
  3. showCancel:可选,是否显示取消按钮,默认为 true。
  4. cancelText:可选,取消按钮的文字,默认为"取消",最多 4 个字符。
  5. cancelColor:可选,取消按钮的文字颜色,默认为"#000000"。
  6. confirmText:可选,确定按钮的文字,默认为"确定",最多 4 个字符。
  7. confirmColor:确定按钮的文字颜色,H5平台默认为"#007aff",微信小程序平台默认为"#3CC51F"。
  8. success:可选,接口调用成功的回调函数。
  9. fail:接口调用失败的回调函数。
  10. complete:接口调用结束的回调函数(调用成功、失败都会执行)。

猜你喜欢

转载自blog.csdn.net/wsln_123456/article/details/109077830