SSR (rendu serveur)

Une page Markdown et un gestionnaire, côte à côte dans le même projet :

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

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

Une route de composants est le seul cas qui nécessite une deuxième phrase. En production, un composant route sans une mise en page est servi avec le HTML produit lors de la construction, et le composant l'hydrate. Avec une mise en page, ou en développement, le conteneur est vide et le composant s'affiche dans le navigateur - la page est alors un shell qui se remplit tout seul.

Le composant route du tableau, sans mise en page, donc la production sert son HTML dès le build :

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

Une vue et un point de terminaison JSON, côte à côte dans le même module :

<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. La requête atteint le routeur basé sur des fichiers. Le chemin correspond et les segments dynamiques sont convertis en types déclarés par le composant.

   ---identifiant : prop[int]---<h1>Commande n°{{ id + 1000 }}</h1>

   /orders/42 rend Order #1042; /orders/abc répond à 404.

2. Le composant s'exécute. Celui qui attend sur Node - un document client - s'exécute dans un pool de threads, afin de ne pas bloquer la boucle d'événements.

3. Le corps est diffusé sous la forme text/html. Un composant qui génère des morceaux les diffuse au fur et à mesure qu'il les crée.

4. Le navigateur reçoit du HTML. Les îles s'hydratent conformément à leur directive.

Une erreur générée lors du rendu est transformée en page par errors.nexy lorsque le projet en possède une : voir pages d'erreur.

1. La demande parvient au contrôleur. Ses paramètres de chemin sont convertis en types déclarés par la méthode et transmis à la vue :

   à partir de nexy.decorators import Controllerà partir de nexy.hooks, importez useViews  @Controller("/commandes/{id}")classe OrderController :    async def get(self, id:int):        return useViews("src/apps/order_view.nexy", context={"id": id})

   ---identifiant : prop[int]---<h1>Commande n°{{ id + 1000 }}</h1>

   /orders/42/ rend Order #1042; /orders/abc/ répond à 404.

2. La vue s'exécute et useViews renvoie son HTML comme réponse.

3. Le navigateur reçoit du HTML. Les îles s'hydratent conformément à leur directive.

Une erreur générée lors du rendu reçoit une réponse avec la page d'erreur par défaut.

Aucun. Deux issues, et elles n’ont pas le même grain :

Le commutateur à l'échelle du projet, dans nexyconfig.py. Le mode client nécessite un framework client :

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

Aucun. Chaque vue renvoyée par un contrôleur est rendue à chaque requête : ISR et CSR sont des modes du routeur basé sur les fichiers.

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

GET /blog/hello exécute ce modèle une fois, avec slug défini sur hello. Une seconde requête le relance : rien n'est conservé entre les deux. La chaîne de requête n'est pas un accessoire - lisez-la avec les hooks dans navigation.

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/ exécute cette vue une fois, avec slug défini sur hello. Une seconde requête le relance : rien n'est conservé entre les deux. La chaîne de requête n'est pas un accessoire - lisez-la avec useSearchParams.

• ISR : met en cache cette page par URL

• CSR : navigation manuelle vers le navigateur