预览
表单已提交！
{{ JSON.stringify(data) }}
```
#### 流式内容
使用 `echo()` 函数进行内容流式传输。它接受字符串、函数、Promise、Response 对象或 ReadableStream：
```html
```
#### 全局变量
在模板中访问请求上下文：
| 变量 | 描述 |
| --- | --- |
| `$REQUEST` | 传入的 `Request` 对象 |
| `$METHOD` | HTTP 方法（`GET`、`POST` 等） |
| `$URL` | 请求 `URL` 对象 |
| `$HEADERS` | 请求头 |
| `$RESPONSE` | 响应配置对象 |
| `$COOKIES` | 包含请求 Cookie 的只读对象 |
#### 内置函数
| 函数 | 描述 |
| --- | --- |
| `htmlspecialchars(str)` | 转义 HTML 字符（在 `{{ }}` 语法中自动应用） |
| `setCookie(name, value, options?)` | 在响应中设置 Cookie |
| `redirect(url)` | 将用户重定向到另一个 URL |
| `echo(content)` | 将内容流式传输到响应 |
```html [index.html]
欢迎，！
``` :read-more{to="https://github.com/h3js/rendu" title="Rendu 文档"} ## 自定义渲染器处理程序 对于更复杂的场景，您可以创建以编程方式生成响应的自定义渲染器处理程序。 该处理程序是一个默认导出的函数，接收一个 H3 事件对象。您可以通过 `event.req` 访问传入的 `Request`： ```ts [renderer.ts] export default function renderer({ req }: { req: Request }) { const url = new URL(req.url); return new Response( /* html */ `当前路径：${url.pathname}
`, { headers: { "content-type": "text/html; charset=utf-8" } } ); } ``` 然后，在 Nitro 配置中指定渲染器入口： ```ts [nitro.config.ts] import { defineConfig } from "nitro"; export default defineConfig({ renderer: { handler: './renderer.ts' } }) ``` ::note 当设置了 `renderer.handler` 时，它将完全控制渲染。`renderer.template` 选项将被忽略。 :: ## 渲染器优先级 渲染器始终充当捕获所有路由的通配符路由（`/**`），并具有**最低优先级**。这意味着： 1. 特定的 API 路由首先匹配（例如 `/api/users`） 2. 特定的服务器路由随后匹配（例如 `/about`） 3. 渲染器捕获其他所有内容 ```md api/ users.ts → /api/users（首先匹配） routes/ about.ts → /about（其次匹配） renderer.ts → /**（捕获所有其他路由） ``` ::note 如果您定义了自己的捕获所有路由（`[...].ts`），它会与其他 `/**` 处理程序串联，而不是取代它们：捕获所有处理程序会按照注册顺序运行（基于文件的捕获所有处理程序，然后是[服务器入口](/docs/server-entry)，最后是渲染器），第一个返回响应的处理程序获胜。渲染器只会处理您的捕获所有路由未作出响应的请求。 :: :read-more{to="/docs/lifecycle" title="生命周期"} ## Vite 集成 将 Nitro 与 Vite 一起使用时，渲染器会与 Vite 的构建管道和开发服务器集成。 ### 开发模式 在开发过程中，每次请求都会从磁盘读取渲染器模板，因此对 `index.html` 的更改会立即生效，无需重启服务器。Vite 的 `transformIndexHtml` 钩子会被应用，以注入 HMR 客户端脚本和其他开发时转换。 ### 使用 `` 的 SSR 在使用带有 `ssr` 服务的 Vite 环境时，您可以在 `index.html` 中添加 `` 注释。Nitro 会在渲染期间将其替换为您的 SSR 入口的输出： ```html [index.html]