|
|
@ -63,6 +63,56 @@ |
|
|
|
- 模块化组织:按功能模块划分目录,便于维护和管理 |
|
|
|
- 组件复用:分包内的通用组件集中管理,提高代码复用性 |
|
|
|
|
|
|
|
|
|
|
|
## 配置文件说明 |
|
|
|
|
|
|
|
### config.js |
|
|
|
项目核心配置文件,包含以下配置: |
|
|
|
|
|
|
|
**1. 环境配置** |
|
|
|
```javascript |
|
|
|
// 当前环境 |
|
|
|
const type = 'prod' |
|
|
|
|
|
|
|
// 环境配置 |
|
|
|
const config = { |
|
|
|
dev: { |
|
|
|
baseUrl: 'http://h5.xzaiyp.top/jewelry-admin', |
|
|
|
}, |
|
|
|
prod: { |
|
|
|
baseUrl: 'https://jewelry-admin.hhlm1688.com/jewelry-admin', |
|
|
|
} |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
**2. 默认配置** |
|
|
|
```javascript |
|
|
|
const defaultConfig = { |
|
|
|
// 腾讯地图Key |
|
|
|
mapKey: 'XMBBZ-BCPCV-SXPPQ-5Y7MY-PHZXK-YFFVU', |
|
|
|
// 阿里云OSS配置 |
|
|
|
aliOss: { |
|
|
|
url: 'https://image.hhlm1688.com/', |
|
|
|
config: { |
|
|
|
region: 'oss-cn-guangzhou', |
|
|
|
accessKeyId: '***', |
|
|
|
accessKeySecret: '***', |
|
|
|
bucket: 'hanhaiimage', |
|
|
|
endpoint: 'oss-cn-shenzhen.aliyuncs.com', |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
**3. UI框架配置** |
|
|
|
```javascript |
|
|
|
uni.$uv.setConfig({ |
|
|
|
config: { |
|
|
|
unit: 'rpx' // 设置默认单位 |
|
|
|
}, |
|
|
|
}) |
|
|
|
``` |
|
|
|
|
|
|
|
## 核心模块详解 |
|
|
|
|
|
|
|
### 1. Mixins 混入 |
|
|
@ -185,6 +235,7 @@ this.$api('product.create', { |
|
|
|
- utils.js: 通用工具函数 |
|
|
|
- timeUtils.js: 时间处理 |
|
|
|
- position.js: 定位与位置计算 |
|
|
|
- oss-upload: 阿里云OSS上传模块 |
|
|
|
|
|
|
|
**使用示例:** |
|
|
|
```javascript |
|
|
@ -222,6 +273,97 @@ wxPay(orderData) |
|
|
|
</template> |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
#### 3.3 OSS上传模块 |
|
|
|
|
|
|
|
**配置说明:** |
|
|
|
项目使用阿里云OSS进行文件存储,相关配置位于config.js中: |
|
|
|
|
|
|
|
|
|
|
|
**使用示例:** |
|
|
|
|
|
|
|
1. 单文件上传 |
|
|
|
```javascript |
|
|
|
// 在组件中使用 |
|
|
|
export default { |
|
|
|
methods: { |
|
|
|
async onUpload(file) { |
|
|
|
try { |
|
|
|
const result = await this.$Oss.ossUpload(file) |
|
|
|
console.log('上传成功:', result.url) |
|
|
|
} catch (error) { |
|
|
|
console.error('上传失败:', error) |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
2. 多文件上传 |
|
|
|
```javascript |
|
|
|
// 在组件中使用 |
|
|
|
export default { |
|
|
|
methods: { |
|
|
|
onUploadMultiple(files) { |
|
|
|
files.forEach(file => { |
|
|
|
self.$Oss.ossUpload(file).then(url => { |
|
|
|
self.fileList.push({ |
|
|
|
url |
|
|
|
}) |
|
|
|
}) |
|
|
|
}) |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
3. 在uv-upload组件中使用 |
|
|
|
```html |
|
|
|
<template> |
|
|
|
<uv-upload |
|
|
|
:fileList="fileList" |
|
|
|
@afterRead="afterRead" |
|
|
|
@delete="deletePic" |
|
|
|
name="1" |
|
|
|
multiple |
|
|
|
:maxCount="maxCount" |
|
|
|
></uv-upload> |
|
|
|
</template> |
|
|
|
|
|
|
|
<script> |
|
|
|
export default { |
|
|
|
data() { |
|
|
|
return { |
|
|
|
fileList: [], |
|
|
|
maxCount: 9 |
|
|
|
} |
|
|
|
}, |
|
|
|
methods: { |
|
|
|
// 新增图片 |
|
|
|
deleteImage(e) { |
|
|
|
this.fileList.splice(e.index, 1) |
|
|
|
}, |
|
|
|
afterRead(e) { |
|
|
|
let self = this |
|
|
|
e.file.forEach(file => { |
|
|
|
self.$Oss.ossUpload(file.url).then(url => { |
|
|
|
self.fileList.push({ |
|
|
|
url |
|
|
|
}) |
|
|
|
}) |
|
|
|
}) |
|
|
|
}, |
|
|
|
} |
|
|
|
} |
|
|
|
</script> |
|
|
|
``` |
|
|
|
|
|
|
|
**注意事项:** |
|
|
|
1. 上传前请确保OSS配置正确 |
|
|
|
2. 建议对上传文件大小进行限制 |
|
|
|
3. 支持的文件类型:图片、视频、文档等 |
|
|
|
4. 上传失败时会抛出异常,请做好错误处理 |
|
|
|
|
|
|
|
## 最佳实践 |
|
|
|
|
|
|
|
### 1. 列表页面开发 |
|
|
@ -288,52 +430,3 @@ export default { |
|
|
|
- 检查mixinsListApi是否正确配置 |
|
|
|
- 确认网络请求是否正常 |
|
|
|
- 查看请求参数格式是否正确 |
|
|
|
|
|
|
|
## 配置文件说明 |
|
|
|
|
|
|
|
### config.js |
|
|
|
项目核心配置文件,包含以下配置: |
|
|
|
|
|
|
|
**1. 环境配置** |
|
|
|
```javascript |
|
|
|
// 当前环境 |
|
|
|
const type = 'prod' |
|
|
|
|
|
|
|
// 环境配置 |
|
|
|
const config = { |
|
|
|
dev: { |
|
|
|
baseUrl: 'http://h5.xzaiyp.top/jewelry-admin', |
|
|
|
}, |
|
|
|
prod: { |
|
|
|
baseUrl: 'https://jewelry-admin.hhlm1688.com/jewelry-admin', |
|
|
|
} |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
**2. 默认配置** |
|
|
|
```javascript |
|
|
|
const defaultConfig = { |
|
|
|
// 腾讯地图Key |
|
|
|
mapKey: 'XMBBZ-BCPCV-SXPPQ-5Y7MY-PHZXK-YFFVU', |
|
|
|
// 阿里云OSS配置 |
|
|
|
aliOss: { |
|
|
|
url: 'https://image.hhlm1688.com/', |
|
|
|
config: { |
|
|
|
region: 'oss-cn-guangzhou', |
|
|
|
accessKeyId: '***', |
|
|
|
accessKeySecret: '***', |
|
|
|
bucket: 'hanhaiimage', |
|
|
|
endpoint: 'oss-cn-shenzhen.aliyuncs.com', |
|
|
|
} |
|
|
|
}, |
|
|
|
} |
|
|
|
``` |
|
|
|
|
|
|
|
**3. UI框架配置** |
|
|
|
```javascript |
|
|
|
uni.$uv.setConfig({ |
|
|
|
config: { |
|
|
|
unit: 'rpx' // 设置默认单位 |
|
|
|
}, |
|
|
|
}) |
|
|
|
``` |