首页分享微信小程序页面导航 navigator 组件

微信小程序页面导航 navigator 组件

来源：萌宠菠菠乐园时间：2024-12-21 13:30

完整微信小程序(Java后端) 技术贴目录清单页面（必看）

页面导航(navigator)组件,它类似于HTML中的a标签；

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

target 的合法值

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

open-type 的合法值

version 的合法值

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

使用限制

需要用户确认跳转从 2.3.0 版本开始，在跳转至其他小程序前，将统一增加弹窗，询问是否跳转，用户确认后才可以跳转其他小程序。如果用户点击取消，则回调 fail cancel。每个小程序可跳转的其他小程序数量限制为不超过 10 个从 2.4.0 版本以及指定日期（具体待定）开始，开发者提交新版小程序代码时，如使用了跳转其他小程序功能，则需要在代码配置中声明将要跳转的小程序名单，限定不超过 10 个，否则将无法通过审核。该名单可在发布新版时更新，不支持动态修改。配置方法详见配置。调用此接口时，所跳转的 appId 必须在配置列表中，否则回调 fail appId "${appId}" is not in navigateToMiniProgramAppIdList。

无需声明跳转名单，不限跳转数量（众测中）

从2020年4月24日起，使用跳转其他小程序功能将无需在全局配置中声明跳转名单，调用此接口时将不再校验所跳转的 AppID 是否在 navigateToMiniProgramAppIdList 中。从2020年4月24日起，跳转其他小程序将不再受数量限制，使用此功能时请注意遵守运营规范。

关于调试

在开发者工具上调用此 API 并不会真实的跳转到另外的小程序，但是开发者工具会校验本次调用跳转是否成功。详情开发者工具上支持被跳转的小程序处理接收参数的调试。详情

Bug & Tip

tip：navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, navigator 的子节点背景色应为透明色

示例代码

在开发者工具中预览效果

index.wxml

<view class="btn-area"> <navigator url="/navigate/navigate?title=navigate" hover-class="navigator-hover">跳转到新页面</navigator> <navigator url="../redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开</navigator>  </view> 123456

index.js

// redirect.js navigator.js Page({ onLoad: function (options) { this.setData({ title: options.title }) } }) 12345678

index.wxss

@import '../lib/weui.wxss' /** wxss **/ /** 修改默认的navigator点击态 **/ .navigator-hover { color:blue; } /** 自定义其他点击态样式类 **/ .other-navigator-hover { color:red; } 12345678910

navigator.wxml

<view style="text-align:center"> {{title}} </view> <view> 点击左上角返回回到之前页面 </view> 123

navigator.js

// redirect.js navigator.js Page({ onLoad: function (options) { this.setData({ title: options.title }) } }) 12345678

运行效果：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-SJZseJnc-1622870031676)(image-20210605103436764.png)]