🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
## 代码书写规范 命名: 1.组件名以hy开头,单词以-隔开,首个class可以与组件名同名,如开发以下组件 ![](https://img.kancloud.cn/b6/4f/b64fc193c1feb5454794eb9e25e5b239_733x227.png) ![](https://img.kancloud.cn/ae/cc/aecca0fab89a919f7aeea34aeb8bfdc6_992x340.png) 2. 变量,函数用驼峰命名法 3. css命名用 ‘-’命名法,且每个组件必须加scoped, <style scoped></style> 注释:组件内显眼位置须有组件中文名,功能介绍,参数等注释,让使用者一目了然。 每个变量,函数或方法,状态等都要书写详细注释 对代码逻辑较为复杂的地方也应该书写注释 md文件:组件说明,作者,组件功能,说明文档 css:采用弹性布局flex,不用float布局 单位:都统一用px,值-设计图是多少便写多少 预处理器:scss,在style标签中加入lang='scss' ***** ## 公共组件 每个页面都应用由单个或多个公共组件组成,数据驱动型组件应用与外界无关,仅通过porps接收,$emit发送数据。 组件内不调用接口,不接收,变更全局变量,状态管理,以解耦页面之前的关系 组件内部变量,方法,函数自产自消 公共组件可引用公共组件或公共工具类 公共组件应尽量预留slot 项目主要使用vant(H5端), element-ui(PC端)组件库,绝大多情况下应使用并将这两个组件库的组件封装成自己的组件 ***** ## 业务组件 业务组件主要是做页面布局,调用公共组件,调用接口,管理状态等,具体实现放至公共组件中实现。 业务组件需要将接口调用单独提取到INTERFACE.js文件中,INTERFACE.js文件获取并处理数据再返回到页面中 ***** ## 写状态 步骤: - 在store/modules目录下创建对应页面的状态文件 - 状态在store/getters.js中注册,可通过this.$store.getters.状态名 形式取状态 - 如果状态不在getters.js中注册,可通过this.$store.目录.状态名 形式取状态 ***** ## 调用接口 调用后台接口步骤: - 在/api/api-map/list下对应分包下创建对应页面的接口文件或目录 - 在创建的接口文件中写下接口地址,以key: value形式书写,可参考之前写的 - 在相应页面的目录下创建INTERFACE.js,用于调用和处理接口数据 - 在页面引用INTERFACE.js,调用接口