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

← Назад

TGX запросы к коллекциям#

Практика выборок в tgx:repeat: фильтрация, сортировка, лимиты и проверка количества.

Синтаксис#

<div tgx:repeat="/faq/*?filter[status]=active&sort=sort,asc&limit=10 -> doc"></div>

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

<div tgx:repeat="/faq/*?filter[status]=active&sort=sort,asc&limit=10 -> doc"></div>

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

<li tgx:repeat="/faq/*?filter[AND][status]=active&sort=sort,asc&limit=10 -> doc">
  <a href="/faq//"></a>
</li>
<div tgx:if="!/faq/*?filter[status]=active:count">Нет активных статей</div>

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

<article tgx:repeat="/faq/*?filter[AND][status]=active&filter[AND][slug]=&limit=1 -> doc">
  <h1></h1>
  <div tgx:render="markdown"></div>
</article>

Разбор#

Всегда задавайте limit и осмысленный sort, особенно на публичных страницах. Для пустых выборок сразу добавляйте fallback-блок.

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

  • Когда нужно управлять поведением блока прямо в шаблоне, не дублируя логику в нескольких местах.
  • Когда важно сделать поведение страницы предсказуемым для пользователя в реальных сценариях.

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

  • Не ставить limit на открытых выборках
  • Не учитывать пустую выборку и оставлять страницу без сообщения

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

  • Проверены лимиты, сортировка и фильтры в запросе
  • Пустая выборка покрыта fallback-блоком

См. также#