load()

Описание

Загружает данные из внешнего файла

Использование

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

Параметры

• url - (обязательный) URL внешнего файла
• type - (необязательный) тип загружаемых данных: "json" (по умолчанию), "csv", "xlsx"

Возвращаемое значение

Метод возвращает промис загрузки данных

Пример

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");

Связанные примеры:

• Spreadsheet. Загрузка данных

• Spreadsheet. Загрузка CSV

• Spreadsheet. Импорт Xlsx

К сведению

Компонент выполняет AJAX-запрос и ожидает, что удалённый URL вернёт корректные данные.

Загрузка данных асинхронна, поэтому любой код, выполняемый после загрузки, необходимо оборачивать в промис:

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

Загрузка данных из Excel

Примечание

Компонент поддерживает импорт только из файлов Excel с расширением .xlsx.

DHTMLX Spreadsheet использует библиотеку Excel2Json на основе WebAssembly для импорта данных из 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

Полезная статья: Загрузка данных и экспорт