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

← Назад

tgx:auto-refresh#

Добавляет polling every <interval> в data-hx-trigger.

Синтаксис#

<div tgx:auto-refresh="10s"></div>

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

<div tgx:auto-refresh="10s"></div>

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

<section tgx:ajax-get="/api/v1/notification/transfers" tgx:auto-refresh="30s" tgx:target="#bell"></section>

Пример 3: комбинированный сценарий#

<input tgx:ajax-get="/api/v1/domain/status" tgx:trigger="keyup changed delay:400ms" tgx:auto-refresh="45s" tgx:target="#domain-status">

Разбор#

Пустое значение означает 10s. Если у узла уже есть trigger, runtime аккуратно подменяет/добавляет только блок every ....

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

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

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

  • Тип: пользовательская директива.
  • В sandbox директива tgx:auto-refresh: запрещена.

Параметры#

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

По умолчанию#

  • Пустое значение интерпретируется как 10s.

Типы#

  • ms|s|m|h (например 500ms, 30s, 2m).

Типы данных и приведение#

  • Допустимы интервалы ms|s|m|h и человекочитаемые варианты (sec, minute, hour, ...).
  • Пустое значение автоматически становится 10s.
  • Если у узла уже есть tgx:trigger, runtime аккуратно объединяет его с polling every ....

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

  • Указывать невалидный интервал (runtime оставит предупреждение и не добавит polling)
  • Ставить auto-refresh на тяжелые запросы без лимитов/кеша

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

  • Интервал указан в поддерживаемом формате (ms|s|m|h)
  • Проверено объединение с уже заданным tgx:trigger

См. также#