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

← Назад в FAQ

tgx:auto-refresh — Добавляет polling `every <interval>` в `data-hx-trigger`

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: запрещена.

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

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

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

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

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

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

См. также#

Связанные статьи

tgx-trigger tgx-ajax-get

← Назад в FAQ

tgx:auto-refresh — Добавляет polling `every <interval>` в `data-hx-trigger`

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: запрещена.

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

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

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

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

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

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

См. также#

Связанные статьи

tgx-trigger tgx-ajax-get