数据下载

简介 #

SmartChart 提供 ds_download() 函数,允许用户将当前报表中的数据集数据一键下载为 CSV 或 Excel 文件。通过结合按钮点击事件,可以实现灵活的"按需下载"功能,支持下载当前查询结果(含筛选条件)。


应用场景: #

需要要下载数据集的数据到本地

使用方法 #

仅需要录活使用ds_download这个函数, 你可以开发出非常个性化的下载功能

ds_download(name, dataset,xls=0)
参数说明:
name: 文件名称
dataset: 可以是二维数组也可以是字符串
xls: 默认0为下载csv, 指定1为下载excel

样例: #

  1. 可在"模板" 中新建一个下载按钮并包裹拖拽容器, 指定button的ID,如id_down1, 拖拽到你需要的位置 输入图片说明

  2. 在任意一个图形开发或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);
});