Docsentender el modelo

Vistas

Antes de elegir un formato de archivo, es importante distinguir entre cómo Nexy maneja los recursos y cómo los representa.

Término Definición
Página Un recurso de la aplicación direccionable por URL. Está definido por un archivo en src/routes/.
Ver El proceso de producir el cuerpo de respuesta de una página. Una vista transforma la lógica y los datos en HTML o JSON.
Componente Un bloque de construcción de interfaz de usuario reutilizable que se utiliza para componer una vista. Los componentes pueden ser ayudantes nativos de Nexy o específicos del marco (React, Vue, etc.).
Controlador de ruta Una función Python que maneja una solicitud HTTP para un método específico (por ejemplo, GET, POST).
Punto final La combinación única de una URL y un método HTTP a la que responde un controlador de ruta.

¿No estás seguro? Escriba un archivo .nexy. No necesita marco de cliente, y puede agregar un componente React, Vue, Svelte, Solid o Preact dentro de él más tarde, como una isla.

¿Qué archivo para qué página?
server logic + HTML.nexy(Python frontmatter + Jinja2)
prose that changes rarely.md(GitHub-flavoured Markdown)
prose + components.mdx(React or Preact)
app-like page, client router.tsx .vue .svelte(framework files)
API handler.py(GET, POST, …)

Formatos

Formato Archivo renderizado del servidor Marco de cliente Notas
.nexy Archivos .nexy Jinja2 + Python lógica, transmitida opcional Formato de página nativo de Nexy
.md Markdown y MDX Markdown en el momento de la solicitud opcional a través del diseño Puro Markdown, GFM, envuelto en diseño
.mdx Markdown y MDX marco RSS React o Preact Markdown con componentes
.tsx React, Solid o Preact modo cliente: el marco, renderizado en Node React, Solid o Preact Rutas de componentes
.vue Vue modo cliente: el marco, renderizado en Node Vue Rutas SFC
.svelte Svelte modo cliente: el marco, renderizado en Node Svelte Rutas SFC

Ayudantes Image, Link, Audio, Video y Import integrados: Componentes.

Formatos de mezcla

Puedes mezclar diferentes tecnologías dentro de un mismo proyecto:

  • Islas: Puede importar un componente React o Vue dentro de una página .nexy. El servidor representa el shell y el marco hidrata el componente en el cliente.
  • Lógica compartida: los controladores de ruta en archivos .py pueden proporcionar datos a páginas en cualquier formato a través del estado de la aplicación compartida o llamadas API.

Habilitar un marco

Establezca useFF en nexyconfig.py y ejecute nexy new para agregar dependencias:

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

Con un marco habilitado, Vite maneja sus paquetes de clientes. En modo cliente sus extensiones se convierten en rutas; en el modo servidor, los mismos archivos son componentes que usted importa como islas; allí se rechaza un archivo de marco en src/routes/. Consulte modo servidor y modo cliente.

Diseños

Un layout.* en un directorio envuelve las páginas debajo de él. Ver diseños.

Próximos pasos

Editar en GitHub

Enter abre el resultado, Esc lo cierra.