DocsBasé sur un fichier
Routage basé sur des fichiers
Un itinéraire est un fichier. L'URL est le chemin du fichier relatif à src/routes/, moins l'extension.
Fichier vers URL
| Fichier | URL |
|---|---|
index.nexy |
/ |
about.nexy |
/about |
blog/index.nexy |
/blog |
blog/[slug].nexy |
/blog/{slug} |
docs/[...path].nexy |
/docs/{path:path} |
(marketing)/pricing.nexy |
/pricing |
api/users.py |
/api/users |
index correspond à son répertoire, pas à /index. Un répertoire entre parenthèses est un groupe : il organise les fichiers sans apparaître dans l'URL.
En mode client, les fichiers d'échange sont .tsx, .vue ou .svelte au lieu de .nexy ; les règles d'URL sont les mêmes.
Deux fichiers de cette table : une page qui lit son segment et un gestionnaire qui répond au JSON.
slug: prop[str]<h1>{{ slug }}</h1>async def GET(): return {"users": []}Deux modes
useCSR décide quelles sont les pages. Les deux ne peuvent pas être mélangés dans un seul projet : Nexy refuse de démarrer lorsqu'une page serveur se trouve à côté d'une route client.
| Mode | Pages | Disposition racine | Voir |
|---|---|---|---|
Serveur (useCSR = False) |
.nexy, .md, .mdx |
layout.nexy |
Mode serveur et mode client |
Client (useCSR = True) |
fichiers de cadre | layout.tsx |
layout.tsx |
Les fichiers .py sont des gestionnaires d'API dans les deux modes.
Le commutateur est une ligne de nexyconfig.py :
from nexy.core.models import NexyConfigModelfrom nexy.frontend import react class NexyConfig(NexyConfigModel): useFF = react() useCSR = True # client mode: src/routes/*.tsx are the pagesCe qui n'est pas un itinéraire
- Noms de fichiers réservés :
layout.*,loading.nexy,errors.nexy,notfound.nexy,dependencies.py,middleware.py,__init__.py. - Fichiers et dossiers commençant par
_ou.: utilisez-les pour les partiels et les brouillons. - Extensions qui ne sont pas actives pour votre projet. Un fichier dont l'extension est inactive est ignoré avec un avertissement.
Un fichier par URL
Deux fichiers qui renvoient à la même URL sont tous deux enregistrés. Ne créez pas blog.nexy à côté de blog/index.nexy et ne mélangez pas index.nexy et index.py pour le même chemin. Choisissez-en un.
Dans cette rubrique
| Dossier | Ce qu'il couvre |
|---|---|
| pages/ | pages, itinéraires dynamiques, groupes de itinéraires |
| mises en page/ | une page par type de fichier de mise en page |
| gestionnaires/ | .py gestionnaires, validation et erreurs |
| dépendances/ | dependencies.py, gardes |
| intergiciel/ | middleware.py |
| erreurs/ | pages introuvables et pages d'erreur |
| navigation/ | liens, crochets |
| en temps réel/ | WebSocket |
| héritage | les règles d'héritage dans une seule table |