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

← Назад

tgx:input#

Рендерит конкретный тип input.

Синтаксис#

<tgx tgx:input="text" name="title"></tgx>

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

<tgx tgx:input="text" name="title"></tgx>

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

<tgx tgx:input="number" name="price"></tgx>

Разбор#

Работает вместе с рендером полей и ручными формами.

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

  • Когда нужно быстро собрать форму или набор полей на основе структуры данных.
  • Когда важно сократить ручную верстку и избежать ошибок в названиях полей.

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

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

Параметры#

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

  • tgx:input — тип поля (text, number, select, ...).

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

  • name, value, label, placeholder, required, multiple и др. стандартные attrs формы.

Типы#

  • Тип зависит от выбранного tgx:input.

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

  • В режиме tgx:input="auto" runtime сам определяет тип по значению (number/bool/json/date/url/email/tel/color и т.д.).
  • Для JSON ({...}/[...]) пытается json_decode; при ошибке оставляет текст.
  • Для checkbox/bool true/false приводятся к флажку; для number/int используются соответствующие input-типы.

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

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

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

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

См. также#