Для форматированного вывода параметров используется тег var, который не содержит вложенной информации и не допускает вложенных тегов.

При форматировании параметра необходимо учитывать его тип.

Атрибуты тега var

НаименованиеТип данныхВозможные значенияОписаниеПримечания
nameстроковый
Наименование параметра
minwidthцелочисленный
Минимальная ширина текстового поляПо умолчанию равна длине строки
maxwidthцелочисленный
  • целое положительное число
  • all
Максимальная ширина текстового поля

При использовании значения all текст занимает все выделенное пространство в строке (значение по умолчанию)

При использовании целого положительного числа обязательным является указание атрибута minwidth
alignстроковый
  • left
  • center
  • right
Выравнивание текста. По левому краю, по центру, по правому краю
fillsymbolстроковый
Символ – заполнитель, который используется для заполнения свободного пространства при форматированииПо умолчанию используется пробел
paddingцелочисленный
Количество пробельных символов (символов заполнения) перед текстомИспользуется для оформления отступов
numberformatстроковый[флаги][ширина][.точность]

Формат представления чисел

  • флаги: +, 0,
  • ширина – общая ширина выводимой переменной,
  • точность – количество символов после запятой.
Используется для числовых параметров
dateformatстроковый
  • строка вида dd.mm.yyyy hh:mi:ss
  • целочисленное значение количества миллисекунд с 1 января 1970 года

Формат представления параметров типа дата, время, дата и время

  • dd – день,
  • d2 – день (без лидирующих нулей),
  • mm – месяц,
  • yyyy – год (4 цифры),
  • yy – год (2 цифры),
  • hh – час,
  • h2 – час (без лидирующих нулей),
  • mi – минуты,
  • ss – секунды.

Используется для параметров типа: дата, время, дата и время или целочисленных

nextlineстроковый
  • letter
  • word
Перенос текста на следующую строку. По словам, по символам
defaultvalueстроковый
Атрибут для хранения переменной, значение которой будет использовано, если не найдена переменная из атрибута name
searchстроковый
Регулярное выражение, по которому будет производиться поиск вхождений для замены

Используется, если переменная является строкой.

Значение не может быть пустым. Для замены необходимо наличие атрибута replace

Вместо управляющих символов необходимо указывать ASCII-код

replaceстроковый
Значение, на которое будут заменены найденные вхожденияДля замены необходимо наличие атрибута search
Пример использования тега var
<var name="price" numberformat=".2" />

Значение переменной price будет приведено к формату с точностью до двух знаков после запятой.

Пример использования тега var с атрибутом defaultvalue
<op var="zero" set="0.0"/>
<var name="moneyOperation.sum" defaultvalue="zero" numberformat=".2"/>

Если переменная moneyOperation.sum не будет найдена, то будет использовано значение переменной zero.

Пример использования тега var с атрибутами search и replace
<var name="moneyItemInfo.printImage" search="&#13;" replace=""/>

В значении переменной moneyItemInfo.printImage все символы возврата каретки ('\r') будут удалены. 

Пример использования тега var с печатью времени и даты
<var name="receipt.pay_time" align="right" fillsymbol=" " maxwidth="all" dateformat="dd.mm.yy hh:mi:ss"/><br/>

Значение переменной receipt.pay_time будет приведено к формату dd.mm.yyyy hh:mi:ss, выровнено по правому краю и будет занимать всю ширину строки. Свободное пространство будет заполнено пробелами.

Пример использования тега var при доступе к данным контейнера
<var name="entries[-5].data" align="left" maxwidth="all"/><br/>

При доступе к данным контейнера по индексу можно использовать отрицательный индекс. Благодаря этому доступ к элементам списка будет осуществляться с конца.

  • No labels