Содержимое EJS-шаблонизатора

EJS (Express.js) — каркас веб-приложений для Node.js. В BILLmanager работа EJS реализована с помощью скрипта /usr/local/mgr5/etc/scripts/template_ejs.js. Для корректной работы шаблонизатора входящий XML-файл преобразуется в JSON. Шаблоны документов и сообщений в BILLmanager описываются с помощью языка EJS. Добавление и редактирование шаблонов выполняется в разделе Настройки → Шаблоны документов.

В EJS-шаблоне информация может быть представлена с помощью нескольких элементов:

блоки (разделы) форматирования;
таблицы;
списки;
ссылки на изображения.

Блоки форматирования

В коде шаблона блоки форматирования обозначаются тегами <div> </div>. Всё содержимое внутри этих тегов подчиняется единым параметрам форматирования. Как правило, форматирование задаётся с помощью классов стилей. Классы стилей могут быть определены в коде шаблона или во внешней таблице стилей. В BILLmanager роль внешней таблицы стилей выполняет базовый шаблон печати. Подробнее см. статью EJS-шаблоны документов.

Класс стиля для блока форматирования задаётся атрибутом class или id. В качестве значения атрибута указывается имя класса стиля.

Указание класса стиля

<div class="myStyle"> // К блоку применяется класс стиля "myStyle"
	Произвольное содержимое блока. 
</div>


<div id="anotherStyle"> // К блоку применяется класс стиля "anotherStyle". 
	Произвольное содержимое блока. 
</div>

XML

Пример использования

В шаблоне акта о выполненных работах наименование документа описано следующим блоком:

<!-- Header -->
    <div class="header">
		АКТ номер <%= invoice.number %> о выполнении работ, оказании услуг от <% rusdate(invoice.cdate) %>
	</div>
<!-- Header -->

XML

При этом в таблице стилей (базовый шаблон) класс header описан следующим кодом:

#bill-ru .header { font-size:14pt; font-weight:bold; padding-bottom:30px; text-align:center; }

XML

Таким образом, к тексту в блоке форматирования будут применены правила форматирования из класса "header", а именно: размер шрифта 14 пикселей, жирное начертание текста, поле снизу от текста 30 пикселей и выравнивание текста посередине.

Таблицы

В коде шаблона таблицы обозначаются тегами <table> </table>. Разметка таблицы на строки и ячейки выполняется с помощью тегов:

<tr> </tr> — определяют строку таблицы, размещаются внутри тегов <table> </table>.
<td> </td> — определяют ячейку таблицы, размещаются внутри тегов <tr> </tr>. Вместо <td> </td> допускается использовать теги <th> </th>. В таком случае текст внутри ячейки выравнивается по центру и получает жирное начертание.

Синтаксис описания таблицы

<table>
  <tr>
    <th>Заголовок 1</th>
    <th>Заголовок 2</th>
    <th>Заголовок 3</th>
  </tr>
  <tr>
    <td>Значение 1</td>
    <td>Значение 2</td>
    <td>Значение 3</td>
  </tr>
</table>

XML

В EJS-шаблонах поддерживаются стандартные HTML-теги и атрибуты таблиц. Также к таблицам можно применить класс стиля.

Пример использования

В шаблоне акта о выполненных работах таблица стоимости услуг описана следующим кодом:

<!-- Items -->
<table class="items">
   	<!-- Head -->
   	<tr>
   		<th style="text-align: left;">Выполненные работы, оказанные услуги</th>
   		<th style="width: 20%">Сумма</th>
   	</tr>
   	<!-- Head -->
   	<!-- Items -->
   	<% for (var i = 0; i < invoice.items.item.length; i++) { %>
   		<tr class="item">
   			<% if (((invoice.items.item[i].name).indexOf("Дополнительно", 0)) != -1) { %>
   				<td style="padding-left: 20px;">
   			<% } else { %>
   				<td>
   			<% } %>
   			<%= invoice.items.item[i].name %>
   			</td>
   			<td class="amount"><%= invoice.items.item[i].amount %></td>
   		</tr>
   	<% } %>
   	<!-- Items -->
</table>
<!-- Items -->

XML

На печатной форме документа таблица имеет вид:

Списки

Шаблонизатор поддерживает два типа списков: маркированный и нумерованный.

Маркированный список в коде шаблона обозначается тегами <ul> </ul>, каждый элемент списка заключается в теги <li> </li>. Тип маркера можно задать с помощью значения атрибута type — disc, circle или square:

<ul type="disc | circle | square">
	<li> Элемент списка 1 </li>
	<li> Элемент списка 2 </li>
	<li> Элемент списка 3 </li>
</ul>

XML

Нумерованный список в коде шаблона обозначается тегами <ol> </ol>, каждый элемент списка заключается в теги <li> </li>. Атрибут reversed определяет порядок нумерации списка. Тип нумерации списка можно задать с помощью значения атрибута type — 1, A, a, I, или i.

<ol type="1 | A | a | I | i" reversed start="10">
	<li> Элемент списка 1 </li>
	<li> Элемент списка 2 </li>
	<li> Элемент списка 3 </li>
</ol>

XML

Ссылки на изображения

Для добавления изображения в EJS-шаблон используется тег <img src=URL_изображения/>. Атрибуты width и height позволяют регулировать размер изображения в пикселях.

<img src="imageURL/image.png" width="100" height="75"/> //атрибут width регулирует ширину изображения, height отвечает за высоту.

XML

Пример использования

В шаблоне сообщения вставка аватара пользователя в письмо реализована следующим кодом:

<img src="https://<URL_BILLmanager>/manimg/userdata/avatar_files/<%= user.avatar_file %>"/>

XML