Navigator
页面链接
支持情况：
类型
ComponentType<NavigatorProps>
NavigatorProps
| 参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| target | keyof Target | "self" | 否 | 在哪个目标上发生跳转，默认当前小程序 |
| url | string | 否 | 当前小程序内的跳转链接 | |
| openType | keyof OpenType | "navigate" | 否 | 跳转方式 |
| delta | number | 否 | 当 open-type 为 'navigateBack' 时有效，表示回退的层数 | |
| appId | string | 否 | 当 target="miniProgram" 时有效，要打开的小程序 appId | |
| path | string | 否 | 当 target="miniProgram" 时有效，打开的页面路径，如果为空则打开首页 | |
| extraData | object | 否 | 当 target="miniProgram" 时有效，需要传递给目标小程序的数据，目标小程序可在 App.onLaunch()，App.onShow() 中获取到这份数据. | |
| version | keyof Version | 否 | 当 target="miniProgram" 时有效，要打开的小程序版本 | |
| hoverClass | string | "navigator-hover" | 否 | 指定按下去的样式类。当 hover-class="none" 时，没有点击态效果 |
| hoverStopPropagation | boolean | false | 否 | 指定是否阻止本节点的祖先节点出现点击态 |
| hoverStartTime | number | 50 | 否 | 按住后多久出现点击态，单位毫秒 |
| hoverStayTime | number | 600 | 否 | 手指松开后点击态保留时间，单位毫秒 |
| shortLink | string | 否 | 当target="miniProgram"时有效，当传递该参数后，可以不传 app-id 和 path。链接可以通过【小程序菜单】->【复制链接】获取。 | |
| ariaLabel | string | 否 | 无障碍访问，（属性）元素的额外描述 | |
| onSuccess | CommonEventFunction | 否 | 当 target="miniProgram" 时有效，跳转小程序成功 | |
| onFail | CommonEventFunction | 否 | 当 target="miniProgram" 时有效，跳转小程序失败 | |
| onComplete | CommonEventFunction | 否 | 当 target="miniProgram" 时有效，跳转小程序完成 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | 抖音小程序 | QQ 小程序 | 京东小程序 | H5 | React Native | Harmony | Harmony hybrid |
|---|---|---|---|---|---|---|---|---|---|---|
| NavigatorProps.target | ✔️ | ✔️ | ✔️ | |||||||
| NavigatorProps.url | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
| NavigatorProps.openType | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
| NavigatorProps.delta | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||
| NavigatorProps.appId | ✔️ | ✔️ | ✔️ | |||||||
| NavigatorProps.path | ✔️ | ✔️ | ✔️ | |||||||
| NavigatorProps.extraData | ✔️ | ✔️ | ✔️ | |||||||
| NavigatorProps.version | ✔️ | ✔️ | ✔️ | |||||||
| NavigatorProps.hoverClass | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
| NavigatorProps.hoverStopPropagation | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| NavigatorProps.hoverStartTime | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| NavigatorProps.hoverStayTime | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||||
| NavigatorProps.shortLink | ✔️ | |||||||||
| NavigatorProps.ariaLabel | ✔️ | |||||||||
| NavigatorProps.onSuccess | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| NavigatorProps.onFail | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||||
| NavigatorProps.onComplete | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Target
target 的合法值
| 参数 | 说明 |
|---|---|
| self | 当前小程序 |
| miniProgram | 其它小程序 |
OpenType
open-type 的合法值
| 参数 | 说明 |
|---|---|
| navigate | 对应 Taro.navigateTo 或 Taro.navigateToMiniProgram 的功能 |
| redirect | 对应 Taro.redirectTo 的功能 |
| switchTab | 对应 Taro.switchTab 的功能 |
| reLaunch | 对应 Taro.reLaunch 的功能 |
| navigateBack | 对应 Taro.navigateBack 的功能 |
| exit | 退出小程序，target="miniProgram" 时生效 |
Version
version 的合法值
| 参数 | 说明 |
|---|---|
| develop | 开发版 |
| trial | 体验版 |
| release | 正式版，仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。 |