关于UniApp的页面和路由跳转的介绍

目录

一、创建页面

        1.创建页面文件夹：

        2.创建页面文件：

        3.添加页面到路由：

二、路由跳转

        1.uni.navigateTo(OBJECT)

        2. uni.redirectTo(OBJECT)

        3.uni.switchTab(OBJECT)

         4.uni.reLaunch(OBJECT)

        5.uni.navigateBack(OBJECT)

        窗口动画

API

组件

pages.json

三、总结

---

---

一、创建页面

        在UniApp中，页面是应用程序的基本组成部分。要创建一个页面，你需要进行以下步骤：

        1.创建页面文件夹：

                在项目的pages目录下创建一个新的文件夹。这个文件夹将包含页面的所有相关文件。

        2.创建页面文件：

                 在刚刚创建的文件夹中，添加与页面相关的文件。这通常包括以下几个文件：

        1..vue文件：页面的主要文件，包含HTML、CSS和JavaScript代码。

        2.style文件：用于定义页面的样式。

        3.script文件：用于处理页面的逻辑。

        3.添加页面到路由：

                  在项目的pages.json文件中，添加新页面的路由。如下所示：

{
  "pages": [
    {
      "path": "pages/home/index", // 页面路径
      "style": {
        "navigationBarTitleText": "主页" // 页面标题
      }
    },
    {
      "path": "pages/about/index", // 另一个页面
      "style": {
        "navigationBarTitleText": "关于我们" // 页面标题
      }
    }
  ]
}

二、路由跳转

        在UniApp中，页面之间的跳转非常简单。可以使用uni.navigateTo、uni.redirectTo等方法来跳转页面。

        1.uni.navigateTo(OBJECT)

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

                OBJECT参数说明     

参数	类型	必填	默认值	说明	平台差异说明
url	String	是		需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'，path为下一个页面的路径，下一个页面的onLoad函数可得到传递的参数
animationType	String	否	pop-in	窗口显示的动画效果，详见：窗口动画	App
animationDuration	Number	否	300	窗口动画持续时间，单位为 ms	App
events	Object	否		页面间通信接口，用于监听被打开页面发送到当前页面的数据。2.8.9+ 开始支持。
success	Function	否		接口调用成功的回调函数
fail	Function	否		接口调用失败的回调函数
complete	Function	否		接口调用结束的回调函数（调用成功、失败都会执行）

                这是最常用的跳转方式，会在导航栈中添加一个新的页面。示例代码：

uni.navigateTo({
  url: '/pages/about/index', // 跳转到“关于我们”页面
});

注意：

• 页面跳转路径有层级限制，不能无限制跳转新页面
• 跳转到 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已对多端进行封装，可参考。

        2. uni.redirectTo(OBJECT)

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

                OBJECT参数说明

参数	类型	必填	说明
url	String	是	需要跳转的应用内非 tabBar 的页面的路径，路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

                 这会替换当前页面，适用于不需要保留返回栈的场景。

                 示例

uni.redirectTo({
	url: 'test?id=1'
});

注意：

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

        3.uni.switchTab(OBJECT)

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

                OBJECT参数说明

参数	类型	必填	说明
url	String	是	需要跳转的 tabBar 页面的路径（需在 pages.json 的 tabBar 字段定义的页面），路径后不能带参数
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

                示例

                pages.json

{
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    },{
      "pagePath": "pages/other/other",
      "text": "其他"
    }]
  }
}

如果你使用了标签页（TabBar），可以使用这个方法在标签页之间跳转。

uni.switchTab({
  url: '/pages/tabbar/home', // 跳转到TabBar中的首页
});

         4.uni.reLaunch(OBJECT)

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

                OBJECT参数说明

参数	类型	必填	说明
url	String	是	需要跳转的应用内页面路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'，如果跳转的页面路径是 tabBar 页面则不能带参数
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

                示例

uni.reLaunch({
	url: 'test?id=1'
});

export default {
	onLoad: function (option) {
		console.log(option.id);
	}
}

Tips：

• H5端调用 uni.reLaunch之后之前页面栈会销毁，但是无法清空浏览器之前的历史记录，此时 navigateBack不能返回，如果存在历史记录的话点击浏览器的返回按钮或者调用history.back()仍然可以导航到浏览器的其他历史记录。

        5.uni.navigateBack(OBJECT)

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

                OBJECT参数说明

参数	类型	必填	默认值	说明	平台差异说明
delta	Number	否	1	返回的页面数，如果 delta 大于现有页面数，则返回到首页。
animationType	String	否	pop-out	窗口关闭的动画效果，详见：窗口动画	App
animationDuration	Number	否	300	窗口关闭动画的持续时间，单位为 ms	App
success	Function	否		接口调用成功的回调函数
fail	Function	否		接口调用失败的回调函数
complete	Function	否		接口调用结束的回调函数（调用成功、失败都会执行）

                示例

// 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
uni.navigateTo({
	url: 'B?id=1'
});

// 此处是B页面
uni.navigateTo({
	url: 'C?id=1'
});

// 在C页面内 navigateBack，将返回A页面
uni.navigateBack({
	delta: 2
});

        窗口动画

本API仅App支持。小程序自身不支持自定义动画。H5的窗体动画可使用常规单页动画处理方案。

窗口的显示/关闭动画效果，支持在 API、组件、pages.json 中配置，优先级为：API = 组件 > pages.json

API

有效的路由 API

• navigateTo
• navigateBack

uni.navigateTo({
	url: '../test/test',
	animationType: 'pop-in',
	animationDuration: 200
});
uni.navigateBack({
	delta: 1,
	animationType: 'pop-out',
	animationDuration: 200
});

组件

open-type 有效值

• navigateTo
• navigateBack

<navigator animation-type="pop-in" animation-duration="300" url="../test/test">navigator</navigator>
<navigator animation-type="pop-out" animation-duration="300" open-type="navigateBack" >navigator</navigator>

pages.json

pages.json 中配置的是窗口显示的动画

"style": {
	"app-plus": {
		"animationType": "fade-in",
		"animationDuration": 300
	}
}

显示动画与关闭动画，会有默认的对应规则。但是如果通过 API 或组件配置了窗口关闭的动画类型，则不会使用默认的类型。

显示动画	关闭动画	显示动画描述（关闭动画与之相反）
slide-in-right	slide-out-right	新窗体从右侧进入
slide-in-left	slide-out-left	新窗体从左侧进入
slide-in-top	slide-out-top	新窗体从顶部进入
slide-in-bottom	slide-out-bottom	新窗体从底部进入
pop-in	pop-out	新窗体从左侧进入，且老窗体被挤压而出
fade-in	fade-out	新窗体从透明到不透明逐渐显示
zoom-out	zoom-in	新窗体从小到大缩放显示
zoom-fade-out	zoom-fade-in	新窗体从小到大逐渐放大并且从透明到不透明逐渐显示
none	none	无动画

详细的窗口动画说明，请参考：

• 窗口显示的动画：AnimationTypeShow
• 窗口关闭的动画：AnimationTypeClose

注意

• 纯nvue项目（render为native），窗体动画默认进入动画为popin，返回为pop-out。如果想修改动画类型，只能通过uni.navigateTo API修改，在组件或pages.json里配置动画类型无效
• 非纯nvue项目，App端窗体动画，默认进入动画为slider-in-right，默认返回动画为pop-out
• webview 中嵌入 uni-app H5时，使用 uni.webView.navigateTo... 跳转页面

三、总结

        本文介绍了如何在UniApp中创建页面以及如何进行页面之间的路由跳转。通过这些步骤，你可以创建一个多页面应用，并通过路由跳转实现页面之间的导航。希望这对你在UniApp中的开发有所帮助。