Skip to content

Latest commit

 

History

History
118 lines (90 loc) · 5.46 KB

README.ru.md

File metadata and controls

118 lines (90 loc) · 5.46 KB
Raw

Excel шаблонизатор

Description

Этот пакет расширяет функциональность другой библиотеки, позволяя получать шаблон типа Buffer Original Library: https://github.com/optimistex/xlsx-template-ex

Документация доступна на языках:

  1. English
  2. Русский

Совместимые файлы: xlsx

Данный компонент реализует создание отчетов на основе шаблона. Он имеет гибкий синтаксис, подобный шаблонным выражениям в Angular.

Синтаксис

Поддерживаются 2 типа выражений:

  • Вывод значения: {{value|pipe:arg1:argN}}
  • Вывод массива: [[value|pipe:arg1:argN]]

Где:

  • value - имя свйства которое содержит некоторое значение или массив
  • pipe - некоторая функция дополнительной обработки значения
  • arg1, argN - аргументы/параметры передаваемые в функцию

Реализованные варианты выражений

  • {{propertyName}} - вывод значения как есть

  • {{propertyName|date}} - выводимое значение будет отформатировано как дата

  • {{fileName|image}} - поиск файла изображения по имени файла. Если изображение найдено, то оно встраивается в ячейку таблицы.

  • {{propertyArrayName|find:propertyName:propertyValue}} - поиск значения в массиве propertyArrayName который содержит свойство propertyName равное propertyValue

  • {{propertyObjectName|get:propertyName}} - возвращает значение свойства propertyArrayName объекта propertyObjectName

  • [[array|repeat-rows:3]] - обработка массива значений и вывод содержимого в секцию из 3 строк начиная с текущей. Строки будут продублированы в соответствии с размером массива.

  • [[array|filter:propertyName:checkValue]] - фильтр массива. Если предоставлено только propertyName, тогда получим массив объектов содержащих это свойство. Если предоставлено propertyName и checkValue, тогда получим массив объектов которые содержат свойство propertyName со значением checkValue.

  • [[array|tile:blockRows:blockColumns:tileColumns]] - обработка массива значений и вывод по блокам. Исходный блок определяется по blockRows и blockColumns. Данный блок будет выведен в таблице из tileColumns колонок.

Примеры

Будем выводить такие данные:

let data = {
    reportBuildDate: 1526443275041,

    results: [
        { text: 'some text 1', answerText: 'a text of an answer 1'},
        { text: 'some text 2', answerText: 'a text of an answer 2'},
        { text: 'some text 3', answerText: 'a text of an answer 3'},
        { answerText: 'a text of an answer 3'},
    ],
};

Давайте сделаем шаблон:

!!! В данном примере / использовано вместо | из-за проблемы с синтаксисом Markdown

A B
{{reportBuildDate/date}} {{results/find:text:some text 2/get:answerText}}
[[results/filter:text/repeat-rows:1]] {{text}} {{answerText}}
[[results/filter:text/tile:1:1:2]]{{answerText}}

Получим результат:

A B
16.05.2018 a text of an answer 2
some text 1 a text of an answer 1
some text 2 a text of an answer 2
some text 3 a text of an answer 3
a text of an answer 1 a text of an answer 2
a text of an answer 3

Начало работы

const fs = require("fs");
const XlsxTemplate = require('xlsx-template-ex');

const data = {
    reportBuildDate: 1526443275041,

    results: [
        { text: 'some text 1', answerText: 'a text of an answer 1'},
        { text: 'some text 2', answerText: 'a text of an answer 2'},
        { text: 'some text 3', answerText: 'a text of an answer 3'},
        { answerText: 'a text of an answer 3'},
    ],
};

XlsxTemplate.xlsxBuildByTemplate(data, 'template-file.xlsx')
    .then((buffer) => fs.writeFileSync('./out.xlsx', buffer))
    .catch((error) => console.log('xlsxHelper error:', error));

Поддержка

  • npm start - Запуск демо из сборки для релиза.
  • npm run start-dev - Запуск демо в режиме разработки.
  • npm run build - Сборка для релиза.

Лицензия

Свободное использование (подробнее Лицензия в полнотекстовом файле)