前端规范
优质
小牛编辑
128浏览
2023-12-01
前端规范
目的
旨在增强团队开发协作、提高代码质量和打造开发基石的编码规范,以下规范是团队基本约定的内容,必须严格遵循。
HTML 规范
基于 W3C 等官方文档,并结合团队业务和开发过程中总结的规范约定,让页面 HTML 代码更具语义性。
图片规范
了解各种图片格式特性,根据特性制定图片规范,包括但不限于图片的质量约定、图片引入方式、图片合并处理等,旨在从图片层面优化页面性能。
CSS 规范、命名规范
统一规范团队 CSS 代码书写风格和使用 CSS 预编译语言语法风格,提供常用媒体查询语句和浏览器私有属性引用,并从业务层面统一规范常用模块的引用。
JavaScript 规范
统一团队的 JS 语法风格和书写习惯,减少程序出错的概率,其中也包含了 ES6 的语法规范和最佳实践。
页面内部写 css 和 js
目前项目中支持页面底部写 css 和 js
前端工程启动
#### 第一次checkout工作,需要初始化
npm intall
#### 前端开发模式
npm run dev
#### 代码压缩混淆打包【注意index页面*js换成all.min.js】
npm run prod
#### 正式打包出问题时调试代码【css、js不压缩混淆】
npm run test
#### 清理dist目录(linux / mac)
npm run clean
#### 清理dist目录(Windows系统)
npm run cleanWin
项目结构
- doc 【文档】
- src 【前端工程源文件】
- css 【css 目录,通过 less 自动编译生成】
- images 【UI 相关图标和背景】
- js 【js 目录】
- biz.conf.js 【API 接口配制】
- biz.common.js 【公共业务方法】
- biz.user.js 【用户相关 js】
- biz.*.js 【其它业务模块 js 源文件】
- dwz/dwz.*.js 【前端框架相关 js】
- less 【css 源文件目录】
- base 【存放公共的样式表:一般不做改动】
- variables.less 【文字色号,文字层级大小,布局相关,边框样式,模糊背景等】
- content.less 【内容相关,内容文字标题等】
- footer.less 【页面底部元素,菜单等】
- header.less 【页面头部元素,头部标题栏等】
- icon.less 【各种图标】
- keyframes.less 【动画效果】
- latout.less 【grid 布局】
- normalize.less 【页面初始化】
- pages 【页面样式】
- common.less 【页面公共样式】
- my.less 【我的页面 css】
- *.less 【其它页面 css】
- widget 【组件样式(一般不做修改),目录:widegt】
- alert.less 【普通弹框类】
- calendar.less 【日期控件】
- chart.less 【图表】
- croppic.less 【用户头像裁剪】
- dialog.less 【自定义弹出框】
- dropdown.less 【下拉框】
- form.less 【input 框】
- list.less 【列表】
- map.less 【地图】
- navTab.less 【底部导航栏(云犁没用到)】
- panel.less 【各种面板】
- tab.less 【tab 样式】
- table.less 【table 表格】
- upload.less 【图片上传样式】
- ui.less 【所有页面的 less 通过@import 引入】
- base 【存放公共的样式表:一般不做改动】
- tpl 【html 页面模板】
- index.html 【前端页面入口文件】
- gulpfile.js 【gulp 配制】
- package.json 【前端工程配制文件】
命名规范
- 业务 js 文件 biz 开头,比如:biz.common.js, biz.user.js
- 命名尽量保持前端后端统一命名
css 使用 less 编译生成
- less 文件入口 src/less/ui.less
- 新加 less 文件都要在 ui.less 文件中 import 进来
- less 文件命名详见上面项目结构