• navigator

    navigator

    页面链接。

    属性说明

    属性名类型默认值说明平台差异说明
    urlString应用内的跳转链接，值为相对路径或绝对路径，如："../first/first"，"/pages/first/first"，注意不能加 .vue 后缀
    open-typeStringnavigate跳转方式
    deltaNumber当 open-type 为 'navigateBack' 时有效，表示回退的层数
    animation-typeStringpop-in/out当 open-type 为 navigate、navigateBack 时有效，窗口的显示/关闭动画效果，详见：窗口动画5+App
    animation-durationNumber300当 open-type 为 navigate、navigateBack 时有效，窗口显示/关闭动画的持续时间。5+App
    hover-classStringnavigator-hover指定点击时的样式类，当hover-class="none"时，没有点击态效果
    hover-stop-propagationBooleanfalse指定是否阻止本节点的祖先节点出现点击态微信小程序
    hover-start-timeNumber50按住后多久出现点击态，单位毫秒
    hover-stay-timeNumber600手指松开后点击态保留时间，单位毫秒

    open-type 有效值

    值说明平台差异说明
    navigate对应 uni.navigateTo 的功能
    redirect对应 uni.redirectTo 的功能
    switchTab对应 uni.switchTab 的功能
    reLaunch对应 uni.reLaunch 的功能头条小程序不支持
    navigateBack对应 uni.navigateBack 的功能

    注意

    • navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, <navigator> 的子节点背景色应为透明色。**
    • app-nvue 平台暂不支持 <navigator>示例
    1. <template>
    2.     <view>
    3.         <view class="page-body">
    4.             <view class="btn-area">
    5.                 <navigator url="navigate/navigate?title=navigate" hover-class="navigator-hover">
    6.                     <button type="default">跳转到新页面</button>
    7.                 </navigator>
    8.                 <navigator url="redirect/redirect?title=redirect" redirect hover-class="other-navigator-hover">
    9.                     <button type="default">在当前页打开</button>
    10.                 </navigator>
    11.             </view>
    12.         </view>
    13.     </view>
    14. </template>
    1. // navigate.vue页面接受参数
    2. export default {
    3.     onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
    4.         console.log(option.id); //打印出上个页面传递的参数。
    5.         console.log(option.name); //打印出上个页面传递的参数。
    6.     }
    7. }

    url有长度限制，太长的字符串会传递失败，可使用窗体通信、全局变量，或encodeURIComponent等多种方式解决，如下为encodeURIComponent示例。

    1. <navigator :url="'/pages/navigate/navigate?item='+ encodeURIComponent(JSON.stringify(item))"></navigator>
    // navigate.vue页面接受参数
onLoad: function (option) {
    const item = JSON.parse(decodeURIComponent(option.item));
}

    注意

    • 跳转tabbar页面，必须设置open-type="switchTab"

    发现错误？想参与编辑？在 GitHub 上编辑此页面！