目录
一、创建页面
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.创建页面文件：
在刚刚创建的文件夹中，添加与页面相关的文件。这通常包括以下几个文件：
.vue文件：页面的主要文件，包含HTML、CSS和JavaScript代码。
style文件：用于定义页面的样式。
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中的开发有所帮助。
