本文将介绍如何通过 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 函数：
立即学习“前端免费学习笔记（深入）”；
<button onclick="tableToExcel('myTable', 'SalesReport')">导出 Excel</button>
注意事项
- 浏览器兼容性： download 属性在现代浏览器中得到广泛支持，但在一些旧版本浏览器中可能存在兼容性问题。如果需要支持旧版本浏览器，可能需要使用 Flash 或其他第三方库。
- 文件名编码： 如果文件名包含特殊字符，可能需要进行 URL 编码，以确保文件名在所有浏览器中都能正确显示。
- 安全性： 虽然 Data URI scheme 是一种方便的导出方式，但需要注意其安全性。避免将敏感数据直接嵌入到 Data URI 中。
总结
通过使用 <a> 标签的 download 属性，我们可以轻松地在导出 HTML 表格到 Excel 文件时自定义文件名。这种方法简单易用，并且在大多数现代浏览器中都能正常工作。希望本文能够帮助你解决导出 Excel 文件时文件名的问题。
相关标签：
评论（已关闭）
评论已关闭