Логотип Tagix
Изображение Изображение

← Назад

tgx:append#

Добавляет значение в массив runtime-переменной.

Синтаксис#

<tgx tgx:append="list="></tgx>

Пример 1: минимум (копипаст для старта)#

<tgx tgx:append="list="></tgx>

Пример 2: реальный сценарий#

<tgx tgx:set="list">[]</tgx>
<tgx tgx:append="list=first"></tgx>

Разбор#

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

Когда использовать#

  • Когда нужно подготовить промежуточные переменные перед выводом блока или перед условием.
  • Когда данные нужно собрать/дополнить по шагам, а затем использовать в одном месте шаблона.

Поведение в runtime#

  • Тип: пользовательская директива.
  • В sandbox директива tgx:append: запрещена.

Параметры#

Обязательные#

  • tgx:set|tgx:append|tgx:prepend — имя переменной в runtime.

Необязательные#

  • type — явное приведение (text, number, array, expression, yaml).
  • delimiter — разделитель для строковых списков.

По умолчанию#

  • Без type runtime применяет авто-парсинг (json/bool/null/number/string).

Типы#

  • type — строка-тип из списка поддерживаемых преобразований.

Типы данных и приведение#

  • Добавляет новое значение в конец массива переменной.
  • Если переменная ещё не массив, runtime создаёт массив и помещает в него значение.

Частые ошибки#

  • Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
  • Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.

Проверка перед публикацией#

  • Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
  • Значения по умолчанию обработаны (|fallback) там, где данные могут отсутствовать.

См. также#