当前位置：首页 > article >正文

使用exceljs将excel文件转化为html预览最佳实践（完整源码）

article 2025/9/16 9:10:03

前言

在企业应用中，我们时常会遇到需要上传并展示 Excel 文件的需求，以实现文件内容的在线预览。经过一番探索与尝试，笔者最终借助 exceljs 这一库成功实现了该功能。本文将以 Vue 3 为例，演示如何实现该功能，代码示例可直接复制运行，希望能为大家在处理类似问题时提供新的思路和解决方案。

技术难点

基础单元格和合并单元格的混合处理

文字样式和背景样式的读取映射

富文本内容格式的处理

excel文件展示

实际实现预览效果

核心代码

exceljs提供了合并区域的数据，我们只需要根据合并区域去判断什么时候该合并，就能很好的实现基础单元格和合并单元格的混合绘制

  for (let merge of merges) {const [start, end] = merge.split(":");const startCell = worksheet.getCell(start);const endCell = worksheet.getCell(end);const startRow = startCell.row,startCol = startCell.col;const endRow = endCell.row,endCol = endCell.col;if (startRow === rowIndex && startCol === colIndex) {rowspan = endRow - startRow + 1;colspan = endCol - startCol + 1;isMerged = true;let styles = handleStyles(cell);allHtml += `<td rowspan="${rowspan}" colspan="${colspan}" style="${styles}">${handleValue(startCell.value)}</td>`;break;}if (rowIndex >= startRow &&rowIndex <= endRow &&colIndex >= startCol &&colIndex <= endCol) {isMerged = true;break;}}

完整源码

<template><div><el-uploadaction="":auto-upload="false":show-file-list="true":on-change="handleFileUpload"accept=".xlsx,.xls"><el-button type="primary"> 上传 Excel </el-button></el-upload><!-- 渲染 Excel 生成的 HTML 表格 --><div v-html="tableHtml" /></div>
</template><script setup>
import { ref } from "vue";
import * as ExcelJS from "exceljs";const tableHtml = ref(""); // 存储 HTML 表格内容
const themeColors = {0: "#FFFFFF", // 白色 √1: "#000000", // 黑色 √2: "#C9CDD1", // 灰色 √3: "#4874CB", // 蓝色 √4: "#D9E1F4", // 浅蓝 √5: "#F9CBAA", // 橙色 √6: "#F2BA02", // 浅橙 √7: "#00FF00", // 浅绿 √8: "#30C0B4", // 青色 √9: "#E54C5E", // 红色 √10: "#FFC7CE", // 浅红11: "#7030A0", // 紫色
};// 获取单元格颜色
const getCellColor = (cell) => {if (cell.fill && cell.fill.fgColor) {if (cell.fill.fgColor.argb) {return `#${cell.fill.fgColor.argb.substring(2)}`; // ARGB 转 RGB}if (cell.fill.fgColor.theme !== undefined) {return themeColors[cell.fill.fgColor.theme] || "#FFFFFF"; // 主题色转换}}return ""; // 无颜色
};
// 获取单元格字体颜色
const getCellFontColor = (cell) => {if (cell.font && cell.font.color && cell.font.color.argb) {return `#${cell.font.color.argb.substring(2)}`; // ARGB 转 RGB}if (cell.font && cell.font.color && cell.font.color.theme) {return themeColors[cell.font.color.theme] || "#000"; // 主题色转换}return "#000"; // 默认黑色
};
const handleStyles = (cell) => {let styles = [];// 读取字体颜色styles.push(`color: ${getCellFontColor(cell)}`);// 读取背景色styles.push(`background-color: ${getCellColor(cell)}`);// 加粗if (cell.font && cell.font.bold) {styles.push("font-weight: bold");}// 文字对齐if (cell.alignment) {if (cell.alignment.horizontal) {styles.push(`text-align: ${cell.alignment.horizontal}`);}if (cell.alignment.vertical) {styles.push(`vertical-align: ${cell.alignment.vertical}`);}}return styles.join("; ");
};// 处理上传的 Excel 文件
const handleFileUpload = async (file) => {const excelData = await readExcel(file.raw);tableHtml.value = excelData; // 更新 HTML 表格内容
};
// 处理常规单元格内容
const handleValueSimple = (value) => {if (value && typeof value === "object" && value.richText) {const valueStr = value.richText.reduce((acc, curr) => {let colorValue = "";if (curr.font && curr.font.color && curr.font.color.theme) {colorValue = getCellFontColor(curr) || `#000`;}if (curr.font && curr.font.color && curr.font.color.argb) {colorValue = `#${curr.font.color.argb.substring(2)}`;} else {colorValue = `#000`;}return acc + `<span style="color:${colorValue}">${curr.text}</span>`;}, "");return valueStr;}return value ? value : "";
};
// 处理合并单元格内容
const handleValue = (value) => {if (value && typeof value === "object" && value.richText) {const valueArr = value.richText.reduce((acc, curr) => {let colorValue = "";if (curr.font && curr.font.color && curr.font.color.argb) {colorValue = `#${curr.font.color.argb.substring(2)}`;} else {colorValue = `#000`;}const newData = curr.text.split(/\r/).map((item) => `<p style="color:${colorValue}">${item}</p>`);return acc.concat(newData);}, []);return valueArr.join("").replace(/\n/g, "<br />");}return value ? value : "";
};let worksheetIds = [];
// 读取 Excel 并转换成 HTML
const readExcel = async (file) => {const workbook = new ExcelJS.Workbook();const arrayBuffer = await file.arrayBuffer();const { worksheets } = await workbook.xlsx.load(arrayBuffer);worksheetIds = worksheets.map((v) => v.id); // 获取工作表 ID集合let allHtml = "";workbook.eachSheet(function (worksheet, sheetId) {// 处理合并单元格const merges = worksheet?.model?.merges || [];const currentSheetIndex = worksheetIds.indexOf(sheetId); // 获取当前工作表的索引allHtml +='<table border="1" style="border-collapse: collapse;width:100%;margin-bottom: 20px;">';worksheet.eachRow((row, rowIndex) => {allHtml += "<tr>";row.eachCell((cell, colIndex) => {let cellValue = cell.value || "";// 处理合并单元格let rowspan = 1,colspan = 1;let isMerged = false;for (let merge of merges) {const [start, end] = merge.split(":");const startCell = worksheet.getCell(start);const endCell = worksheet.getCell(end);const startRow = startCell.row,startCol = startCell.col;const endRow = endCell.row,endCol = endCell.col;if (startRow === rowIndex && startCol === colIndex) {rowspan = endRow - startRow + 1;colspan = endCol - startCol + 1;isMerged = true;let styles = handleStyles(cell);allHtml += `<td rowspan="${rowspan}" colspan="${colspan}" style="${styles}">${handleValue(startCell.value)}</td>`;break;}if (rowIndex >= startRow &&rowIndex <= endRow &&colIndex >= startCol &&colIndex <= endCol) {isMerged = true;break;}}if (!isMerged) {let styles = handleStyles(cell);// 生成 HTML 单元格allHtml += `<td ${rowspan > 1 ? `rowspan="${rowspan}"` : ""} ${colspan > 1 ? `colspan="${colspan}"` : ""} style="${styles}">${handleValueSimple(cellValue)}</td>`;}});allHtml += "</tr>";});allHtml += "</table>";});return allHtml;
};
</script>

拓展

exceljs这个库的作用是啥？

ExcelJS 是一个功能强大的库，用于读取、操作和写入 Excel 文件（.xlsx 和 .csv 格式）。它允许开发者通过编程方式处理 Excel 文档，包括创建新工作簿、添加数据、格式化单元格、插入图表等。这个库可以在服务器端（如 Node.js 环境）或客户端（如在浏览器中使用 Webpack 或 Rollup 等工具打包的 JavaScript 应用程序）使用。

主要特性

创建工作簿和工作表：可以轻松地创建新的 Excel 文件或修改已有的文件。
丰富的样式支持：支持字体、颜色、边框、对齐方式等多种样式设置。
数据处理：支持从各种数据源导入数据，并能将数据导出为 Excel 文件。
公式和计算：可以添加公式到单元格，并支持基本的 Excel 计算。
图表支持：能够在 Excel 文件中创建图表。
图片和绘图：支持向 Excel 文件中添加图片和绘制图形。

使用场景

ExcelJS 广泛应用于需要与 Excel 文件进行交互的应用程序开发中，比如：

数据报告生成
数据导入/导出功能实现
在线 Excel 编辑器

示例代码片段

这里是一个简单的示例，展示如何使用 ExcelJS 创建一个新的工作簿并添加一些数据：

const ExcelJS = require('exceljs');// 创建一个新的工作簿
let workbook = new ExcelJS.Workbook();
let worksheet = workbook.addWorksheet('测试工作表');// 添加一行数据
worksheet.addRow(['姓名', '年龄', '邮箱']);
worksheet.addRow(['张三', 28, 'zhangsan@example.com']);
worksheet.addRow(['李四', 23, 'lisi@example.com']);// 保存工作簿到文件
workbook.xlsx.writeFile('example.xlsx').then(() => {console.log('文件保存成功');});

这个例子展示了如何创建一个新的 Excel 文件，并向其中添加一些简单数据。ExcelJS 的灵活性和强大功能使其成为处理 Excel 文件的一个优秀选择。

npm上的puppeteer库是做什么的？

npm 上的 puppeteer 是一个用于自动化控制 Chrome/Chromium 浏览器的 Node.js 库，由 Google 团队开发。它通过提供高级 API，允许你以编程方式模拟用户在浏览器中的操作，适用于多种场景：

核心功能

无头浏览器控制
可启动 Headless 模式（无界面）或完整浏览器，执行自动化任务（如点击、输入、导航等）。

动态内容抓取
适用于爬取 JavaScript 渲染的页面（如 React/Vue 单页应用），传统爬虫工具难以直接获取动态内容。

生成截图与 PDF
精确截取网页全屏、指定区域，或将页面导出为 PDF（保留样式）。

自动化测试
模拟用户操作，测试网页功能（如表单提交、UI 交互），生成测试报告。

性能分析
监控页面加载速度、资源请求，优化性能。

典型使用场景

数据抓取：爬取电商价格、社交媒体内容等动态加载的数据。

自动化操作：自动填写表单、批量下载文件、定时签到等。

预渲染：为 SEO 生成静态化内容，解决 SPA 首屏加载问题。

生成报告：将数据可视化页面导出为 PDF 或图片存档。

基础示例

const puppeteer = require('puppeteer');(async () => {// 启动浏览器（默认 Headless 模式）const browser = await puppeteer.launch();const page = await browser.newPage();// 导航到目标页面await page.goto('https://example.com');// 截图并保存await page.screenshot({ path: 'example.png' });// 关闭浏览器await browser.close();
})();

安装与依赖

通过 npm 安装（会自动下载匹配的 Chromium）：

npm install puppeteer

优势

直接操控浏览器：行为更接近真实用户，绕过反爬虫机制（需合理使用）。

功能全面：支持网络请求拦截、Cookie 管理、模拟设备（如手机/平板）等。

社区活跃：丰富的文档和第三方工具（如 puppeteer-cluster 多任务优化）。

若你需要处理复杂的网页交互或动态内容，Puppeteer 是一个高效且灵活的选择。

vue中为什么切换动态组件需要使用shallowRef ？

在 Vue 3 中，使用 shallowRef 来管理动态组件的切换，主要是出于性能优化和避免不必要的深度响应式追踪的考虑。以下是详细解释：

1. ref vs shallowRef 的核心区别

会对其包裹的值进行深度响应式转换（递归将对象属性转为响应式）。

仅对值的引用变化进行响应式追踪，不会深度递归转换内部属性。

2. 动态组件的场景分析

当使用 <component :is="currentComponent"> 切换组件时：

组件对象本身是稳定的
动态组件的核心操作是替换整个组件对象（如 currentComponent.value = NewComponent），而不是修改组件对象的内部属性。

组件对象可能很大
一个组件对象（如导入的 Vue 组件）通常包含大量属性（如 props、methods、生命周期等），如果使用 ref 深度响应式化，会带来额外性能开销。

深度响应式可能导致问题
某些组件属性（如函数方法）被 Vue 代理后可能产生副作用（如破坏函数内部 this 绑定，或与第三方库预期结构冲突）。

3. 为什么 shallowRef 更合适？

性能优化
避免深度遍历组件对象的所有属性，减少不必要的响应式代理。

符合实际需求
动态组件切换只需要响应组件引用的变化（整体替换），无需关心组件内部属性的变化。

规避潜在问题
防止 Vue 对组件对象内部属性（如方法、生命周期钩子）的深度代理导致意外行为。

4. 示例对比
// 使用 ref（不推荐）import { ref } from 'vue';import HeavyComponent from './HeavyComponent.vue';const currentComponent = ref(HeavyComponent);// Vue 会深度代理 HeavyComponent 的所有属性，但实际只需要引用变化触发更新// 使用 shallowRef（推荐）import { shallowRef } from 'vue';const currentComponent = shallowRef(HeavyComponent);// 仅追踪 currentComponent.value 的引用变化，高效且安全
5. 官方建议

Vue 官方文档在动态组件示例中直接使用普通变量（非响应式），但在需要响应式时建议使用 shallowRef，明确表示：

“如果你确实需要响应性，可以使用 shallowRef。”

在动态组件切换场景中，shallowRef 通过避免深度响应式转换，在保证功能正确性的同时，提升了性能并规避了潜在问题。这正是它与 ref 的核心区别所在。

前言