如何在导出 HTML 表格到 Excel 时更改文件名？-html教程-PHP中文网

如何在导出 HTML 表格到 Excel 时更改文件名？

霞舞

发布： 2025-09-14 21:41:23

原创

741人浏览过

如何在导出 html 表格到 excel 时更改文件名？

本文将介绍如何通过 JavaScript 修改将 HTML 表格导出为 Excel 文件时的默认文件名。我们将提供修改后的代码示例，并详细解释如何利用 <a> 标签的 download 属性来实现自定义文件名下载，从而避免文件总是以 "download.xls" 命名的困扰。

在 Web 开发中，经常需要将 HTML 表格导出为 Excel 文件。常见的实现方式是利用 data:application/vnd.ms-excel;base64 URI scheme 来模拟文件下载。然而，默认情况下，导出的文件名通常为 "download.xls"，这在实际应用中往往不够灵活。本文将详细介绍如何修改 JavaScript 代码，以便在导出 Excel 文件时自定义文件名。

修改 JavaScript 代码

核心在于使用 <a> 标签的 download 属性。该属性允许我们指定下载文件的名称。以下是修改后的 JavaScript 代码：

function tableToExcel(table, name) {
    var uri = 'data:application/vnd.ms-excel;base64,',
        template = '<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:x="urn:schemas-microsoft-com:office:excel" xmlns="http://www.w3.org/TR/REC-html40"><meta http-equiv="content-type" content="application/vnd.ms-excel; charset=UTF-8"><head><!--[if gte mso 9]><xml><x:ExcelWorkbook><x:ExcelWorksheets><x:ExcelWorksheet><x:Name>{worksheet}</x:Name><x:WorksheetOptions><x:DisplayGridlines/></x:WorksheetOptions></x:ExcelWorksheet></x:ExcelWorksheets></x:ExcelWorkbook></xml><![endif]--></head><body><table>{table}</table></body></html>',
        base64 = function(s) {
            return window.btoa(unescape(encodeURIComponent(s)))
        },
        format = function(s, c) {
            return s.replace(/{(\w+)}/g, function(m, p) {
                return c[p];
            })
        }
    if (!table.nodeType) table = document.getElementById(table)
    var ctx = {
        worksheet: name || 'Worksheet',
        table: table.innerHTML
    }
    var a = document.createElement('a');
    a.href = uri + base64(format(template, ctx));
    a.download = name + '.xls'; // 设置下载文件名
    a.click(); // 触发下载
}

登录后复制

代码解释：

创建 <a> 元素： var a = document.createElement('a'); 创建一个新的 <a> 元素，用于触发下载。
设置 href 属性： a.href = uri + base64(format(template, ctx)); 将 <a> 元素的 href 属性设置为包含 Excel 数据的 Data URI。
设置 download 属性： a.download = name + '.xls'; 这是关键的一步。download 属性指定了下载文件的名称。这里使用了传入的 name 参数，并追加了 .xls 扩展名。
触发 click 事件： a.click(); 模拟点击 <a> 元素，从而触发下载。

使用示例

假设你的 HTML 表格的 ID 为 "myTable"，并且你想将导出的 Excel 文件命名为 "SalesReport"。你可以这样调用 tableToExcel 函数：

图改改

在线修改图片文字

455

查看详情

立即学习“前端免费学习笔记（深入）”；

<button onclick="tableToExcel('myTable', 'SalesReport')">导出 Excel</button>

登录后复制

注意事项

浏览器兼容性： download 属性在现代浏览器中得到广泛支持，但在一些旧版本浏览器中可能存在兼容性问题。如果需要支持旧版本浏览器，可能需要使用 Flash 或其他第三方库。
文件名编码： 如果文件名包含特殊字符，可能需要进行 URL 编码，以确保文件名在所有浏览器中都能正确显示。
安全性： 虽然 Data URI scheme 是一种方便的导出方式，但需要注意其安全性。避免将敏感数据直接嵌入到 Data URI 中。