1.uniapp基础

1.uniapp基础

官方文档：uni-app官网

1.1开发工具

（1）工具：

                HBuilderX HBuilderX-高效极客技巧

1.2 新建项目

（1）

        文件==》新建==项目

​

（2）选择相应的配置信息，填写项目根路径以及项目名称

​

1.3 项目结构

一个uni-app工程，默认包含如下目录及文件：

┌─uniCloud              云空间目录，阿里云为uniCloud-aliyun,腾讯云为uniCloud-tcb（详见uniCloud）
│─components            符合vue组件规范的uni-app组件目录
│  └─comp-a.vue         可复用的a组件
├─utssdk                存放uts文件
├─pages                 业务页面文件存放的目录
│  ├─index
│  │  └─index.vue       index页面
│  └─list
│     └─list.vue        list页面
├─static                存放应用引用的本地静态资源（如图片、视频等）的目录，注意：静态资源都应存放于此目录
├─uni_modules           存放[uni_module](/uni_modules)。
├─platforms             存放各平台专用页面的目录，详见
├─nativeplugins         App原生语言插件 详见
├─nativeResources       App端原生资源目录
│  ├─android            Android原生资源目录 详见
|  └─ios                iOS原生资源目录 详见
├─hybrid                App端存放本地html文件的目录，详见
├─wxcomponents          存放小程序组件的目录，详见
├─unpackage             非工程代码，一般存放运行或发行的编译结果
├─AndroidManifest.xml   Android原生应用清单文件 详见
├─Info.plist            iOS原生应用配置文件 详见
├─main.js               Vue初始化入口文件
├─App.vue               应用配置，用来配置App全局样式以及监听 应用生命周期
├─manifest.json         配置应用名称、appid、logo、版本等打包信息，详见
├─pages.json            配置页面路由、导航条、选项卡等页面类信息，详见
└─uni.scss              这里是uni-app内置的常用样式变量

1.4 项目运行

 配置文档： uniapp-hubildx配置-CSDN博客

该文档只有常用几个配置，其他配置请参考官方配置文档。

2 uniapp项目

2.1uniapp中的Vue

vue2-vue3全部文档：Vue2-Vue3学习笔记（全）-CSDN博客

（1）VUE核心文档：1.Vue核心-CSDN博客

（2）VUE组件化编程：2.VUE组件化编程-CSDN博客

（3）VUE脚手架：3.使用脚手架-CSDN博客

（4）VUE的AJAX：4.Vue中的AJAX-CSDN博客

（5）vuex的使用：5.vuex使用-CSDN博客

（6）VUE的路由：6.vue中的路由-CSDN博客

（7）VUE常用UI：7.Vue UI库-CSDN博客

（8）VUE3入门：Vue3入门-CSDN博客

uniapp中的view与html（vue）中的div用法一样。

        h5标签与小程序可能会不兼容，导致一些标签例如：h2，i等，在浏览器页面生效，但是小程序运行不生效。

        故使用常规vue写法写出的页面，只适配普通的手机浏览器页面，小程序等运行是可能会出现样式等等的问题。

2.2 页面配置与全局配置

2.2.1 新建文件

选择文件夹（pages）==》新建页面：

      A：文件名称（生成A.vue的文件）。

      B：勾选后会自动生成一个与A名称相同的文件夹，且文件在该文件夹下。

      C：C选择后会自动将A注册到pages.json中，无需手动添加。

2.2.2 pages.json

pages.json

    配置文件中注册的第一个页面为默认展示页面。

    navigationBarTitleText：页面展示最上方显示标题。

{"pages": [ //pages数组中第一项表示应用启动页，参考：https://uniapp.dcloud.io/collocation/pages{"path": "pages/index/index","style": {"navigationBarTitleText": "uni-app"}},{"path" : "pages/index/list/list","style" : {"navigationBarTitleText" : "新闻列表","navigationBarTextStyle":"#2a2c37"}}],"globalStyle": {"navigationBarTextStyle": "black","navigationBarTitleText": "uni-app","navigationBarBackgroundColor": "#F8F8F8","backgroundColor": "# "},"uniIdRouter": {}
}

2.2.3 stylePage

（1）在pages.json中可以进行一些基本配置，详细配置信息可以参考官网。

（2）pages.json的page数组中的某个对象的style属性配置只对该页面生效。

"pages": [ //pages数组中第一项表示应用启动页，参考：https://uniapp.dcloud.io/collocation/pages{{"path" : "pages/index/list/list","style" : {"navigationBarTitleText" : "新闻列表","navigationBarTextStyle":"#2a2c37"}],

（3）最下方的globalStyle配置对全局生效，但是之后再pages里的对象，未配置style属性时生效。

	"globalStyle": {"navigationBarTextStyle": "black","navigationBarTitleText": "uni-app","navigationBarBackgroundColor": "#F8F8F8","backgroundColor": "# "},

（4）uniapp官网提供的部分配置信息：

属性	类型	默认值	描述	平台差异说明
navigationBarBackgroundColor	HexColor	#F8F8F8	导航栏背景颜色（同状态栏背景色）	APP与H5为#F8F8F8，小程序平台请参考相应小程序文档
navigationBarTextStyle	String	black	导航栏标题颜色及状态栏前景颜色，仅支持 black/white
navigationBarTitleText	String		导航栏标题文字内容
navigationBarShadow	Object		导航栏阴影，配置参考下方 导航栏阴影	uni-app x 不支持
navigationStyle	String	default	导航栏样式，仅支持 default/custom。custom即取消默认的原生导航栏，需看使用注意	微信小程序 7.0+、百度小程序、H5、App（2.0.3+）
disableScroll	Boolean	false	设置为 true 则页面整体不能上下滚动（bounce效果），只在页面配置中有效，在globalStyle中设置无效	微信小程序（iOS）、百度小程序（iOS）
backgroundColor	HexColor	#ffffff	窗口的背景色	微信小程序、百度小程序、抖音小程序、飞书小程序、京东小程序
backgroundTextStyle	String	dark	下拉 loading 的样式，仅支持 dark/light	uni-app x 不支持
enablePullDownRefresh	Boolean	false	是否开启下拉刷新，详见页面生命周期。
onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面底部距离，单位只支持px，详见页面生命周期	uni-app x 不支持
backgroundColorTop	HexColor	#ffffff	顶部窗口的背景色（bounce回弹区域）	仅 iOS 平台
backgroundColorBottom	HexColor	#ffffff	底部窗口的背景色（bounce回弹区域）	仅 iOS 平台
disableSwipeBack	Boolean	false	是否禁用滑动返回	App-iOS（3.4.0+）
titleImage	String		导航栏图片地址（替换当前文字标题），支付宝小程序内必须使用https的图片链接地址	支付宝小程序、H5、App(uni-app x 不支持)
transparentTitle	String	none	导航栏透明设置。支持 always 一直透明 / auto 滑动自适应 / none 不透明	支付宝小程序、H5、APP(uni-app x 不支持)
titlePenetrate	String	NO	导航栏点击穿透	支付宝小程序、H5
app-plus	Object		设置编译到 App 平台的特定样式，配置项参考下方 app-plus	App
h5	Object		设置编译到 H5 平台的特定样式，配置项参考下方 H5	H5
mp-alipay	Object		设置编译到 mp-alipay 平台的特定样式，配置项参考下方 MP-ALIPAY	支付宝小程序
mp-weixin	Object		设置编译到 mp-weixin 平台的特定样式	微信小程序
mp-baidu	Object		设置编译到 mp-baidu 平台的特定样式	百度小程序
mp-toutiao	Object		设置编译到 mp-toutiao 平台的特定样式	抖音小程序
mp-lark	Object		设置编译到 mp-lark 平台的特定样式	飞书小程序
mp-qq	Object		设置编译到 mp-qq 平台的特定样式	QQ小程序
mp-kuaishou	Object		设置编译到 mp-kuaishou 平台的特定样式	快手小程序
mp-jd	Object		设置编译到 mp-jd 平台的特定样式	京东小程序
usingComponents	Object		引用小程序组件，参考 小程序组件	App(uni-app x 不支持)、微信小程序、支付宝小程序、百度小程序、京东小程序
leftWindow	Boolean	true	当存在 leftWindow时，当前页面是否显示 leftWindow	H5
topWindow	Boolean	true	当存在 topWindow 时，当前页面是否显示 topWindow	H5
rightWindow	Boolean	true	当存在 rightWindow时，当前页面是否显示 rightWindow	H5
maxWidth	Number		单位px，当浏览器可见区域宽度大于maxWidth时，两侧留白，当小于等于maxWidth时，页面铺满；不同页面支持配置不同的maxWidth；maxWidth = leftWindow(可选)+page(页面主体)+rightWindow(可选)	H5（2.9.9+）

2.3 uniapp中的组件

 小程序API：微信开放文档

        与uniappAPI基本一致。

2.4 px与rpx

1. px：

   • px 是像素（Pixel）的缩写，是一个相对固定的单位。
   • 在不同的设备上，1px 所代表的实际物理长度是不同的，因为不同设备的屏幕分辨率不同。在高分辨率屏幕上，1px 可能会显得更小。
   • px 常用于网页开发和其他不需要考虑设备屏幕尺寸差异的应用中。

2. rpx：

   • rpx 是一种响应式的单位，主要用于微信小程序以及其他需要适应不同屏幕尺寸的应用程序。
   • 微信小程序将屏幕划分为 750rpx 的宽度，这样可以保证在不同设备上显示的一致性。
   • 使用 rpx 的好处是可以根据屏幕实际宽度进行自适应布局，无需为不同设备编写不同的样式代码。
   • 转换关系：假设屏幕宽度为 W，则 1rpx = W / 750px。例如，在 iPhone6s 上，屏幕宽度为 375px，那么 1rpx = 375px / 750 = 0.5px。

3 Vue与小程序生命周期

 Vue生命周期请参考:1.Vue核心-CSDN博客

应用生命周期

1. onLaunch：当小程序启动时触发，全局只会触发一次。
2. onShow：当小程序从前台进入后台再返回前台时触发。
3. onHide：当小程序从前台进入后台时触发。
4. onError：当小程序发生错误时触发。

        这些函数是在app.js文件中定义的，通过App(Object)函数注册一个小程序，并指定其生命周期回调。

页面生命周期

        页面生命周期则是针对小程序中的每个页面，包括以下几个回调函数：

1. onLoad：页面加载时触发，会传入页面参数。
2. onReady：页面初次渲染完成时触发。
3. onShow：页面显示/切入前台时触发。
4. onHide：页面隐藏/切入后台时触发。
5. onUnload：页面卸载时触发。

组件生命周期

1. created：在组件被创建后立即执行，此时组件视图还未添加到页面中。通常可以在这个函数中初始化一些数据和变量。

2. attached：在组件完全初始化完毕、进入页面节点树后触发。这个生命周期可以做一些异步请求、数据更新等操作。

3. ready：当组件及其所有子组件都准备就绪时触发，代表组件渲染完成并显示在界面上。

4. moved：如果组件在一个已有的节点树内移动位置，则会触发此生命周期。

5. detached：在组件离开页面节点树后触发。退出一个页面时，如果组件还在页面节点树中，则 detached 会被触发。