简介 #
SmartChart 提供 ds_download() 函数,允许用户将当前报表中的数据集数据一键下载为 CSV 或 Excel 文件。通过结合按钮点击事件,可以实现灵活的"按需下载"功能,支持下载当前查询结果(含筛选条件)。
应用场景: #
需要要下载数据集的数据到本地
使用方法 #
仅需要录活使用ds_download这个函数, 你可以开发出非常个性化的下载功能
ds_download(name, dataset,xls=0)
参数说明:
name: 文件名称
dataset: 可以是二维数组也可以是字符串
xls: 默认0为下载csv, 指定1为下载excel
样例: #
-
可在"模板" 中新建一个下载按钮并包裹拖拽容器, 指定button的ID,如id_down1, 拖拽到你需要的位置

-
在任意一个图形开发或js代码段中加入以下代码即可
$('#id_down1').click(()=>{
ds_download('报表数据.csv', dataset);
});
这样就可以实现点击按钮下载数据了
ds_download 函数说明 #
ds_download(name, dataset, xls=0)
| 参数 | 说明 |
|---|---|
name |
下载文件名,如 '报表数据.csv' 或 '数据.xlsx' |
dataset |
二维数组数据 或 字符串内容 |
xls |
0=下载 CSV(默认),1=下载 Excel(.xlsx) |
完整下载按钮示例 #
<!-- 模板 Body 中添加下载按钮 -->
<div class="smtdrag" id="id_down1">
<button>下载数据</button>
</div>
// 图形编辑器中或模板 JS 区
$('#id_down1').click(() => {
// dataset 为当前图形的数据集变量
ds_download('销售数据_' + new Date().format('yyyyMMdd') + '.xlsx', dataset, 1);
});