Version: next

Navigator

页面链接

参考文档

类型

ComponentType<NavigatorProps>

NavigatorProps

参数类型默认值必填说明
target
"self" | "miniProgram"
"self"
在哪个目标上发生跳转,默认当前小程序
url
string
当前小程序内的跳转链接
openType
"navigate" | "redirect" | "switchTab" | "reLaunch" | "navigateBack" | "exit"
"navigate"
跳转方式
delta
number
当 open-type 为 'navigateBack' 时有效,表示回退的层数
appId
string
target="miniProgram"
时有效,要打开的小程序 appId
path
string
target="miniProgram"
时有效,打开的页面路径,如果为空则打开首页
extraData
object
target="miniProgram"
时有效,需要传递给目标小程序的数据,目标小程序可在
App.onLaunch()
App.onShow()
中获取到这份数据.
version
"develop" | "trial" | "release"
target="miniProgram"
时有效,要打开的小程序版本
hoverClass
string
"navigator-hover"
指定按下去的样式类。当
hover-class="none"
时,没有点击态效果
hoverStopPropagation
boolean
false
指定是否阻止本节点的祖先节点出现点击态
hoverStartTime
number
50
按住后多久出现点击态,单位毫秒
hoverStayTime
number
600
手指松开后点击态保留时间,单位毫秒
onSuccess
BaseEventOrigFunction<any>
target="miniProgram"
时有效,跳转小程序成功
onFail
BaseEventOrigFunction<any>
target="miniProgram"
时有效,跳转小程序失败
onComplete
BaseEventOrigFunction<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✔️✔️✔️✔️