SSR (серверный рендеринг)

Страница Markdown и обработчик в одном проекте:

# Changelog Rendered to HTML on every request, then wrapped in the nearest layout.

async def GET():    return {"status": "ok"}

Компонентный маршрут — это тот случай, когда требуется второе предложение. В рабочей среде маршрут компонента без макета обслуживается с помощью HTML, созданного при сборке, и компонент его гидратирует. В макете или в разработке контейнер пуст, и компонент отображается в браузере — тогда страница представляет собой оболочку, которая заполняется сама собой.

Компонентный маршрут таблицы без макета, поэтому продукция передает HTML из сборки:

export default function Pricing() {  return <h1>Pricing</h1>;}

Представление и конечная точка JSON рядом в одном модуле:

<h1>Changelog</h1><p>Rendered to HTML on every request.</p>

from nexy.decorators import Controllerfrom nexy.hooks import useViews  @Controller("/changelog")class ChangelogController:    async def get(self):        return useViews("src/apps/changelog_view.nexy")  @Controller("/api/health")class HealthController:    async def get(self):        return {"status": "ok"}

1. Запрос достигает файлового маршрутизатора. Путь сопоставляется, и динамические сегменты приводятся к типам, объявленным компонентом.

   ---идентификатор: prop[int]---<h1>Заказ № {{ id + 1000 }}</h1>

   /orders/42 отображает Order #1042; /orders/abc отвечает 404.

2. Компонент запускается. Тот, который ожидает Node (клиентский документ), работает в пуле потоков, поэтому он не останавливает цикл событий.

3. Тело передается как text/html. Компонент, который создает фрагменты, передает их в потоковом режиме по мере их создания.

4. Браузер получает HTML. Острова гидратируются согласно их директиве.

Ошибка, возникшая при рендеринге, преобразуется в страницу с помощью errors.nexy, если она есть в проекте: см. страницы ошибок.

1. Запрос достигает контроллера. Его параметры пути приводятся к типам, объявленным методом, и передаются в представление:

   из контроллера импорта nexy.decoratorsиз nexy.hooks импортировать useViews  @Controller("/orders/{id}")класс OrderController:    асинхронное определение get(self, id: int):        return useViews("src/apps/order_view.nexy", context={"id": id})

   ---идентификатор: prop[int]---<h1>Заказ № {{ id + 1000 }}</h1>

   /orders/42/ отображает Order #1042; /orders/abc/ отвечает 404.

2. Представление запускается, и useViews возвращает свой HTML в качестве ответа.

3. Браузер получает HTML. Острова гидратируются в соответствии с их директивой.

На ошибку, возникшую во время рендеринга, отвечает страница ошибки по умолчанию.

Нет. Выхода два, и они не имеют одинакового зерна:

Переключатель всего проекта, в nexyconfig.py. Клиентский режим требует клиентской инфраструктуры:

from nexy.core.models import NexyConfigModelfrom nexy.frontend import react  class NexyConfig(NexyConfigModel):    useFF = react()    useCSR = True

Нет. Каждое представление, возвращаемое контроллером, отображается при каждом запросе: ISR и CSR — это режимы файлового маршрутизатора.

---slug: prop[str] = "untitled"---<h1>{{ slug }}</h1>

GET /blog/hello запускает этот шаблон один раз, при этом для slug установлено значение hello. Второй запрос запускает его снова: между ними ничего не сохраняется. Строка запроса не является реквизитом — прочитайте ее с помощью перехватчиков в навигация.

from nexy.decorators import Controllerfrom nexy.hooks import useViews  @Controller("/blog/{slug}")class PostController:    async def get(self, slug: str):        return useViews("src/apps/post_view.nexy", context={"slug": slug})

---slug: prop[str] = "untitled"---<h1>{{ slug }}</h1>

GET /blog/hello/ запускает это представление один раз, при этом для slug установлено значение hello. Второй запрос запускает его снова: между ними ничего не сохраняется. Строка запроса не является реквизитом — прочитайте ее с помощью useSearchParams.

• ISR: кэшировать эту страницу для каждого URL-адреса.

• CSR: ручная навигация в браузере.