tgx:ajax-vals — Маппинг в `data-hx-vals`
tgx:ajax-vals#
Маппинг в data-hx-vals.
Синтаксис#
<div tgx:ajax-vals="{\"mode\":\"quick\"}"></div>Пример 1: минимум (копипаст для старта)#
<div tgx:ajax-vals="{\"mode\":\"quick\"}"></div>Пример 2: реальный сценарий#
<button tgx:ajax-post="/api/v1/trigger/call/cache-refresh" tgx:ajax-vals='{"scope":"docs"}'>Refresh</button>Разбор#
Позволяет передать дополнительные параметры запроса.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-vals: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.
См. также#
Связанные статьи
tgx:ajax-vals — Маппинг в `data-hx-vals`
tgx:ajax-vals#
Маппинг в data-hx-vals.
Синтаксис#
<div tgx:ajax-vals="{\"mode\":\"quick\"}"></div>Пример 1: минимум (копипаст для старта)#
<div tgx:ajax-vals="{\"mode\":\"quick\"}"></div>Пример 2: реальный сценарий#
<button tgx:ajax-post="/api/v1/trigger/call/cache-refresh" tgx:ajax-vals='{"scope":"docs"}'>Refresh</button>Разбор#
Позволяет передать дополнительные параметры запроса.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-vals: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.