tgx:ajax-put — AJAX PUT-шорткат
tgx:ajax-put#
AJAX PUT-шорткат.
Синтаксис#
<form tgx:ajax-put="/api/v1/item/1"></form>Пример 1: минимум (копипаст для старта)#
<form tgx:ajax-put="/api/v1/item/1"></form>Пример 2: реальный сценарий#
<button tgx:ajax-put="/api/v1/profile" tgx:trigger="click">Сохранить</button>Разбор#
Подходит для полного обновления сущности.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-put: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Убедитесь, что endpoint существует в
/api/v1/*и ожидает именно этот HTTP метод. - Для форм внутри админки всегда передавайте разрешенные токеном поля, иначе получите 403.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.
См. также#
Связанные статьи
tgx:ajax-put — AJAX PUT-шорткат
tgx:ajax-put#
AJAX PUT-шорткат.
Синтаксис#
<form tgx:ajax-put="/api/v1/item/1"></form>Пример 1: минимум (копипаст для старта)#
<form tgx:ajax-put="/api/v1/item/1"></form>Пример 2: реальный сценарий#
<button tgx:ajax-put="/api/v1/profile" tgx:trigger="click">Сохранить</button>Разбор#
Подходит для полного обновления сущности.Когда использовать#
- Когда нужно обновлять часть страницы без полной перезагрузки (формы, фильтры, списки, таблицы).
- Когда нужно контролировать UX запроса: куда вставить ответ, по какому событию отправить и как обработать подтверждение.
Поведение в runtime#
- Тип: пользовательская директива.
- В sandbox директива
tgx:ajax-put: запрещена. - Это HTMX-мост: runtime маппит
tgx:в соответствующиеdata-hx-атрибуты.
Частые ошибки#
- Убедитесь, что endpoint существует в
/api/v1/*и ожидает именно этот HTTP метод. - Для форм внутри админки всегда передавайте разрешенные токеном поля, иначе получите 403.
Проверка перед публикацией#
- Пример корректно отрабатывает в рабочем шаблоне/тестовой странице проекта.
- Значения по умолчанию обработаны (
|fallback) там, где данные могут отсутствовать. - Целевой блок ответа задан через
tgx:target/tgx:swapи корректно обновляется. - Проверен сценарий ошибки API (429/403/422), чтобы UI не оставался в неконсистентном состоянии.