LAY-EXCEL: простой и быстрый плагин для экспорта

В существующих библиотеках фронтенда для экспорта есть мощная функция XLSX.JS, но она не очень удобна в использовании. Поэтому мы создали этот плагин, который не требует дополнительных зависимостей, поддерживает импорт через npm и загрузку через Layui-плагин. Для экспорта требуется всего одна команда.

Функция экспорта основана на XLSX.js, функция загрузки — на FileSaver, а функция чтения файлов — на H5 FileReader.

Демонстрация функции: http://excel.wj2015.com

Документация: http://excel.wj2015.com/_book/

Совместимость

Поддерживает IE10+, Firefox, Chrome и другие браузеры.

Внимание: совместимость с v1.7.2+ не поддерживается в IE9. Если вам необходимо использовать его в среде IE9, используйте версию 1.6.6.

Быстрый старт

Для быстрого экспорта достаточно одной команды. Подробные инструкции можно найти в разделе «Быстрый старт» 『快速上手』, а дополнительные удобные функции — в разделе «Список функций» 『函数列表』. Настройки стиля можно найти в разделе «Настройки стиля» 『样式设置专区』.

Способы использования проекта

Установка через npm

$ npm i lay-excel

Затем импортируйте с помощью import и вызовите функцию экспорта.

import LAY_EXCEL from 'lay-excel';
LAY_EXCEL.exportExcel([[1, 2, 3]], '表格导出.xlsx', 'xlsx')

Импорт через скрипт

<script src="layui_exts/excel.js"></script>
<script>
    LAY_EXCEL.exportExcel([[1, 2, 3]], '表格导出.xlsx', 'xlsx')
</script>

Загрузка через Layui-плагины

layui.config({
	base: 'layui_exts/', // 配置一个可访问地址
}).extend({
    excel: 'excel',
});
layui.use(['excel'], function (){
    layui.excel.exportExcel([[1, 2, 3]], '表格导出.xlsx', 'xlsx')
})

Зависимости от открытых проектов

Примечание: подробности о модификации js-xlsx для поддержки стилей см. в блоге: Личный блог JeffreyWang: Как сделать так, чтобы последняя версия JS-XLSX поддерживала стили.

Невыполненные требования

• Документация: создание Gitbook для удобства просмотра
• Документация: добавление страницы «Участие в разработке», чтобы помочь другим разработчикам начать работу с этим плагином
• Документация: добавление раздела «Часто задаваемые вопросы» для повышения эффективности обработки вопросов
• Совместимость: удаление зависимости от jQuery
• Совместимость: поддержка загрузки через npm, например, vue demo: lay-excel-vue
• Экспорт: экспорт изображений
• Совместимость: Поддержка IE11 (заблокировано)
• Тестирование: покрытие модульных тестов
• Тестирование: создание CI/CD механизма (сделано наполовину)
• Экспорт: рекурсивная функция для получения данных по частям
• Экспорт: сжатие и упаковка по частям
• Экспорт: более дружественные функции настройки стиля
• Импорт: импорт изображений (заблокирован)
• Импорт: оптимизация функций обработки импорта
• Совместимость: сборка и загрузка Vite
• Совместимость: время работы Firefox на 43 секунды медленнее, чем у Chrome (говорят, что это проблема совместимости браузера, которую не удалось воспроизвести снова)

Участие в разработке

Если у вас есть хорошие идеи или вы хотите реализовать некоторые из функций в списке «Невыполненные требования», пожалуйста, напишите на admin@wj2015.com, создайте проблему на GitHub или присоединитесь к группе 555056599 для обсуждения.

Если вы хотите внести свой вклад в код, пожалуйста, сначала прочитайте раздел «Участие в разработке» 『参与开发』.

Особая благодарность

Спасибо членам сообщества Layui за их использование и предложения, а также участникам группы за их отзывы и активные ответы на вопросы. Также большое спасибо Github за отправку ISSUE и PR.

Также большое спасибо Jetbrains за предоставление бесплатной лицензии IDE, которая очень полезна и мощна, https://www.jetbrains.com/?from=LAY-EXCEL.

Ссылки

Плагин Authtree, личный блог JeffreyWang.

Лицензия с открытым исходным кодом

LAY-EXCEL лицензирован в соответствии с Apache License, Version 2.0. Полный текст лицензии см. в LICENSE.