TGX запросы к коллекциям — filter, sort, limit и count

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/tgx-data-queries-and-filters/">TGX запросы к коллекциям — filter, sort, limit и count</a>
</li>
<div tgx:if="!/faq/*?filter[status]=active:count">Нет активных статей</div>

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

<article tgx:repeat="/faq/*?filter[AND][status]=active&filter[AND][slug]=tgx-data-queries-and-filters&limit=1 -> doc">
  <h1>TGX запросы к коллекциям — filter, sort, limit и count</h1>
  <div tgx:render="markdown"># TGX запросы к коллекциям

Практика выборок в [`tgx:repeat`](/faq/tgx-repeat/): фильтрация, сортировка, лимиты и проверка количества.

## Синтаксис
```html
<div tgx:repeat="/faq/*?filter[status]=active&sort=sort,asc&limit=10 -> doc"></div>
```

## Пример 1: минимум (копипаст для старта)
```html
<div tgx:repeat="/faq/*?filter[status]=active&sort=sort,asc&limit=10 -> doc"></div>
```

## Пример 2: реальный сценарий
```html
<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: комбинированный сценарий
```html
<article tgx:repeat="/faq/*?filter[AND][status]=active&filter[AND][slug]=tgx-data-queries-and-filters&limit=1 -> doc">
  <h1></h1>
  <div tgx:render="markdown"></div>
</article>
```

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

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

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

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

## См. также
- [/faq/tgx-repeat/](/faq/tgx-repeat/)
- [/faq/tgx-if/](/faq/tgx-if/)
- [/faq/tgx-set/](/faq/tgx-set/)

</div>
</article>

Разбор#

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

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

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

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

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

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

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

См. также#

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

tgx-repeat tgx-if tgx-set

← Назад в FAQ