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