2024 不会还有人不会uniapp吧[狗头]

最新推荐文章于 2024-04-16 20:53:12 发布

m0_54861253

最新推荐文章于 2024-04-16 20:53:12 发布

阅读量963

点赞数 16

分类专栏：前端程序员文章标签： uni-app

本文链接：https://blog.csdn.net/m0_54861253/article/details/136766518

版权

前端程序员专栏收录该内容

9 篇文章 0 订阅

订阅专栏

本文详细介绍了uni-app的结构组织、关键配置文件如manifest.json和vue.config.js的作用，页面生命周期管理，路由配置，资源路径规则，以及TCP协议的基础知识。涵盖组件结构、生命周期函数、路由跳转和性能优化等内容。

摘要由CSDN通过智能技术生成

│ └─list.vue list页面

├─static 存放应用引用静态资源（如图片、视频等）的目录，注意：静态资源只能存放于此

├─wxcomponents 存放小程序组件的目录（自建）

├─common 公共资源（自建）

├─api 请求封装（自建）

├─store 状态管理（自建）

├─main.js Vue初始化入口文件

├─App.vue 应用配置，用来配置App全局样式以及监听应用生命周期

├─manifest.json 配置应用名称、appid、logo、版本等打包信息

└─pages.json 配置页面路由、导航条、选项卡等页面类信息

提示

static下目录的 js 文件不会被 webpack 编译，里面如果有 es6 的代码，不经过转换直接运行，在手机设备上会报错。

所以less、scss等资源同样不要放在 static目录下，建议这些公共的资源放在common目录下

（2）应用配置 manifest.json

manifest.json 文件是应用的配置文件，用于指定应用的名称、图标、权限等，我们也可以在这里为 Vue 为H5 设置跨域拦截处理器

（3）编译配置 vue.config.js

vue.config.js 是一个可选的配置文件，如果项目的根目录中存在这个文件，那么它会被自动加载，一般用于配置 webpack 等编译选项。官方文档

（4）全局配置 page.json

pages.json 文件用来对 uni-app 进行全局配置，决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar 等。它类似微信小程序中app.json的页面管理部分。

官方文档

| 属性 | 类型 | 必填 | 描述 |

| :-- | :-- | :-- | :-- |

（5）全局样式 uni.scss

uni.scss文件的用途是为了方便整体控制应用的风格。比如按钮颜色、边框风格，uni.scss文件里预置了一批scss变量预置。官方文档

uni-app 官方扩展插件（uni ui）及插件市场上很多三方插件均使用了这些样式变量，如果你是插件开发者，建议你使用 scss 预处理，并在插件代码中直接使用这些变量（无需 import 这个文件），方便用户通过搭积木的方式开发整体风格一致的App。

uni.scss是一个特殊文件，在代码中无需 import 这个文件即可在scss代码中使用这里的样式变量。uni-app的编译器在webpack配置中特殊处理了这个 uni.scss，使得每个 scss 文件都被注入这个uni.scss，达到全局可用的效果。如果开发者想要less、stylus的全局使用，需要在vue.config.js中自行配置webpack策略。

（6）主组件 App.vue

App.vue是uni-app的主组件，所有页面都是在App.vue下进行切换的，是页面入口文件。但App.vue本身不是页面，这里不能编写视图元素。

这个文件的作用包括：调用应用生命周期函数、配置全局样式、配置全局的存储globalData

应用生命周期仅可在App.vue中监听，在页面监听无效。

（7）入口文件 main.js

main.js是uni-app的入口文件，主要作用是初始化vue实例、定义全局组件、使用需要的插件如vuex。

官方文档

（8）UniAPP 开发规范及资源路径

开发规范约定

页面文件向导 Vue单文件组件（SFC）规范

组件标签靠近小程序规范，详见 uni-app 组件规范

互连能力（JS API）靠近微信小程序规范，但需要将替换替换 wx 为 uni ，详见uni-app接口规范

数据绑定及事件处理同 Vue.js 规范，同时补充了 App 和页面的生命周期

为兼容多端运行，建议使用 flex 布局进行开发

资源路径说明

template 内约会静态资源，如 image，video 等标签的 src 属性时，可以使用相对路径或绝对路径，形式如下：

注意

@ 初始的绝对路径以及相对路径会通过 base64 转换规则校验

约会的静态资源在非 h5 平台，均不转为 base64

H5平台，小于4kb的资源会被转换成base64，其余不转

js 文件或 script 标签内，可以使用相对路径和绝对路径，形式如下：

// 绝对路径，@指向项目根目录，在cli项目中@指向src目录

import add from ‘@/common/add.js’

// 相对路径

import add from ‘…/…/common/add.js’

css 文件或 style 标签内，可以使用相对路径和绝对路径，形式如下：

/* 绝对路径 */

@import url(‘/common/uni.css’);

@import url(‘@/common/uni.css’);

/* 相对路径 */

@import url(‘…/…/common/uni.css’);

css 文件或 style 标签内引用的图片路径，可以使用相对路径也可以使用绝对路径，形式如下：

/* 绝对路径 */

/* 相对路径 */

三、UniAPP 生命周期

学习一个工具的目的核心是什么？是为了解决核心业务逻辑问题，业务逻辑很多时候简单的解释一句话：“在合适的时机干合适的事情”，OK！什么是合适的时机呢？简单的说，页面运行过程中，各个阶段的回调函数就是页面中的时机，我们也叫这个为“生命周期钩子函数”，当然，业务中我们也会写到很多「回调」的逻辑，这些回调其实也是咱们自定义的时机，UniAPP 的生命周期钩子函数回调函数有哪些呢？我们来理解一下！

uni-app 完整支持 Vue 实例的生命周期，同时还新增应用生命周期及页面生命周期。

（1）应用生命周期

| 函数名 | 说明 |

| :-- | :-- |

| onLaunch | 当uni-app 初始化完成时触发（全局只触发一次） |

| onShow | 当 uni-app 启动，或从后台进入前台显示 |

| onHide | 当 uni-app 从前台进入后台 |

| onError | 当 uni-app 报错时触发 |

| onUniNViewMessage | 对 nvue 页面发送的数据进行监听，可参考 nvue 向 vue 通讯 |

| onUnhandledRejection | 对未处理的 Promise 拒绝事件监听函数（2.8.1+） |

| onPageNotFound | 页面不存在监听函数 |

| onThemeChange | 监听系统主题变化 |

（2）页面生命周期

| 函数名 | 说明 |

| :-- | :-- |

| onLoad | 监听页面加载，其参数为上个页面传递的数据，参数类型为Object（用于页面传参），参考示例 |

| onShow | 监听页面显示。页面每次出现在屏幕上都触发，包括从下级页面点返回露出当前页面 |

| onReady | 监听页面初次渲染完成。注意如果渲染速度快，会在页面进入动画完成前触发 |

| onHide | 监听页面隐藏 |

| onUnload | 监听页面卸载 |

| onResize | 监听窗口尺寸变化 |

| onPullDownRefresh | 监听用户下拉动作，一般用于下拉刷新，参考示例 |

| onReachBottom | 页面滚动到底部的事件（不是scroll-view滚到底），常用于下拉下一页数据。具体见下方注意事项 |

| onTabItemTap | 点击 tab 时触发，参数为Object，具体见下方注意事项 |

| onShareAppMessage | 用户点击右上角分享 |

| onPageScroll | 监听页面滚动，参数为Object |

| onNavigationBarButtonTap | 监听原生标题栏按钮点击事件，参数为Object |

| onBackPress | 监听页面返回 |

| onNavigationBarSearchInputChanged | 监听原生标题栏搜索输入框输入内容变化事件 |

| onNavigationBarSearchInputConfirmed | 监听原生标题栏搜索输入框搜索事件，用户点击软键盘上的“搜索”按钮时触发。 |

| onNavigationBarSearchInputClicked | 监听原生标题栏搜索输入框点击事件 |

| onShareTimeline | 监听用户点击右上角转发到朋友圈 |

| onAddToFavorites | 监听用户点击右上角收藏 |

四、UniAPP 路由配置及页面跳转

（1）路由配置

uni-app 页面路由全部交给框架统一管理，开发者需要在pages.json里配置每个路由页面的路径及页面样式（类似小程序在 app.json 中配置页面路由）。

“pages”: [

{

“path”: “pages/index”,

“style”: {

“navigationBarTitleText”: “路由配置”,

“navigationBarBackgroundColor”: “#FFFFFF”,

“navigationBarTextStyle”: “black”,

“backgroundColor”: “#FFFFFF”,

“enablePullDownRefresh”: true

}

{

“path”: “pages/user”,

“style”: {

“navigationBarTitleText”: “路由配置”,

“navigationBarBackgroundColor”: “#FFFFFF”,

“navigationBarTextStyle”: “black”,

“backgroundColor”: “#FFFFFF”,

“enablePullDownRefresh”: true

}

]

（2）路由跳转

uni-app 有两种页面路由跳转方式：使用navigator组件跳转（标签式导航）、调用API跳转（编程式导航）

框架以栈的形式管理当前所有页面，当发生路由切换的时候，页面栈的表现如下：

| 路由方式 | 页面栈表现 | 触发时机 |

| — | — | — |

| 初始化 | 新页面入栈 | uni-app 打开的第一个页面 |

| 打开新页面 | 新页面入栈 | 调用 API uni.navigateTo、

使用组件 <navigator open-type="navigate" /> |

| 页面重定向 | 当前页面出栈，新页面入栈 | 调用 API uni.redirectTo 、

使用组件 |

| 页面返回 | 页面不断出栈，直到目标返回页 | 调用 API uni.navigateBack 、

使用组件、

用户按左上角返回按钮、安卓用户点击物理back按键 |

| Tab 切换 | 页面全部出栈，只留下新的 Tab 页面 | 调用 API uni.switchTab 、

使用组件、

用户切换 Tab |

| 重加载 | 页面全部出栈，只留下新的页面 | 调用 API uni.reLaunch 、

使用组件 |

（3）获取当前页面栈

getCurrentPages() 函数用于获取当前页面栈的实例，以数组形式按栈的顺序给出，第一个元素为首页，最后一个元素为当前页面。

注意： getCurrentPages() 仅用于展示页面栈的情况，请勿修改页面栈，以免造成页面状态错误。

（4）路由传参与接收

说明：页面生命周期的 onLoad(）监听页面加载，其参数为上个页面传递的数据，如：

//页面跳转并传递参数

uni.navigateTo({

url: ‘page2?name=liy&message=Hello’

});

url为将要跳转的页面路径，路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔。如 ‘path?key1=value2&key2=value2’，path为下一个页面的路径，下一个页面的onLoad函数可得到传递的参数。

// 页面 2 接收参数

onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数

console.log(option.name); //打印出上个页面传递的参数。

console.log(option.message); //打印出上个页面传递的参数。

}

注意：url 有长度限制，太长的字符串会传递失败，并且不规范的字符格式也可能导致传递失败，所以对于复杂参数建议使用 encodeURI、decodeURI 进行处理后传递

（5）小程序路由分包配置

因小程序有体积和资源加载限制，各家小程序平台提供了分包方式，优化小程序的下载和启动速度。

所谓的主包，即放置默认启动页面及 TabBar 页面，而分包则是根据 pages.json 的配置进行划分。

在小程序启动时，默认会下载主包并启动主包内页面，当用户进入分包内某个页面时，会把对应分包自动下载下来，下载完成后再进行展示，此时终端界面会有等待提示。

“subPackages”: [

{

“root”: “news”,

“pages”: [{

“path”: “index”,

“style”: {

“navigationBarTitleText”: “新闻中心”,

“navigationBarBackgroundColor”: “#FFFFFF”,

“navigationBarTextStyle”: “black”,

“backgroundColor”: “#FFFFFF”

}

]

}

小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！
因此收集整理了一份《2024年Web前端开发全套学习资料》送给大家，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。