【uniapp小程序】路由跳转navigator传参封装

简介: 【uniapp小程序】路由跳转navigator传参封装

前言

在实际应用开发中我们经常要使用到路由跳转,在uniapp官网中,提供了navigator内置组件,供我们使用。官网地址:navigator页面跳转。


正文

1、看官网

1.1 navigator API 介绍

页面跳转。


该组件类似HTML中的<a>组件,但只能跳转本地页面。目标页面必须在pages.json中注册。


该组件的功能有API方式,另见:https://uniapp.dcloud.io/api/router?id=navigateto


属性说明

image.png

open-type 有效值

image.png

注意


跳转tabbar页面,必须设置open-type=“switchTab”

navigator-hover 默认为 {background-color: rgba(0, 0, 0, 0.1); opacity: 0.7;}, <navigator> 的子节点背景色应为透明色。

navigator-open-type属性 如果使用对应的值,则对应值的功能会高于对应跳转路径。

app-nvue 平台只有纯nvue项目(render为native)才支持 <navigator>。非render为native的情况下,nvue暂不支持navigator组件,请使用API跳转。

app下退出应用,Android平台可以使用plus.runtime.quit。iOS没有退出应用的概念。

uLink组件是navigator组件的增强版,样式上自带下划线,功能上支持打开在线网页、其他App的schema、mailto发邮件、tel打电话。

1.2、路由跳转参数传递

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


image.png

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

1.3、五种常见的跳转方式

以下只做简单的介绍,详细说明和案例可移步:官方文档


1.3.1 uni.navigateTo(OBJECT)

保留当前页面,跳转到应用内的某个页面,使用uni.navigateBack可以返回到原页面。


注: 因为我们今天封装路由跳转主要使用的是navigateTo,所以我将官方的文档复制了过来可以看下详细的参数介绍。


OBJECT参数说明

image.png

object.success 回调函数

参数

Object res

属性 类型 说明
eventChannel EventChannel 和被打开页面进行通信

示例

//在起始页面跳转到test.vue页面并传递参数
uni.navigateTo({
  url: 'test?id=1&name=uniapp'
});
// 在test.vue页面接受参数
export default {
  onLoad: function (option) { //option为object类型,会序列化上个页面传递的参数
    console.log(option.id); //打印出上个页面传递的参数。
    console.log(option.name); //打印出上个页面传递的参数。
  }
}
// 在起始页面跳转到test.vue页面,并监听test.vue发送过来的事件数据
uni.navigateTo({
  url: 'pages/test?id=1',
  events: {
    // 为指定事件添加一个监听器,获取被打开页面传送到当前页面的数据
    acceptDataFromOpenedPage: function(data) {
      console.log(data)
    },
    someEvent: function(data) {
      console.log(data)
    }
    ...
  },
  success: function(res) {
    // 通过eventChannel向被打开页面传送数据
    res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'data from starter page' })
  }
})
// 在test.vue页面,向起始页通过事件传递数据
onLoad: function(option) {
  const eventChannel = this.getOpenerEventChannel();
  eventChannel.emit('acceptDataFromOpenedPage', {data: 'data from test page'});
  eventChannel.emit('someEvent', {data: 'data from test page for someEvent'});
  // 监听acceptDataFromOpenerPage事件,获取上一页面通过eventChannel传送到当前页面的数据
  eventChannel.on('acceptDataFromOpenerPage', function(data) {
    console.log(data)
  })
}

url有长度限制,太长的字符串会传递失败,可改用窗体通信、全局变量,另外参数中出现空格等特殊字符时需要对参数进行编码,如下为使用encodeURIComponent对参数进行编码的示例。

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

注意:


页面跳转路径有层级限制,不能无限制跳转新页面

跳转到 tabBar 页面只能使用 switchTab 跳转

路由API的目标页面必须是在pages.json里注册的vue页面。如果想打开web url,在App平台可以使用 plus.runtime.openURL或web-view组件;H5平台使用 window.open;小程序平台使用web-view组件(url需在小程序的联网白名单中)。在hello uni-app中有个组件ulink.vue已对多端进行封装,可参考。

1.3.2 uni.redirectTo(OBJECT)

关闭当前页面,跳转到应用内的某个页面。


1.3.3 uni.reLaunch(OBJECT)

关闭所有页面,打开到应用内的某个页面。


1.3.4 uni.switchTab(OBJECT)

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。


1.3.5 uni.navigateBack(OBJECT)

关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages() 获取当前的页面栈,决定需要返回几层。默认值为1。


2、路由跳转传参简易封装

2.1、首先列举一下需要考虑的参数

URL :目标地址

params:有没有携带参数跳转

openType :跳转方式(文档里名字为open-type)

animation-type:当 open-type 为 navigate、navigateBack 时有效,窗口的显示/关闭动画效果。

animation-duration:窗口显示/关闭动画的持续时间。

2.2、封装代码

本示例代码封装在mina.js 文件:

// openType 默认值为 navigate;animationType 默认值为pop-in;animationDuration 默认值为300毫秒
Vue.prototype.goByPath = function(path, params, openType = 'navigate', animationType = 'pop-in', animationDuration =
  300) {
  // 有参数执行这里的逻辑
  if(params !==undefined && params !== null){
    if (openType == 'navigate') {
    // 如果跳转方式为navigate,则使用navigateTo方式跳转,保留当前页面,跳转到应用内的某个页面
      uni.navigateTo({
        url: path + "?params=" + encodeURIComponent(JSON.stringify(params)),
        animationType: animationType,
        animationDuration: animationDuration
      })
    } else {
    // 如果跳转方式不为navigate,则使用redirectTo方式跳转,关闭当前页面,跳转到应用内的某个页面
      uni.redirectTo({
        url: path + "?params=" + encodeURIComponent(JSON.stringify(params)),
        animationType: animationType,
        animationDuration: animationDuration
      })
    }
  }else{
  // 没有参数直接使用navigateTo方式跳转,保留当前页面,跳转到应用内的某个页面
    uni.navigateTo({
      url: path,
      animationType: animationType,
      animationDuration: animationDuration
    })
  }
}
// 返回上一页
Vue.prototype.goBack = function() {
  uni.navigateBack({
    delta: 1
  });
}

encodeURIComponent是对参数进行编码,因为url有长度限制,太长的字符串会传递失败。

在获取参数的页面,再使用 decodeURIComponent进行解码即可。


3、案例演示

封装好了我们就来试试好不好使。


介绍一下我的案例:点击轮播图,跳转值轮播图的详情页(index.vue),携带图片和标题两个参数,并渲染在详情页面(detail.vue)。


index.vue文件:

这里只粘贴了部分轮播图组件代码,和所需要的数据。轮播图案例移步至:【uniapp小程序开发】—— 组件封装之【自定义轮播图】

<template>
<!-- 轮播图组件 -->
    <view class="px-3 py-2 ">
      <swiperDot class="position-relative" :current="current" :info="swipers">
      <!--
          swiper常用属性介绍:
            indicator-dots:轮播图正前方的小圆点(此案例没有使用官方提供的,是自定义的在右下角附近)
            autoplay:是否自动切换
            interval:图片轮播间隔此处为3秒
            duration:图片轮播动画时长 此处为0.5秒
            circular:是否开启无缝轮播(此处为到第三张图片后无缝播放第一张图片)
         -->
        <swiper :autoplay="true" :interval="3000" :duration="500" circular style="height: 250rpx;"
          @change="changeIndicatorDots">
          <swiper-item v-for="(item,index) in swipers" :key="index" @click="goByPath('/pages/index/detail',{src:item.src,title:item.title})">
            <image :src="item.src" mode="sapectFill" style="height:250rpx;width: 100%;" class="rounded-lg">
      </image>
      </swiper-item>
    </swiper>
  </swiperDot>
  </view>
</template>
<script>
  import swiperDot from '@/components/comon/swiper-doc.vue'
  export default {
    components: {
      swiperDot
    },
    data() {
      return {
        current: 0, // 标识当前选中的图片序列号
        swipers: [{
          src: '/static/swiper/1.jpg',
          title: '自定义轮播图组件图片一'
        }, {
          src: '/static/swiper/2.jpg',
          title: '自定义轮播图组件图片二名字很长测试用'
        }, {
          src: '/static/swiper/3.jpg',
          title: '自定义轮播图组件图片三'
        }]
      }
    }
</script>

detail.vue文件

<template>
  <view>
    <view class="title">
      {{title}}
    </view>
    <image :src="src" mode="sapectFill" style="height:250rpx;width: 100%;"></image>
    <view>
      <!-- 调用封装好的goBack方法返回上一页 -->
      <button type="primary" @click="goBack">返回</button>
    </view>
  </view>
</template>
<script>
  import swiperDot from '@/components/comon/swiper-doc.vue'
  export default {
    components: {
      swiperDot
    },
    data() {
      return {
        src:'',
        title:''
      }
    },
    onLoad(option) {
      // 打印传递过来的参数
      console.log(option)
      // decodeURIComponent将参数解码并使用JSON.parse() 方法用来解析JSON字符串转换为对象
      this.src = JSON.parse(decodeURIComponent(option.params)).src;
      this.title = JSON.parse(decodeURIComponent(option.params)).title;
    }
  }
</script>

效果图

目录
相关文章
|
3月前
|
API
uniapp使用路由名称跳转
【9月更文挑战第11天】在UniApp中,可通过定义路由名称实现页面跳转,需在`pages.json`中设置页面的`name`属性。使用`uni.navigateTo`等API并指定名称即可跳转,例如`name: &#39;detailPage&#39;`。目标页面可在`onLoad`函数中获取传递的参数,这种方式使代码更清晰且便于维护,尤其适合大型项目。
109 1
|
28天前
|
人工智能 小程序 搜索推荐
uni app下开发AI运动小程序解决方案
本文介绍了在小程序中实现AI运动识别的解决方案。该方案依托于UNI平台,通过高效便捷的插件形式,实现包括相机抽帧控制、人体识别、姿态识别等在内的多项功能,无需依赖后台服务器,大幅提高识别效率和用户体验。方案内置多种运动模式,支持自定义扩展,适用于AI健身、云上赛事、AI体测等多场景,适合新开发和存量改造项目。
|
1月前
|
小程序 前端开发 JavaScript
在线课堂+工具组件小程序uniapp移动端源码
在线课堂+工具组件小程序uniapp移动端源码
35 0
在线课堂+工具组件小程序uniapp移动端源码
|
2月前
|
移动开发 小程序 数据可视化
基于npm CLI脚手架的uniapp项目创建、运行与打包全攻略(微信小程序、H5、APP全覆盖)
基于npm CLI脚手架的uniapp项目创建、运行与打包全攻略(微信小程序、H5、APP全覆盖)
349 3
|
4月前
|
小程序
微信小程序多种跳转页面方式
微信小程序多种跳转页面方式
|
2月前
|
移动开发 小程序 数据可视化
一招学会DIY官网可视化设计支持导出微擎、UNIAPP、H5、微信小程序源码
一招学会DIY官网可视化设计支持导出微擎、UNIAPP、H5、微信小程序源码
51 2
|
2月前
|
小程序 数据可视化 API
低代码可视化-uniapp商城首页小程序-代码生成器
低代码可视化-uniapp商城首页小程序-代码生成器
34 0
|
4月前
|
小程序 前端开发 Java
SpringBoot+uniapp+uview打造H5+小程序+APP入门学习的聊天小项目
JavaDog Chat v1.0.0 是一款基于 SpringBoot、MybatisPlus 和 uniapp 的简易聊天软件,兼容 H5、小程序和 APP,提供丰富的注释和简洁代码,适合初学者。主要功能包括登录注册、消息发送、好友管理及群组交流。
116 0
SpringBoot+uniapp+uview打造H5+小程序+APP入门学习的聊天小项目
|
2月前
|
存储 移动开发 小程序
uniapp富文本editor输入二次扩展兼容微信小程序
uniapp富文本editor输入二次扩展兼容微信小程序
94 0
|
2月前
|
小程序
uniapp实现微信小程序隐私协议组件封装
uniapp实现微信小程序隐私协议组件封装
54 0