跳到主要内容
版本:2.x

Navigator

页面链接

参考文档

类型

ComponentType<NavigatorProps>
参数类型默认值必填说明
target"self" | "miniProgram""self"在哪个目标上发生跳转,默认当前小程序
urlstring当前小程序内的跳转链接
openType"navigate" | "redirect" | "switchTab" | "reLaunch" | "navigateBack" | "exit""navigate"跳转方式
deltanumber当 open-type 为 'navigateBack' 时有效,表示回退的层数
appIdstringtarget="miniProgram" 时有效,要打开的小程序 appId
pathstringtarget="miniProgram" 时有效,打开的页面路径,如果为空则打开首页
extraDataobjecttarget="miniProgram" 时有效,需要传递给目标小程序的数据,目标小程序可在 App.onLaunch()App.onShow() 中获取到这份数据.
version"develop" | "trial" | "release"target="miniProgram" 时有效,要打开的小程序版本
hoverClassstring"navigator-hover"指定按下去的样式类。当 hover-class="none" 时,没有点击态效果
hoverStopPropagationbooleanfalse指定是否阻止本节点的祖先节点出现点击态
hoverStartTimenumber50按住后多久出现点击态,单位毫秒
hoverStayTimenumber600手指松开后点击态保留时间,单位毫秒
onSuccessBaseEventOrigFunction<any>target="miniProgram" 时有效,跳转小程序成功
onFailBaseEventOrigFunction<any>target="miniProgram" 时有效,跳转小程序失败
onCompleteBaseEventOrigFunction<any>target="miniProgram" 时有效,跳转小程序完成

API 支持度

API微信小程序百度小程序支付宝小程序抖音小程序H5React Native
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.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正式版,仅在当前小程序为开发版或体验版时此参数有效;如果当前小程序是正式版,则打开的小程序必定是正式版。

API 支持度

API微信小程序百度小程序支付宝小程序抖音小程序H5React Native
Navigator✔️✔️✔️✔️