tgx:append — Добавляет значение в массив runtime-переменной
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: запрещена.
Типы данных и приведение#
- Добавляет новое значение в конец массива переменной.
- Если переменная ещё не массив, runtime создаёт массив и помещает в него значение.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать.
См. также#
Связанные статьи
tgx:append — Добавляет значение в массив runtime-переменной
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: запрещена.
Типы данных и приведение#
- Добавляет новое значение в конец массива переменной.
- Если переменная ещё не массив, runtime создаёт массив и помещает в него значение.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать.