cloud-web-corejs 1.0.54-dev.551 → 1.0.54-dev.552

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.551",
+  "version": "1.0.54-dev.552",
   "scripts": {
     "dev": "vue-cli-service serve",
     "lint": "eslint --ext .js,.vue src",

package/src/components/luckysheet/README.md

@@ -0,0 +1,257 @@
+# Luckysheet Excel 导出功能改进说明
+
+## 主要改进内容
+
+### 1. 列宽处理优化
+- ✅ **自动列宽设置**: 根据原始数据的列宽配置自动设置Excel列宽
+- ✅ **默认列宽**: 当无配置时提供合理的默认列宽(15个字符宽度)
+- ✅ **宽度范围限制**: 列宽限制在8-100个字符范围内，避免过窄或过宽
+
+### 2. 样式处理增强
+- ✅ **字体映射优化**: 改进了中文字体到Excel字体的映射
+  - 微软雅黑 → Microsoft YaHei
+  - 宋体 → SimSun
+  - 黑体 → SimHei
+  - 楷体 → KaiTi
+  - 仿宋 → FangSong
+- ✅ **颜色处理**: 支持RGBA颜色格式，正确处理透明度
+- ✅ **字体大小限制**: 限制在8-72pt范围内
+- ✅ **数字格式支持**: 添加了完整的数字格式转换支持
+
+### 3. 工作表属性完善
+- ✅ **工作簿元数据**: 添加创建者、修改时间等信息
+- ✅ **工作表属性**: 设置默认行高、标签颜色等
+- ✅ **页面设置**: 配置A4纸张、纵向布局等打印属性
+- ✅ **MIME类型优化**: 使用标准的Excel MIME类型
+
+### 4. 性能和稳定性提升
+- ✅ **错误处理**: 添加了完善的错误处理机制
+- ✅ **内存管理**: 正确释放URL对象避免内存泄漏
+- ✅ **异步处理**: 使用Promise处理异步操作
+
+## API 接口说明
+
+### 主要导出函数
+
+#### 1. `exportExcel(luckysheet, fileName)`
+直接导出Excel文件并触发下载
+
+```javascript
+import { exportExcel } from './export'
+
+// 基础使用
+exportExcel(luckysheetData, '我的表格')
+```
+
+#### 2. `generateExcelBlob(luckysheet, fileName)`
+生成Blob对象，可用于自定义下载或其他处理
+
+```javascript
+import { generateExcelBlob } from './export'
+
+const blob = await generateExcelBlob(luckysheetData, '我的表格')
+// 可以对blob进行进一步处理
+```
+
+#### 3. `generateExcelFile(luckysheet, fileName)`
+生成File对象
+
+```javascript
+import { generateExcelFile } from './export'
+
+const file = await generateExcelFile(luckysheetData, '我的表格')
+```
+
+## 数据结构要求
+
+### 单个工作表数据结构
+
+```javascript
+const sheetData = {
+  name: '工作表名称',
+  data: [
+    // 第一行（标题行）
+    [
+      { v: '列1标题', ff: 1, fc: '#000000', bl: 1, fs: 12 },
+      { v: '列2标题', ff: 1, fc: '#000000', bl: 1, fs: 12 }
+    ],
+    // 数据行
+    [
+      { v: '数据1', ff: 0, fc: '#333333', fs: 10 },
+      { v: '数据2', ff: 0, fc: '#333333', fs: 10 }
+    ]
+  ],
+  config: {
+    merge: {},           // 合并单元格配置
+    borderInfo: [],      // 边框信息
+    columnlen: {         // 列宽配置
+      0: 100,            // 第1列宽度100px
+      1: 80              // 第2列宽度80px
+    },
+    rowlen: {            // 行高配置
+      0: 25,             // 第1行高度25px
+      1: 20              // 第2行高度20px
+    }
+  }
+}
+```
+
+### 多个工作表数据结构
+
+```javascript
+const multipleSheets = [
+  {
+    name: 'Sheet1',
+    data: [...],
+    config: {...}
+  },
+  {
+    name: 'Sheet2', 
+    data: [...],
+    config: {...}
+  }
+]
+```
+
+## 单元格属性说明
+
+| 属性 | 类型 | 说明 | 示例 |
+|------|------|------|------|
+| v | any | 单元格值 | `'文本'`, `123`, `true` |
+| ff | number/string | 字体 | `0`(微软雅黑), `'Arial'` |
+| fc | string | 字体颜色 | `'#FF0000'`, `'#FF000080'`(带透明度) |
+| fs | number | 字体大小 | `12` |
+| bl | number | 粗体 | `0`(正常), `1`(粗体) |
+| it | number | 斜体 | `0`(正常), `1`(斜体) |
+| ul | number | 下划线 | `0`(无), `1`(下划线) |
+| cl | number | 删除线 | `0`(无), `1`(删除线) |
+| bg | string | 背景色 | `'#FFFF00'` |
+| vt | number | 垂直对齐 | `0`(居中), `1`(顶部), `2`(底部) |
+| ht | number | 水平对齐 | `0`(居中), `1`(左对齐), `2`(右对齐) |
+| tb | number | 文本换行 | `0`(不换行), `2`(换行) |
+| tr | number | 文字旋转 | `0`(正常), `1`(45度), `2`(-45度) |
+| f | string | 公式 | `'SUM(A1:A10)'` |
+| ct | object | 内容类型 | `{fa: '0.00', s: [...]}` |
+
+## 使用示例
+
+### 1. 基础导出
+
+```javascript
+import { exportExcel } from './export'
+
+// 导出单个工作表
+exportExcel(singleSheetData, '员工信息表')
+
+// 导出多个工作表
+exportExcel(multipleSheetsData, '综合报表')
+```
+
+### 2. 带进度的自定义导出
+
+```javascript
+import { customExportExample } from './exportExample'
+
+customExportExample(
+  sheetData, 
+  '我的报表',
+  (progress, message) => {
+    console.log(`导出进度: ${progress}% - ${message}`)
+    // 更新UI进度条
+    updateProgressBar(progress)
+  }
+)
+```
+
+### 3. 获取Blob进行自定义处理
+
+```javascript
+import { generateExcelBlob } from './export'
+
+const blob = await generateExcelBlob(sheetData, '报表')
+// 上传到服务器
+await uploadToServer(blob)
+```
+
+## 常见问题解决
+
+### 1. 列宽显示不正确
+
+确保在config中正确设置columnlen：
+
+```javascript
+config: {
+  columnlen: {
+    0: 120,  // A列宽度120px
+    1: 80,   // B列宽度80px
+    2: 150   // C列宽度150px
+  }
+}
+```
+
+### 2. 中文字体显示异常
+
+使用标准的字体编号或名称：
+
+```javascript
+// 推荐使用编号
+{ ff: 0, v: '微软雅黑文本' }  // 最佳兼容性
+
+// 或使用标准字体名称
+{ ff: 'Microsoft YaHei', v: '中文文本' }
+```
+
+### 3. 颜色显示不正确
+
+确保颜色格式正确：
+
+```javascript
+// RGB格式
+{ fc: '#FF0000', bg: '#FFFF00' }
+
+// RGBA格式（带透明度）
+{ fc: '#FF000080', bg: '#FFFF00CC' }
+```
+
+### 4. 数字格式不生效
+
+在ct属性中指定数字格式：
+
+```javascript
+{
+  v: 1234.56,
+  ct: {
+    fa: '#,##0.00',  // 千分位格式
+    t: 'n'
+  }
+}
+```
+
+## 性能优化建议
+
+1. **大数据量处理**: 对于超过10000行的数据，建议分批导出
+2. **复杂样式**: 避免过度复杂的样式设置，影响导出性能
+3. **内存管理**: 及时清理不需要的Blob URL对象
+4. **并发控制**: 避免同时进行多个大型导出操作
+
+## 浏览器兼容性
+
+- ✅ Chrome 60+
+- ✅ Firefox 55+
+- ✅ Safari 12+
+- ✅ Edge 79+
+
+## 更新日志
+
+### v2.0.0 (当前版本)
+
+- 🎉 重构导出核心逻辑
+- 🎉 添加列宽自动设置功能
+- 🎉 完善样式处理和字体映射
+- 🎉 增强错误处理和性能优化
+- 🎉 添加详细的使用文档和示例
+
+### v1.0.0 (原版本)
+
+- 基础的Excel导出功能
+- 支持基本样式和合并单元格