← Назад в FAQ

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

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

Синтаксис#

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

Пример 1: минимальный#

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

Пример 2: практический#

<li tgx:repeat="/docs/*?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="!/docs/*?filter[status]=active:count">Нет активных статей</div>

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

<article tgx:repeat="/docs/*?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`: фильтрация, сортировка, лимиты и проверка количества.

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

## Пример 1: минимальный
```html
tgx:repeat="/docs/*?filter[status]=active&sort=sort,asc&limit=10 -> doc"
```

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

## Пример 3: комбинированный сценарий
```html
<article tgx:repeat="/docs/*?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-блоком

См. также#

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