5.0 KiB
5.0 KiB
project
介绍
{以下是 Gitee 平台说明,您可以替换此简介 Gitee 是 OSCHINA 推出的基于 Git 的代码托管平台(同时支持 SVN)。专为开发者提供稳定、高效、安全的云端软件开发协作平台 无论是个人1、团队、或是企业,都能够用 Gitee 实现代码托管、项目管理、协作开发。企业项目请看 https://gitee.com/enterprises}
目录说明
站点根目录
├─common //公共文件
├─api //api接口定义
├─css //公共css定义
└─js //公共js定义
├─components //uniapp组件目录
├─framework //自定义js框架
├─0-conf.js //项目请求地址配置
├─1-utils.js //工具js
├─2-url.js //获取当前页面路由地址
├─3-pro.js //uni系统相关api
├─4-queue.js //队列
├─5-pro-ext.js //页面跳转相关方法
├─6-event.js //事件监听
├─7-qiniu.js //七牛云js
├─8-cache.js //缓存方法
├─9-modal.js //AB页面传参
├─11-api.js //uni.request()方法封装
├─13-mixin //页面混入方法
├─14-device.js //调用uni系统震动
├─bootstrap.js //js入口文件
├─bridge.js //与原生交互
├─md5.js //md5加密
├─sign.js //签名
├─vConsole.js //控制台
├─pages //应用页面
├─home //个人中心
├─index //首页
├─news //新闻
├─public //公共页面(登录注册)
├─shop //商城页面
├─type //分类页面
├─web //项目外链
├─static //图片资源
├─store //vuex状态管理
├─unpackage //编译后目录
├─uview-ui //uview-ui插件依赖
├─app.vue //uni-app配置文件
├─main.js //vue入口js
├─manifest.json //uniapp项目配置文件
├─pages.json //页面路由配置页
├─uni.scss //uniapp内置的常用样式变量
项目说明
- 项目基于Vue-uniApp,使用uview框架。
安装教程
- 下载安装:「HBuildX」
- 将项目拖进【HBuildX】- 运行 - 运行到浏览器 - 完成
使用说明
- ui框架使用uviewui https://www.uviewui.com/js/intro.html
- 请求接口统一定义在common/index.js (使用方式uni.ajax(option)
- 状态管理 使用vuex模块(module)
- css布局采用flex布局(详见common/css/flex.css)
- 接口域名配置(framework/0-conf.js) const debug = true//true是本地代理配置false服务器环境 const proxyApi = "/api/" let baseUrl=""; uni.is_online = false; //false 为测试服 true正式服 if (uni.is_online) { //正式 baseUrl = debug ? proxyApi : 'http://mc.test.hmsc000111.com/' } else { // 测试 baseUrl = debug ? proxyApi : 'http://mc.test.hmsc000111.com/' }
开发规范
- 写注释要注意:写明代码的作用,重要的地方写注释
- js使用ES6语法
- 页面布局flex布局
- 减少页面代码体积,复杂,重复性代码应提取封装成组件引入
- 公共js函数统一封装在common/js目录下
- css统一使用scss
- 加载外链使用 page/web/index.vue
- 公共组件封装在根目录下 components 命名方式(ixxxxxx)
- 某个页面独享组件(封装在当前页面所在目录下components)
- 图片:除非特别要求图片必须高质量的显示,否则都应该进行对应的压缩处理
- 避免过多的if else判断
参与贡献
- Fork 本仓库
- 新建 Feat_xxx 分支
- 提交代码
- 新建 Pull Request
特技
- 使用 Readme_XXX.md 来支持不同的语言,例如 Readme_en.md, Readme_zh.md
- Gitee 官方博客 blog.gitee.com
- 你可以 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
- GVP 全称是 Gitee 最有价值开源项目,是综合评定出的优秀开源项目
- Gitee 官方提供的使用手册 https://gitee.com/help
- Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 https://gitee.com/gitee-stars/