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

← Назад

tgx:prepend#

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

Синтаксис#

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

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

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

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

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

Разбор#

Симметрично tgx:append, но с вставкой в начало.

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

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

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

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

Параметры#

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

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

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

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

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

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

Типы#

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

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

  • Добавляет новое значение в начало массива переменной.
  • Если задан tgx:delimiter, строка сначала делится по delimiter; иначе применяется автоприведение по type/auto.

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

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

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

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

См. также#