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

← Назад

tgx:ajax-headers#

Маппинг в data-hx-headers.

Синтаксис#

<div tgx:ajax-headers="{\"X-Trace\":\"1\"}"></div>

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

<div tgx:ajax-headers="{\"X-Trace\":\"1\"}"></div>

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

<button tgx:ajax-get="/api/v1/domain/status" tgx:ajax-headers='{"X-Trace":"faq","X-Client":"docs"}'>Проверить</button>

Разбор#

Значение должно быть JSON-объектом; runtime прокидывает его в data-hx-headers.

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

  • Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
  • Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.

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

  • Тип: пользовательская директива.
  • В sandbox директива tgx:ajax-headers: запрещена.
  • Это HTMX-мост: runtime маппит tgx: в соответствующие data-hx- атрибуты.

Параметры#

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

  • tgx:ajax-headers — JSON/object дополнительных HTTP-заголовков.

Типы#

  • JSON-объект или DSL-выражение с объектом.

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

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

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

  • Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
  • Значения по умолчанию обработаны (|fallback) там, где данные могут отсутствовать.
  • Целевой блок ответа задан через tgx:target/tgx:swap и корректно обновляется.
  • Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.

См. также#