navigator标签

类似于html中的a标签,虽然名字长,但是属性也多。
navigator是块元素

基础库 1.0.0 开始支持,低版本需做兼容处理
页面链接。

在小程序插件中使用需要基础库版本 2.1.0 起。
属性类型默认值必填说明最低版本
targetstringself在哪个目标上发生跳转,默认当前小程序2.0.7
urlstring 当前小程序内的跳转链接1.0.0
open-typestringnavigate跳转方式1.0.0
deltanumber1当 open-type 为 'navigateBack' 时有效,表示回退的层数1.0.0
app-idstring target="miniProgram"时有效,要打开的小程序 appId2.0.7
pathstring target="miniProgram"时有效,打开的页面路径,如果为空则打开首页2.0.7
extra-dataobject target="miniProgram"时有效,需要传递给目标小程序的数据,目标小程序可在 App.onLaunch()App.onShow() 中获取到这份数据。详情2.0.7
versionstringreleasetarget="miniProgram"时有效,要打开的小程序版本2.0.7
hover-classstringnavigator-hover指定点击时的样式类,当hover-class="none"时,没有点击态效果1.0.0
hover-stop-propagationbooleanfalse指定是否阻止本节点的祖先节点出现点击态1.5.0
hover-start-timenumber50按住后多久出现点击态,单位毫秒1.0.0
hover-stay-timenumber600手指松开后点击态保留时间,单位毫秒1.0.0
bindsuccessstring target="miniProgram"时有效,跳转小程序成功2.0.7
bindfailstring target="miniProgram"时有效,跳转小程序失败2.0.7
bindcompletestring target="miniProgram"时有效,跳转小程序完成2.0.7

target 的合法值

说明最低版本
self当前小程序
miniProgram其它小程序

version 的合法值

说明最低版本
develop开发版
trial体验版
release正式版,仅在当前小程序为开发版或体验版时此参数有效;如果当前小程序是正式版,则打开的小程序必定是正式版。

url属性

当前小程序内的跳转链接
wxml:

<view><navigator url="/pages/logs/logs">跳转到日志</navigator></view>

跳转到日志页面

注意

路径最后的文件名不要加.wxml

target属性

可以跳转到其他小程序,但不能跳转到除微信小程序以外的页面。

open-type

设置页面的跳转类型,默认跳转是保留上一层页面,可返回上一步页面,但是很多小程序底部有导航栏,不需要保存上一步页面,所以需要设置open-type类型。
open-type 的合法值

说明最低版本
navigate对应 wx.navigateTowx.navigateToMiniProgram 的功能
redirect对应 wx.redirectTo 的功能
switchTab对应 wx.switchTab 的功能
reLaunch对应 wx.reLaunch 的功能1.1.0
navigateBack对应 wx.navigateBack 的功能1.1.0
exit退出小程序,target="miniProgram"时生效2.1.0

redirect

https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.redirectTo.html
关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。



无返回上一步按钮,直接销毁上一步页面

switchTab

如果要tabber页面之间的切换,可使用switchTab,但是不能携带参数:https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html

reLaunch

后期使用频率较多。
tabber页面之间的切换,并且携带参数,使用reLaunch:
https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.reLaunch.html

最后修改:2024 年 03 月 14 日
如果觉得我的文章对你有用,请随意赞赏