您的位置:58编程 > 微信小程序API导航组件 微信小程序API 导航

微信小程序API导航组件 微信小程序API 导航

2023-03-23 07:33

微信小程序API导航组件 微信小程序API 导航

微信小程序API导航组件

微信小程序API导航组件是一种可以帮助开发者快速实现页面导航的工具,它可以让开发者在小程序中快速构建出复杂的页面导航。

微信小程序API导航组件的使用方法很简单,开发者只需要在小程序中添加一个navigator标签,并且设定好相关属性即可。例如:

<navigator url="{{url}}">跳转到新页面</navigator>

上述代码中,url属性表明了当用户点击该标签时将要跳转到的新页面地址。此外,还有一些其他的属性也可以用来控制导航行为,例如open-type、hover-class、hover-stop-propagation、hover-start-time、hover-stay-time 等。

此外,微信小程序API导航组件还支持使用JavaScript代码来实现功能。例如:

wx.navigateTo({url: 'test?id=1'});

上述代码表明了当用户执行该操作时将会跳转到test?id=1这个新页面。此外,wx.redirectTo()、wx.switchTab()、wx.reLaunch()也是常用的JavaScript API之一。

总之,微信小程序API导航组件支持使用HTML标记语言和JavaScript代码来实现复杂的页面导航功能,使开发者能够快速而有效地实施各个功能。因此,微信小程序API导航是一个不可或缺的重要工具。

微信小程序API 导航

为了满足大家查询需要,我们收集并整理了一份 : 微信小程序导航大全 你可以很方便的通过扫二维码去使用这些小程序。

wx.navigateTo(OBJECT)

保留当前页面,跳转到应用内的某个页面,使用wx.navigateBack可以返回到原页面。

OBJECT 参数说明:

参数 类型 必填 说明
url String 需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 "path?key=value&key2=value2"
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

wx.navigateTo({
  url: "test?id=1"
})
//test.js
Page({
  onLoad: function(option){
    console.log(option.query)
  }
})

注意:为了不让用户在使用小程序时造成困扰,我们规定页面路径只能是五层,请尽量避免多层级的交互方式。


wx.redirectTo(OBJECT)

关闭当前页面,跳转到应用内的某个页面。

OBJECT 参数说明:

参数 类型 必填 说明
url String 需要跳转的应用内非 tabBar 的页面的路径,路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 "path?key=value&key2=value2"
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

wx.redirectTo({
  url: "test?id=1"
})

wx.reLaunch(OBJECT)

基础库版本 1.1.0 开始支持,低版本需做兼容处理

关闭所有页面,打开到应用内的某个页面。

OBJECT 参数说明:

参数 类型 必填 说明
url String 需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 "path?key=value&key2=value2",如果跳转的页面路径是 tabBar 页面则不能带参数
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

wx.reLaunch({
  url: "test?id=1"
})
//test.js
Page({
  onLoad: function(option){
    console.log(option.query)
  }
})

wx.switchTab(OBJECT)

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面

OBJECT 参数说明:

参数 类型 必填 说明
url String 需要跳转的 tabBar 页面的路径(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

{
  "tabBar": {
    "list": [{
      "pagePath": "index",
      "text": "首页"
    },{
      "pagePath": "other",
      "text": "其他"
    }]
  }
}
wx.switchTab({
  url: "/index"
})

wx.navigateBack(OBJECT)

关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages()获取当前的页面栈,决定需要返回几层。

OBJECT 参数说明:

参数 类型 默认值 说明
delta Number 1 返回的页面数,如果 delta 大于现有页面数,则返回到首页。

示例代码:

// 注意:调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
wx.navigateTo({
  url: "B?id=1"
})

// 此处是B页面
wx.navigateTo({
  url: "C?id=1"
})

// 在C页面内 navigateBack,将返回A页面
wx.navigateBack({
  delta: 2
})

Tip

  1. tip: wx.navigateTo 和 wx.redirectTo 不允许跳转到 tabbar 页面,只能用 wx.switchTab 跳转到 tabbar 页面

wx.showNavigationBarLoading(Object object)

在当前页面显示导航条加载动画

OBJECT 参数说明:

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

wx.setNavigationBarTitle(Object object)

动态设置当前页面的标题

OBJECT 参数说明:

属性 类型 默认值 必填 说明
title string 页面标题
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.setNavigationBarTitle({
  title: "当前页面"
})

wx.setNavigationBarColor(Object object)

基础库 1.4.0 开始支持,低版本需做兼容处理。

设置页面导航条颜色

OBJECT 参数说明:

属性 类型 默认值 必填 说明
frontColor string 前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000
backgroundColor string 背景颜色值,有效值为十六进制颜色
animation Object 动画效果
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.animation 的结构

属性 类型 默认值 必填 说明
duration number 0 动画变化时间,单位 ms
timingFunc string "linear" 动画变化方式

object.animation.timingFunc 的合法值

说明 最低版本
"linear" 动画从头到尾的速度是相同的
"easeIn" 动画以低速开始
"easeOut" 动画以低速结束
"easeInOut" 动画以低速开始和结束

示例代码


wx.setNavigationBarColor({
  frontColor: "#ffffff",
  backgroundColor: "#ff0000",
  animation: {
    duration: 400,
    timingFunc: "easeIn"
  }
})

wx.hideNavigationBarLoading(Object object)

在当前页面隐藏导航条加载动画

OBJECT 参数说明:

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

wx.hideHomeButton(Object object)

基础库 2.8.3 开始支持,低版本需做兼容处理。

隐藏返回首页按钮。微信7.0.7版本起,当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。

OBJECT 参数说明:

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


阅读全文
以上是58编程为你收集整理的微信小程序API导航组件 微信小程序API 导航全部内容。
声明:本站所有文章资源内容,如无特殊说明或标注,均为采集网络资源。如若本站内容侵犯了原著者的合法权益,可联系本站删除。
相关文章
© 2024 58编程 58biancheng.com 版权所有 联系我们
桂ICP备12005667号-32 Powered by CMS