Skip to content

Commit

Permalink
docs(修改笔记): 新增部分uniapp笔记
Browse files Browse the repository at this point in the history
  • Loading branch information
emmmmmmmm committed Oct 7, 2023
1 parent f191fa8 commit 63fb0a9
Show file tree
Hide file tree
Showing 4 changed files with 76 additions and 3 deletions.
5 changes: 4 additions & 1 deletion docs/usage-diaries/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,7 @@

一波未平,一波又起。近月以来,可谓是多事之秋,说是多事,表面上来看却并非如此,实属内心事多也。很多时候,都是自己想的太过于多了,导致心疲力竭,身处当局者之中,久久出不来,无非就是如此。每每担心租房毁约,这就是打工人抑或是无房者的无奈;每每揪心于邻桌之举动却无法改变,这亦是打工人无奈之举,而情商举止或许亦占据了大部分。当今之时,听之诸人揪心于裁员等措施,自发的内心也跟着惶惶然不知所措,惴惴不安,而今下又听之于公司搬迁之举动,甚不安。每每这些因素,放在当下,夜晚深临之时,亦不免忧从中来,不自叹息。

常常忧心于当下之事,被琐事所烦扰,是一件很无奈之举,或许是性格因素,或许是先天所成,不管咋样,终究是一件亟需改进之事。
常常忧心于当下之事,被琐事所烦扰,是一件很无奈之举,或许是性格因素,或许是先天所成,不管咋样,终究是一件亟需改进之事。

注重自身,往往比注重周遭环境事物更加重要,然而,有的时候总是会被环境所影响,从而导致这一天惴惴不安,效率不高。所以,还是得要提升自我的承受能力。加油吧……在工位有感

67 changes: 66 additions & 1 deletion docs/usage-frame/uniapp/速记.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,30 @@
- 不推荐使用html标签,而是使用特定的基础组件+扩展组件(需导入)
- easycom规范:组件位于`/components|uni_modules/com-name/com-name.vue`时,就可直接在tempalte中使用

## 环境

### 注意事项

- 使用vue3/vite开发时,node版本需要使用`^14.18.0 || >=16.0.0`
- cli创建的项目是传统node项目结构,代码在src目录,编译器在项目目录下(非常占据磁盘内存,升级麻烦,兼容问题多),编译结果在dist目录;
- hbuilderx创建的项目,代码在项目目录下,编译器在hbuilderx目录下,编译结果在项目的unpackage目录下。
- cli创建的项目:
- 内置了d.ts,在支持该语法的开发工具中有语法提示
- 需手动升级编译器版本,拖入到hbuilderx开发时,不会跟随hbuilderx升级
- 拖入到hbuilderx开发时,整个项目拖入则使用项目下编译器,src目录拖入使用hbuilderx安装目录下plugin目录下的编译器
- 可使用npm
- 开发app时,仍然需要在hbuilderx运行,然后在其他编译器中修改
- hbuilderx创建的项目的好处:
- 能够让ide版本、编译器版本、uniapp运行时版本保持一致;
- 自动安装less、scss、ts;
- 不带d.ts,因为hbuilderx内置了uniapp语法提示库,若想将其在其他编译器中打开,需要先执行npm init,然后`npm i @dcloudio/types -D`补充d.ts
- 可使用npm
- 在hbuilderx(<3.6.7)运行vue3/vite创建的cli工程项目时,需要在hbuilder设置中设置上述版本的node路径
- 使用@dcloudio/uvm自动更新uniapp编译器的主要依赖,使用`npx @dcloudio/uvm@latest`更新到最新正式版,`npx @dcloudio/uvm@latest 3.2.0`更新到指定版本
- 打包时,使用`npm run build:xx`会在`/dist/build/xx`下生成对应的打包资源
- dev和build的区别:dev模式有sourcemap可进行断点调试,process.env.NODE_ENV值为development;build会将代码进行压缩体积更小,同时NODE_ENV值为production
- 跨端注意事项:https://uniapp.dcloud.net.cn/matter.html

## can i use

定义:判断应用的api、回调、参数、组件等是否在当前版本可用
Expand Down Expand Up @@ -47,6 +71,47 @@ uni.canIUse(${component}.${attribute}.${option})
- 保证条件编译前和编译后文件都应当能够通过语法校验
- ios和Android不支持通过条件编译来区分,需要调用`uni.getSystemInfo`获取平台信息

## 全局文件

### pages.json

作用:应用的全局配置文件,用于配置页面文件路径pages、窗口样式globalStyle、导航栏globalStyle、tabbar等。类似微信小程序app.json的页面管理

注意:
- topWindow、leftWindow、rightWindow属性用于适配宽屏的(上、左、右栏)

### manifest.json

作用:应用的配置文件,用于指定应用的名称、图标、权限

### App.vue/App.uvue

作用:
- 作为应用的入口文件,所有页面都是在该组件下进行切换的;
- 本身不是页面,不能编写视图元素,没有`<template>`标签,有`<script>`标签
- 是监听应用的生命周期的唯一方式(不能在页面中监听)、配置全局样式、配置全局的存储globalData

### main.js/uts

作用:
- 作为应用的入口文件,用于初始化vue示例
- 定义全局组件(一般情况下,easycom更常用且节省资源)
- 使用插件,例如vuex、i18n

注意:
- 谨慎在main.js、组件/页面的export default外部、onLaunch中编写代码,会影响启动速度;执行太早以至于很多功能和api无法使用;在应用存活时一直占据内存,不会随着页面关闭而回收

### uni.scss

作用:
- 全局可用,无需导入即可在scss代码中使用该文件中的样式变量
- 为了整体控制应用的风格,比如按钮颜色、边框等

## 宽屏适配方案

方案:
- 页面窗体级:使用pages.json下的direction-Window属性,适用于独立的页面
- 组件级:match-media组件,媒体查询组件,用于动态屏幕适配,在屏幕宽度满足查询条件时,显示对应组件

## 组件注意事项

Expand Down Expand Up @@ -134,7 +199,7 @@ uni.canIUse(${component}.${attribute}.${option})
- 小程序组件不是vue组件
- 每家小程序都有自己的组件规范
- 小程序组件不是全端可用的
- 代码存放目录在各自的目录中,比如App/微信`wxcomponents`,其他的类同
- 代码存放目录在各自的目录中,比如App/微信在`wxcomponents`,其他的类同

使用:在pages.json中需要使用小程序自定义组件的页面的style->usingComponents中引入组件(可使用条件选择环境),然后就能在该页面使用了

Expand Down
5 changes: 5 additions & 0 deletions docs/usage-other/vscode技巧.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# vscode技巧

## 快捷键设置

- 折叠所有代码块:`ctrl+k+0`
- 展开所有代码块:`ctrl+k+j`

## 插件推荐

- koroFileHeader,自动生成代码文件头注释,函数注释
Expand Down
Loading

0 comments on commit 63fb0a9

Please sign in to comment.