React+Ant Design前端實現(xiàn)讀取與導出Excel文件
一、前言
在實際業(yè)務場景中,我們經(jīng)常需要處理 Excel 文件的導入導出。無論是數(shù)據(jù)填報、報表生成還是數(shù)據(jù)分析,Excel 作為一種廣泛使用的電子表格格式,與前端應用的結合愈發(fā)緊密。本文將以 React + Ant Design 項目為例,演示如何通過 xlsx 庫實現(xiàn)以下功能:
- 讀取本地 XLSX 文件并解析為表格數(shù)據(jù)
- 將表格數(shù)據(jù)導出為 XLSX 文件
二、技術棧
React: 構建用戶界面,憑借其高效的渲染機制和豐富的生態(tài)系統(tǒng),成為現(xiàn)代 Web 開發(fā)的熱門選擇。
Ant Design: UI 組件庫,提供了一套美觀且易用的 UI 組件,大大加快了開發(fā)速度。
xlsx (SheetJS): Excel 文件處理庫,功能強大,支持多種 Excel 操作,如讀寫、格式化等。
三、準備工作
1. 創(chuàng)建React項目
npx create-react-app antd-xlsx --template typescript cd antd-xlsx
此命令會創(chuàng)建一個基于 TypeScript 的 React 項目,并為后續(xù)開發(fā)做好準備。
2. 安裝依賴
npm install antd @ant-design/icons xlsx
安裝所需的依賴包,包括 Ant Design 組件庫、圖標庫以及用于處理 Excel 文件的 xlsx 庫。
3. 目錄結構
src/
├── components/
│ └── XlsxHandler.tsx
├── App.tsx
├── index.tsx
合理的目錄結構有助于項目的組織和維護。
四、核心實現(xiàn)
1. 文件讀取模塊
import React, { useState } from 'react';
import { Upload, Table, Button } from 'antd';
import * as XLSX from 'xlsx';
import { InboxOutlined } from '@ant-design/icons';
const XlsxHandler = () => {
const [dataSource, setDataSource] = useState<any[]>([]);
const [headers, setHeaders] = useState<string[]>([]);
// 文件讀取處理
const handleFileChange = (info: any) => {
const file = info.file;
if (!file) return;
// 校驗文件類型
const isXlsx = file.name.endsWith('.xlsx') || file.name.endsWith('.xls');
if (!isXlsx) {
info.status = 'error';
info.response = '請選擇正確的Excel文件';
return;
}
const reader = new FileReader();
reader.onload = (e: any) => {
const binaryStr = e.target.result;
const workbook = XLSX.read(binaryStr, { type: 'binary' });
const firstSheetName = workbook.SheetNames[0];
const sheet = workbook.Sheets[firstSheetName];
// 提取表頭
const jsonData = XLSX.utils.sheet_to_json(sheet);
if (jsonData.length > 0) {
setHeaders(Object.keys(jsonData[0]))
setDataSource(jsonData);
}
};
reader.readAsBinaryString(file);
};
// 數(shù)據(jù)導出功能
const exportToExcel = () => {
const ws = XLSX.utils.json_to_sheet(dataSource);
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, 'ExportedData');
XLSX.writeFile(wb, `export_${Date.now()}.xlsx`);
};
return (
<div style={{ padding: 20 }}>
<Upload
beforeUpload={handleFileChange}
showUploadList={false}
maxCount={1}
accept=".xlsx,.xls"
>
<Button icon={<InboxOutlined />}>選擇Excel文件</Button>
</Upload>
{headers.length > 0 && (
<Table
dataSource={dataSource}
rowKey="id"
pagination={{ pageSize: 10 }}
style={{ marginTop: 20 }}
>
{headers.map((header) => (
<Table.Column key={header} title={header} dataIndex={header} />
))}
</Table>
)}
<Button
type="primary"
onClick={exportToExcel}
disabled={!headers.length}
style={{ marginTop: 20 }}
icon={<DownloadOutlined />}
>
導出當前數(shù)據(jù)
</Button>
</div>
);
};
export default XlsxHandler;
2. 主應用集成
import React from 'react';
import './App.css';
import { ConfigProvider } from 'antd';
import XlsxHandler from './components/XlsxHandler';
import { DownloadOutlined } from '@ant-design/icons';
function App() {
return (
<ConfigProvider>
<div className="App">
<h1>Excel文件處理示例</h1>
<XlsxHandler />
</div>
</ConfigProvider>
);
}
export default App;
五、技術要點解析
1. 文件讀取流程
- 使用HTML5的File API獲取文件對象
- 通過FileReader讀取二進制內(nèi)容
- 使用SheetJS解析二進制流生成工作簿
- 提取第一個工作表的數(shù)據(jù)
- 轉(zhuǎn)換為JSON格式渲染表格
2. 數(shù)據(jù)導出流程
- 將JSON數(shù)據(jù)轉(zhuǎn)換為工作表
- 創(chuàng)建新的工作簿并添加工作表
- 使用writeFile方法生成Excel文件
3. 關鍵技術點
- 二進制處理:必須使用
readAsBinaryString方法讀取文件 - 鍵值映射:JSON字段名對應Excel列名
- 類型校驗:嚴格校驗文件擴展名防止格式錯誤
- 內(nèi)存優(yōu)化:及時釋放FileReader實例避免內(nèi)存泄漏
到此這篇關于React+Ant Design前端實現(xiàn)讀取與導出Excel文件的文章就介紹到這了,更多相關React讀取與導出Excel內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
ReactQuery系列之數(shù)據(jù)轉(zhuǎn)換示例詳解
這篇文章主要為大家介紹了ReactQuery系列之數(shù)據(jù)轉(zhuǎn)換示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-11-11
react搭建在線編輯html的站點通過引入grapes實現(xiàn)在線拖拉拽編輯html
Grapes插件是一種用于Web開發(fā)的開源工具,可以幫助用戶快速創(chuàng)建動態(tài)和交互式的網(wǎng)頁元素,它還支持多語言和多瀏覽器,適合開發(fā)響應式網(wǎng)頁和移動應用程序,這篇文章主要介紹了react搭建在線編輯html的站點通過引入grapes實現(xiàn)在線拖拉拽編輯html,需要的朋友可以參考下2023-08-08
react.js使用webpack搭配環(huán)境的入門教程
本文主要介紹了react 使用webpack搭配環(huán)境的入門教程,具有一定的參考價值,感興趣的小伙伴們可以參考一下。2017-08-08
使用react+redux實現(xiàn)計數(shù)器功能及遇到問題
使用redux管理數(shù)據(jù),由于Store獨立于組件,使得數(shù)據(jù)管理獨立于組件,解決了組件之間傳遞數(shù)據(jù)困難的問題,非常好用,今天重點給大家介紹使用react+redux實現(xiàn)計數(shù)器功能及遇到問題,感興趣的朋友參考下吧2021-06-06

