tgx:ajax-encoding — Маппинг в `data-hx-encoding`
tgx:ajax-encoding#
Маппинг в data-hx-encoding.
Синтаксис#
<div tgx:ajax-encoding="multipart/form-data"></div>Пример 1: минимум (копипаст для старта)#
<div tgx:ajax-encoding="multipart/form-data"></div>Пример 2: реальный сценарий#
<form tgx:ajax-post="/api/v1/site/import" tgx:ajax-encoding="multipart/form-data">...</form>Разбор#
Используйте при загрузке файлов/архивов.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-encoding: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.
См. также#
Связанные статьи
tgx:ajax-encoding — Маппинг в `data-hx-encoding`
tgx:ajax-encoding#
Маппинг в data-hx-encoding.
Синтаксис#
<div tgx:ajax-encoding="multipart/form-data"></div>Пример 1: минимум (копипаст для старта)#
<div tgx:ajax-encoding="multipart/form-data"></div>Пример 2: реальный сценарий#
<form tgx:ajax-post="/api/v1/site/import" tgx:ajax-encoding="multipart/form-data">...</form>Разбор#
Используйте при загрузке файлов/архивов.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-encoding: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Проверяйте синтаксис атрибута и кавычки: TGX чувствителен к незакрытым выражениям.
- Тестируйте изменения в подходящем окружении: sandbox для поддерживаемых директив, рабочая тестовая страница — для остальных.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.