navigator 页面导航
- 属性说明
- 示例

navigator 页面导航

解释：页面链接，控制小程序的跳转，既可在当前小程序内部进行跳转，也可跳转至其他小程序。navigator 的子节点背景色应为透明色。

属性说明

属性名	类型	默认值	必填	说明	最低版本
target	String	self	否	在哪个目标上发生跳转，默认当前小程序，有效值self/miniProgram	2.5.2低版本请做兼容性处理
url	String		否	应用内的跳转链接	-
open-type	String	navigate	否	跳转方式	-
delta	Number		否	当 open-type 为 'navigateBack' 时有效，表示回退的层数	-
app-id	String		否	当target="miniProgram"时有效，要打开的小程序 App Key (小程序后台设置-开发设置中)	2.5.2低版本请做兼容性处理
path	String		否	当target="miniProgram"时有效，打开的页面路径，如果为空则打开首页。	2.5.2低版本请做兼容性处理
extra-data	Object		否	当target="miniProgram"时有效，需要传递给目标小程序的数据，目标小程序可在 App.onLaunch()，App.onShow() 中获取到这份数据。详情	2.5.2低版本请做兼容性处理
version	String	release	否	当target="miniProgram"时有效，要打开的小程序版本，有效值 develop（开发版），trial（体验版），release（正式版），仅在当前小程序为开发版或体验版时此参数有效；如果当前小程序是正式版，则打开的小程序必定是正式版。	2.5.2低版本请做兼容性处理
hover-class	String	navigator-hover	否	指定点击时的样式类，当`hover-class="none"`时，没有点击态效果。
hover-stop-propagation	Boolean	false	否	指定是否阻止本节点的祖先节点出现点击态。	-
hover-start-time	Number	50	否	按住后多久出现点击态，单位毫秒。	-
hover-stay-time	Number	600	否	手指松开后点击态保留时间，单位毫秒。	-
bindsuccess	String		否	当target="miniProgram"时有效，跳转小程序成功。	2.5.2低版本请做兼容性处理
bindfail	String		否	当target="miniProgram"时有效，跳转小程序失败。	2.5.2低版本请做兼容性处理
bindcomplete	String		否	当target="miniProgram"时有效，跳转小程序完成。	2.5.2低版本请做兼容性处理

target 有效值

值	说明
self	当前小程序
miniProgram	跳转到另一个小程序

version 有效值

值	说明
develop	开发版
trial	体验版
release	正式版

open-type 有效值

值	说明	最低版本
navigate	对应 `swan.navigateTo` 的功能
redirect	对应 `swan.redirectTo` 的功能
switchTab	对应 `swan.switchTab` 的功能
navigateBack	对应 `swan.navigateBack` 的功能
reLaunch	对应 `swan.reLaunch` 的功能
exit	退出小程序，target="miniProgram"时生效	2.5.2

示例

在开发者工具中预览效果

扫码体验

请使用百度APP扫码

代码示例1

在开发者工具中预览效果

<view class="card-area">
    <button type="primary">
    <navigator target="self" open-type="navigate" url="/pages/detail/detail?id=新页面,点击左上角返回回到之前页面" hover-class="navigator-hover" hover-stop-propagation="true">
        跳转到新页面
    </navigator>
    </button>
    <button type="primary">
    <navigator target="self" open-type="redirect" url="/pages/detail/detail?id=当前页,点击左上角返回回到上级菜单" hover-class="other-navigator-hover">在当前页打开</navigator>
    </button>
    <button type="primary">
    <navigator target="self" open-type="navigateBack" hover-class="other-navigator-hover" delta="1">返回上一页面</navigator>
    </button>
    <button type="primary">
    <navigator target="miniProgram" open-type="exit">退出当前小程序</navigator>
    </button>
    <button type="primary">
    <navigator target="self" open-type="switchTab" url="/pages/component/component">打开一个有Tab的页面</navigator>
    </button>
    <button type="primary">
    <navigator target="self" open-type="reLaunch" url="/pages/detail/detail?id=新页面,点击左上角返回回到上级菜单">
        关闭所有页面打开新页面
    </navigator>
    </button>
    <button type="primary">
    <navigator target="miniProgram" 
        open-type="navigate" extra-data="extra-data" 
            app-id="79RKhZ2BTvyyHitg4W3Xle4kkFgwwXyp" version="release" 
        bindsuccess="successHandler" bindfail="failHandler" 
        bindcomplete="completeHandler"
        >
        打开绑定的小程序
    </navigator>
    </button>
</view>

Page({
    data: {},
    successHandler: function (e) {
        console.log('success');
    },
    failHandler: function (e) {
        console.log('fail');
    },
    completeHandler: function(e){
        console.log('complete');
    }
});

代码示例2

在开发者工具中预览效果

在 detail 文件中

<web-view src="{{url}}"></web-view>

Page({
    data: {
        src: ''
    },
   //接收H5页传过来的参数
    onLoad(options) {
        this.setData({'src': options.webViewUrl})
    },
    onShow(){
        this.onLoad()
    }
});

在 index 文件中

<view class="wrap">
    <button type="primary">
        <navigator target="self" open-type="navigate" url="/detail/detail?webViewUrl=https://smartprogram.baidu.com&Math.radom()" hover-class="navigator-hover" hover-stop-propagation="true">
            跳转到新页面
        </navigator>
    </button>
</view>

说明 :

navigator-hover 默认为:

{
    background-color: rgba(0, 0, 0, 0.1);
    opacity: 0.7;
}