navigator 页面链接

更新时间：2025-07-30 11:13:33

基础库1.1.0开始支持,低版本需做兼容处理

开发者工具1.22.0开始支持

页面链接。

属性

属性	类型	默认值	必填	说明
target	'self' | 'miniProgram'	'self'	否	在哪个目标上发生跳转，默认当前小程序
url	string		否	当前小程序内的跳转链接
open-type	'navigate' | 'redirect' | 'switchTab' | 'reLaunch' | 'navigateBack' | 'exit'	'navigate'	否	跳转方式
delta	number	1	否	当 open-type 为 'navigateBack' 时有效，表示回退的层数
app-id	string		否	当 target="miniProgram" 时有效，要打开的小程序 appId
path	string		否	当 target="miniProgram" 时有效，打开的页面路径，如果为空则打开首页
extra-data	Record<string | number | symbol, unknown>		否	当 target="miniProgram" 时有效，需要传递给目标小程序的数据，目标小程序可在 App.onLaunch()，App.onShow() 中获取到这份数据。
version	'develop' | 'trial' | 'release'	'release'	否	当 target="miniProgram" 时有效，要打开的小程序版本
hover-class	string	'navigator-hover'	否	指定点击时的样式类，当 hover-class="none" 时，没有点击态效果
hover-stop-propagation	boolean	false	否	指定是否阻止本节点的祖先节点出现点击态
hover-start-time	string | number	50	否	按住后多久出现点击态，单位毫秒
hover-stay-time	string | number	600	否	手指松开后点击态保留时间，单位毫秒

target

在哪个目标上发生跳转，默认当前小程序

值	说明
'self'	当前小程序
'miniProgram'	其它小程序

openType

跳转方式

值	说明	最低版本
'navigate'	对应 ks.navigateTo 或 ks.navigateToMiniProgram 的功能	-
'redirect'	对应 ks.redirectTo 的功能	-
'switchTab'	对应 ks.switchTab 的功能	-
'reLaunch'	对应 ks.reLaunch 的功能	-
'navigateBack'	对应 ks.navigateBack 的功能	-
'exit'	退出小程序，target="miniProgram" 时生效	1.44.0

version

当 target="miniProgram" 时有效，要打开的小程序版本

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

扫码体验

示例代码