跳到主要内容

load()

描述

从外部文件加载数据

用法

load(url: string, type?: string): promise;

参数

  • url - (必填)外部文件的 URL
  • type - (可选)要加载的数据类型:"json"(默认)、"csv"、"xlsx"

返回值

该方法返回一个数据加载的 Promise 对象

示例

const spreadsheet = new dhx.Spreadsheet("spreadsheet", {});
spreadsheet.parse(data);

// 以 JSON 格式加载数据(默认)
spreadsheet.load("../common/data.json");

// 以 CSV 格式加载数据
spreadsheet.load("../common/data.csv", "csv");

// 以 Excel 格式加载数据(仅支持 .xlsx)
spreadsheet.load("../common/data.xlsx", "xlsx");

相关示例:

信息

组件发出 AJAX 请求,并期望远程 URL 返回有效数据。

数据加载是异步的,因此需要将加载完成后的代码包装在 Promise 中:

spreadsheet.load("../some/data.json").then(function(){
spreadsheet.selection.add(123);
});

加载 Excel 数据

备注

请注意,该组件仅支持从扩展名为 .xlsx 的 Excel 文件导入。

DHTMLX Spreadsheet 使用基于 WebAssembly 的库 Excel2Json 从 Excel 导入数据。查看详情

加载 JSON 文件

您可以让用户通过文件浏览器将 JSON 文件加载到电子表格中。操作步骤如下:

  • 指定一个按钮,用于打开可选择 ".json" 文件的文件浏览器:
<section class="dhx_sample-controls">
<button class="dhx_sample-btn dhx_sample-btn--flat" onclick="json()">Import json</button>
</section>
  • 以两个参数调用 load() 方法:空字符串作为 URL,以及要加载的数据类型("json"):
const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
menu: true,
});

spreadsheet.parse(dataset);

function json() {
spreadsheet.load("", "json"); // 从 .json 文件加载数据
}

查看示例

更新日志: 通过文件浏览器加载 JSON 文件的功能已在 v4.3 中新增

相关文章: 数据加载与导出