• Быстрый старт
  • Доступ и токен
    • Сущности
      • Страницы
        • Фреймы
          • Вставки onpress/
          • Бинды data-op-bind
          • Сборка и копии
          • Фреймы в markdown
          • Фреймы с данными
        • Данные
          • Повторитель onpress/repeat
      • Медиа
    • Устройство сайта
      • Сайты и домены
      • Настройки сайта
      • Меню
      • Языки и переводы
      • Стили и оформление
      • SEO
    • Готовые фреймы
      • Каталог фреймов
        • Страницы
          • home
          • article
          • landing
          • pricing
          • docs
          • outline
          • page-feed
        • Сайт
          • site__header
          • site__footer
          • site__404
        • Ассистенты
          • assistant
          • assistant__chat
        • FAQ
          • faq
          • article__faq
        • Новости
          • news
          • news__category
          • news__post
          • news__more
          • news__share
        • Авторы
          • author__page
          • author__head
          • author__byline
          • author__card
          • author__avatar
          • author__socials
    • Кейсы
        • Создание сайтов
          • Сайт с нуля
          • Раздел документации
          • Лендинг
          • Многоязычный сайт
        • Работа с контентом
          • FAQ
          • Картинки в статье
          • Перенести страницу
        • Фреймы и данные
          • Свой фрейм из готового
          • Список из данных
        • Настройка сайта
          • Поменять меню
          • Сменить оформление
    • Управление
      • Дашборд и вход
      • Пользователи и профиль
      • Сайдбар документации
        • Ошибки и проблемы
          • Коды ошибок
OnPress OnPress
  • Документация
  • Контакты
Войти
Документация API Reference
  • Быстрый старт
  • Доступ и токен
    • Сущности
      • Страницы
        • Фреймы
          • Вставки onpress/
          • Бинды data-op-bind
          • Сборка и копии
          • Фреймы в markdown
          • Фреймы с данными
        • Данные
          • Повторитель onpress/repeat
      • Медиа
    • Устройство сайта
      • Сайты и домены
      • Настройки сайта
      • Меню
      • Языки и переводы
      • Стили и оформление
      • SEO
    • Готовые фреймы
      • Каталог фреймов
        • Страницы
          • home
          • article
          • landing
          • pricing
          • docs
          • outline
          • page-feed
        • Сайт
          • site__header
          • site__footer
          • site__404
        • Ассистенты
          • assistant
          • assistant__chat
        • FAQ
          • faq
          • article__faq
        • Новости
          • news
          • news__category
          • news__post
          • news__more
          • news__share
        • Авторы
          • author__page
          • author__head
          • author__byline
          • author__card
          • author__avatar
          • author__socials
    • Кейсы
        • Создание сайтов
          • Сайт с нуля
          • Раздел документации
          • Лендинг
          • Многоязычный сайт
        • Работа с контентом
          • FAQ
          • Картинки в статье
          • Перенести страницу
        • Фреймы и данные
          • Свой фрейм из готового
          • Список из данных
        • Настройка сайта
          • Поменять меню
          • Сменить оформление
    • Управление
      • Дашборд и вход
      • Пользователи и профиль
      • Сайдбар документации
        • Ошибки и проблемы
          • Коды ошибок
Фреймы и данные

Список из данных

Markdown
Открыть в ИИ
  • Открыть в ChatGPT
  • Открыть в Claude
  • Открыть в Gemini
  • Открыть в Perplexity
  • Открыть в Grok
  • Открыть в DeepSeek

Список из данных

Результат: блок «Тарифы» из карточек, который собирается из набора tariffs. Цена меняется запросом к данным — разметку никто не трогает.

1. Набор

curl -s -X PUT "$API/site/$SITE/data/tariffs" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"items": [
        {"slug": "start",  "title": "Старт",   "price": "0 ₽",     "note": "Для пробы",           "url": "/tarify/start/"},
        {"slug": "pro",    "title": "Про",     "price": "990 ₽",   "note": "Свой домен",          "url": "/tarify/pro/"},
        {"slug": "team",   "title": "Команда", "price": "2 990 ₽", "note": "Несколько авторов",   "url": "/tarify/team/"},
        {"slug": "agency", "title": "Агентство","price": "9 990 ₽","note": "Много сайтов",        "url": "/tarify/agency/"}
      ]}' | jq -c '{applied, items: .dataset.items, fields: [.dataset.fields[].field]}'

Схемы нет: какие поля положили, такие доступны в разметке как item.<поле>.

2. Фрейм блока

tariffs__cards.html:

<section class="tariffs">
  <h2 class="tariffs__title">Тарифы</h2>
  <div class="tariffs__grid">
    <!-- onpress/repeat {"source":"tariffs","limit":3,"offset":"(page.paged - 1) * 3","empty":"frame"} -->
    <a class="tariffs__card" data-op-bind='{"href":"item.url"}'>
      <span class="tariffs__name" data-op-bind='{"text":"item.title"}'></span>
      <strong class="tariffs__price" data-op-bind='{"text":"item.price"}'></strong>
      <span class="tariffs__note" data-op-bind='{"text":"item.note"}'></span>
    </a>
    <!-- /onpress/repeat -->
  </div>
  <nav class="tariffs__pages"><a href="?blog_page=1">1</a> <a href="?blog_page=2">2</a></nav>
</section>
  • limit: 3 и offset от page.paged — по три карточки на страницу; номер страницы — параметр ?blog_page=N в адресе, без него — первая;
  • "empty":"frame" — если на какой-то странице разбивки карточек не осталось, блок не выводится вовсе;
  • ссылки на страницы разбивки — обычная разметка.
curl -s -X POST "$API/site/$SITE/frames" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d "$(jq -n --rawfile html tariffs__cards.html '{slug: "tariffs__cards", html: $html}')" \
  | jq -c '{slug: .frame.slug, sources, renders_on_request, live_reasons}'
{"slug":"tariffs__cards","sources":["tariffs"],"renders_on_request":true,"live_reasons":["op/repeat limit/offset uses page.* tokens"]}

Окно от page.paged делает фрейм зависимым от страницы — он собирается на каждом запросе. Без разбивки ("limit": 3 без offset) блок попал бы и в статическую копию.

3. Поставить на страницу

Лучше всего — во фрейм страницы (оболочку) строкой <!-- onpress/frame {"name":"tariffs__cards"} /-->: тогда платформа знает, какие страницы зависят от набора, и сама сбрасывает их кэш после правки данных. Можно и прямо в тело страницы — той же строкой в markdown, но тогда после правки набора кэш этой страницы придётся сбросить вручную (шаг 5):

---
name: "Тарифы"
slug: "tarify"
url: "/tarify/"
lang: "ru"
frame: "article"
---

Выберите тариф.

<!-- onpress/frame {"name":"tariffs__cards"} /-->

4. Проверить заранее

Что получит повторитель на первой и второй странице разбивки:

for n in 1 2 3; do
  printf 'blog_page=%s: ' "$n"
  curl -s -X POST "$API/site/$SITE/data/resolve" \
    -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
    -d "{\"source\": \"tariffs\", \"limit\": 3, \"offset\": \"(page.paged - 1) * 3\", \"paged\": $n}" \
    | jq -c '{window, window_total, titles: [.items[].title]}'
done
blog_page=1: {"window":{"offset":0,"limit":3},"window_total":4,"titles":["Старт","Про","Команда"]}
blog_page=2: {"window":{"offset":3,"limit":3},"window_total":4,"titles":["Агентство"]}
blog_page=3: {"window":{"offset":6,"limit":3},"window_total":4,"titles":[]}

На странице сайта: /tarify/, /tarify/?blog_page=2.

5. Поправить данные

curl -s -X PATCH "$API/site/$SITE/data/tariffs" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"ops": [{"op": "merge", "match": {"slug": "pro"}, "fields": {"price": "1 290 ₽"}}]}' \
  | jq -c '{applied, rebaked: .rebaked | {status, cache: .cache.status}}'

Если блок стоит во фрейме страницы, запись сама сбрасывает кэш этих страниц (rebaked.cache.status: "ok") — новая цена видна на следующем запросе. Если блок вставлен в тело страницы, платформа эту связь не видит ("cache": "nothing"), и посетители получат старую копию из кэша, пока её не сбросить:

curl -s -X POST "$API/site/$SITE/cache/flush" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"urls": ["/tarify/"]}' | jq -c .flushed.urls.status

Варианты

  • Фильтр по странице — показывать на странице только «её» элементы: поле page в элементах и "match":{"page":"page.slug"} в повторителе.
  • Выбор по списку — "match":{"slug":["raw:pro","raw:team"]} выводит только два тарифа.
  • Перевод — PUT /data/tariffs с "lang": "en": английские страницы получат английский вариант.
  • Без набора — короткий неизменный список можно держать прямо в атрибуте: <!-- onpress/repeat {"items":[{"title":"…"},{"title":"…"}]} -->.
arrow_backНазад
Свой фрейм из готового
Далееarrow_forward
Настройка сайта
На этой странице
  • 1. Набор
    • 2. Фрейм блока
      • 3. Поставить на страницу
        • 4. Проверить заранее
          • 5. Поправить данные
            • Варианты
            1. Главная
            2. Docs
            3. Документация OnPress v2
            4. Документация OnPress v2
            5. Рецепты
            6. Список из данных
            OnPress
            OnPress
            ИП Зуев И.В. ИНН: 360408359441
            info@onpress.pro
            © 2026
            политика конфиденциальности публичная оферта
            • visa
            • mastercard
            • sber
            • tpay