编程技术文章分享与教程

网站首页 > 技术文章 正文

在Vue项目中使用xlsx模块读写Excel文档内容

hmc789 2024-11-13 11:29:34 技术文章 1 ℃

前言

在前端项目开发中,读写Excel文件的需求变得越来越常见。以往,这些任务通常由后端处理,但随着前端技术的发展和浏览器功能的提升,JavaScript为我们提供了更多处理本地文件的能力。其中,FileReader对象是一个强大的工具,允许浏览器对用户本地文件进行操作。此外,一些技术大佬们贡献的工具类库如xlsx模块,进一步简化了在前端读取和解析Excel文件的过程。

在本文中,将详细介绍如何在Vue项目中利用FileReader对象和xlsx模块来读取Excel文件的内容。我将提供一系列步骤和示例代码,帮助大家了解如何在现代浏览器中处理Excel文件的读写操作。

首先,本文将简要介绍FileReader对象的基本概念和用法,说明如何使用它来读取用户选择的Excel文件。然后,我们将详细介绍xlsx模块的功能和用法,展示如何将读取到的Excel数据转换为可用的数据结构,以便在Vue项目中进行进一步的处理和展示。

不尽之处,欢迎评论区交流。

安装

npm install xlsx

# or

yarn add xlsx


FileReader 对象

FileReader对象是JavaScript中的内置对象,用于在Web应用程序中读取文件内容。它提供了一种异步方式来读取文件,而不需要将整个文件加载到内存中。

FileReader对象提供了几种方法和事件用于读取文件内容。下面是一些常用的方法和事件:

  • readAsText(file[, encoding]):以文本格式读取文件内容。可选参数encoding指定文件编码,默认为UTF-8。
  • readAsArrayBuffer(file):以二进制数据(ArrayBuffer)格式读取文件内容。
  • readAsDataURL(file):以DataURL格式读取文件内容,返回一个包含文件数据的URL。
  • abort():取消文件读取操作。
  • onload:文件读取成功时触发的事件。
  • onerror:文件读取错误时触发的事件。

使用FileReader对象读取文件的一般步骤如下:

  1. 创建一个新的FileReader对象:const reader = new FileReader();
  2. 为onload事件绑定一个处理函数,以在文件读取成功时执行操作:reader.onload = function(event) { // 处理文件内容 }
  3. 使用合适的方法(如readAsText()、readAsArrayBuffer()或readAsDataURL())读取文件内容:reader.readAsText(file)。
  4. 在onload事件处理函数中,可以通过event.target.result来获取读取到的文件内容。

FileReader对象为处理文件上传、图像预览、文件解析等场景提供了方便的功能,并且与其他Web API(如File API和XHR)结合使用,可以实现更多复杂的文件操作。

更多内容请查阅:FileReader MDN 官方文档

读取实例

下面是一个使用 xlsx 模块在Vue项目中读取本地Excel文件的综合实例。例子在页面上提供了一个文件选择表单来选择Excel文件,程序会使用FileReader对象和xlsx 模块对Excel内容进行读取和处理,并最终以表格的形式显示到页面上。

<template>
  <div>
    <input type="file" @change="handleFileSelect" accept=".xlsx, .xls" />
    <table>
      <thead>
        <tr>
          <th v-for="header in headers" :key="header">{{ header }}</th>
        </tr>
      </thead>
      <tbody>
        <tr v-for="row in rows" :key="row.index">
          <td v-for="cell in row.cells" :key="cell.column">{{ cell.value }}</td>
        </tr>
      </tbody>
    </table>
  </div>
</template>

<script>
import { read, utils } from 'xlsx';

export default {
  data() {
    return {
      headers: [],
      rows: [],
    };
  },
  methods: {
	// 选择文件
    handleFileSelect(event) {
      const file = event.target.files[0];
      const reader = new FileReader();
      // 处理文件内容
      reader.onload = (e) => {
        const data = new Uint8Array(e.target.result);
        const workbook = read(data, { type: 'array' });

        const worksheet = workbook.Sheets[workbook.SheetNames[0]];
        const jsonData = utils.sheet_to_json(worksheet, { header: 1 });
		
		// 提前文件内容
        this.headers = jsonData[0];
        this.rows = jsonData.slice(1).map((row, index) => ({
          index: index + 1,
          cells: row.map((cell, column) => ({
            column: column + 1,
            value: cell,
          })),
        }));
      };
	  // 读取文件内容
      reader.readAsArrayBuffer(file);
    },
  },
};
</script>


写入实例

下面的代码是使用 xlsx 模块在Excel中写入数据并导出Excel文件到本地的用例。第一步获取用户输入,第二步使用 xlsx 模块的 writeFile 方法写入内容并下载到本地。

<template>
  <div>
    <form @submit.prevent="saveExcel">
      <label for="name">姓名:</label>
      <input type="text" id="name" v-model="name" required>
      <br>
      <label for="sex">性别:</label>
      <input type="text" id="sex" v-model="sex" required>
      <br>
      <label for="age">年龄:</label>
      <input type="number" id="age" v-model="age" required>
      <br>
      <label for="dept">职位:</label>
      <input type="text" id="dept" v-model="dept" required>
      <br>
      <button type="submit">Save to Excel</button>
    </form>
  </div>
</template>

<script>
import { utils, writeFile } from 'xlsx';

export default {
  data() {
    return {
      name: '',
      age: null,
      sex: '',
      dept: '',
    };
  },
  methods: {
	// 保存excel
    saveExcel() {
      let data = []
      data.push(['姓名', '性别', '年龄', '职位'])
      data.push([this.name, this.sex, this.age, this.dept])
      // for (let i=0; i<10; i++) {
      //   data.push([(i + 1) + '', '学校A'])
      // }
      let WorkSheet = utils.aoa_to_sheet(data)
      let new_workbook = utils.book_new()
      utils.book_append_sheet(new_workbook, WorkSheet, '测试数据')
      writeFile(new_workbook, `测试数据.xlsx`)
    },
  },
};
</script>

<style scoped>
form {
  display: flex;
  flex-direction: column;
  align-items: flex-start;
  margin: 20px;
}
input {
  margin-bottom: 10px;
}
button {
  margin-top: 10px;
}
</style>


总结

本文介绍了如何在前端项目中利用FileReader对象和xlsx模块读取Excel文件的内容。首先,FileReader对象是一个内置对象,可以异步读取文件内容,并提供了几种方法和事件用于文件操作。然后,介绍了xlsx模块的功能和用法,展示了如何将读取到的Excel数据转换为可用的数据结构以及如何写入Excel内容并下载到本地。最后,给出了一个实例代码,演示了在Vue项目中如何读取本地Excel文件并展示到页面上。

通过本文的介绍和示例代码,大家可以了解到如何使用FileReader对象和xlsx模块来处理前端读取Excel文件的需求。这对于前端开发中处理Excel文件的场景非常有帮助,可以提升用户体验并简化开发流程。


作者:东方红杉
链接:https://juejin.cn/post/7340899332509679653

Tags:

标签列表
最新留言