# @graview/pages 中文文档

规范地址：https://npmcn.com/package/%40graview/pages/

版本：0\.2\.5
npm 元数据更新时间：2026-11-16T13:14:33.442Z
中文译文更新时间：2026-11-17T02:00:08.905Z
软件包许可：Elastic-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40graview/pages
原文对照：https://npmcn.com/package/%40graview/pages/?lang=original
项目主页：https://graview.dev/docs/packages/pages.html
源码仓库：https://github.com/en-dash-consulting/graview

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.7 MB，195 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.0
- 运行依赖：6 个
- peer 依赖：react \>=19\.2\.7，react-dom \>=19\.2\.7
- 首次发布：2026-10-02T04:43:27.689Z
- 最新版本发布：2026-11-16T13:14:32.952Z
- 近 30 天下载量：9657（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

传统相貌:一种由同一声明所衍生出并驱动场景的路由网络app.

## 安装

```sh
npm install @graview/pages
```

也可以使用：`pnpm add @graview/pages`、`yarn add @graview/pages`、`bun add @graview/pages`

## README

# @ graview/ 页面

传统面相:一个由同一声明产生的路由网络app,驱动 空间场景。 从一个 `defineApp` 计划 突变 变化 权限 操作日志 此软件包作为普通链接页服务列表、记录、窗体、问题和历史: `/` 画廊, `/:plural` 每样, `/:plural/:id` 每个节点, `/places/:as` 每张照片, `/map` 关系, `/problems`。 。 。 .

-   **一个商店,没有第二条路.** 读取的页数 `Store` 并通过 与同一本金相同的突变; 被扣留的行动使其丧失功能 拒绝. `recordFacts` 构成场景已经使用的衍生词( 标签, 可读) ——平等测试记录页 和相同事实的空间细节.
    
-   **页面注册映射视图注册.** `(kind × page-type) → component`, (中文(简体) ), 默认为每个单元格压倒性; shell, home and problems 页面本身为 登记`registry.surface(...)`) (中文(简体) ).
    
-   **形式是产生的.** `formFields` (单位:千美元) `@graview/core/forms`)将变异的 zod 输入 一种控制树——花板、花枣、节点摘取者, 歧视的结合作为一个类型拾取者 加上那臂的球场,阵列作为可重复行—— 财务报告和审定财务报表 `DerivedForm` 让它。 任何无法证明的都是手写的; 任何无法推翻的 而不是躲藏起来.
    
-   **一栏:场景或页面,以及您所在的地方.** 贝壳就是那个应用栏 (FR-131):应用的标记和名称——页面的一条方向,回家的路——然后开关, "场景"和"Pages"(FR-137;场景在拥有其页面的面部的自己住址),然后 作为打开每个地方的控件: 家 列表 图片 (FR-138)——或者,在酒吧有房间的地方,在排位上的地方,其余在下 "更"(FR-145);再"找","站"和"人". 页面只保留自己的链接——图片 一张"在现场"的专辑. 在嵌入的栏杆下 外壳没有画出来 脸部的"发现"进去 那个酒吧 设计师的外壳也站在栏下`context.barAbove`, (中文(简体) ), 只画它自己的东西; `surface("shell", Shell, { without: ["bar"] })` 让它成为整个窗口。 每页的自有标题在app名下称为关. 见 `apps/todo` 两者均从一个声明上挂起(`/` 现场, `/pages` ) (中文(简体) ).
    
-   **一页写你在哪里.** 每个衍生的列表,记录和图片都会以线索打开—— (单位:千美元) `nav` 叫做"你来了":该类的页面在其中,该类的列表,以及 最后一页, `aria-current="page"` 并离开视线, 因为它的头说 在一行的电话宽度, 它的链接在脸底. `registry.section(kinds, label, { path })` 将部分(“计划”)命名于更改计划及其步骤,以及 `sectionOf(kind)` 读回. 一个设计师的外壳问 `usePlaceHere()` —— 说 `{ as, kind, id, label, section, trail }` ——点出自己的分页并画出自己的行踪,或者地方 `<PageTrail />`以便他们依恋; `without: ["trail"]` 继续 没有。 脸部路由器外的一栏 `placeHere(context, path)`。 。 。 .
    
-   **场景可能住在别的地方.** 页面链接进入现场 `/` 除非 主机说场景在哪里: 设定 `sceneHref` 在 PagesApp 语境中 (单位:千美元)`sceneHref: "/scene/places/overview"`当它不在时 `/`,并传递给 `spatialHref(id, sceneHref)` 财务报告和审定财务报表 `placeHref(as, sceneHref)` 在自己的一页.
    
-   **宿主可能拥有历史.** `basename` 将面孔挂入路径; `onNavigate(path, how)` 告诉一个主机, 每一页面部打开( t)`"push"`, (中文(简体) ), `"replace"` 或者说 `"pop"`),以及 `path` 发回一个,所以一个主机 保持自己的历史 保持脸部.
    
-   **移动是一个接受标准.** `pnpm pages` 运行电话接头 (390x844):没有侧向滚动,命名链接,标签控件,以及衍生出的形式 实际适用.
    
-   **它降落在画廊上.** 家以站为头条——"2个园丁, 3块地和1个植入地, 或者说,"这里还没有什么。" 想象一下应用程序有一张大型的活卡 一张桌子有两个对面和一个电话: 镜片本身,从卡片上抽出一个缩放的活字,带有其名称和如何 都结束了 交出了现场的视图登记册(`views` 每一个标题 镜头是一页 `/places/<as>` 和一张家用卡片 所以一个新的应用程序 降落在画廊上 首个下午 种类依次为一行数,关系为一行数 打开 `/map` ("相接""相接""相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相相接相接相接相接相相相接相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 应用程序栏是一行 (a) 办公桌和电话两个; 有多少问题 有一次,在酒吧的站姿下说, 家只说规则被打破,连接 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}去修理他们.
    
-   **读起来就像产品自己的网站.** 列表随复数及其 说明,有其标题和同类记录 `describe`,在下面缩小控制 内容。 图案学在品牌的展示和身体面孔上搭载了真正的尺度 商标、名称和每类口音`hueFor`从 `@graview/core`)通过 每一页。 仍然衍生出: 这里没有什么是每个应用程序的模板, 一个应用程序会覆盖 a 单元格与它覆盖视图的方式相同.
    
-   **给访客的表格.** `@graview/pages/visitor-form`是因为 `VisitorFormPage` 绘制一个 行为的形式本身——声明 `forms.<name>`、标题、介绍和领域 名字——在店面上,当客人得到服务, 运行行为像他们,并说它是 以宣言本身的文字收到. `@graview/embed/form` 把它挂起来.
    
-   **页面也是字符串(FR-174).** `@graview/pages/static` 使一个地方没有 浏览器 : `renderPlace(store, declaration, place, { viewer, look })` 答题 `{ html, css, title, found }` 清单、记录、申报地点或自成一体的家庭 在应用程序的外观中文档,没有脚本,在取景者的视线下,可打印(每个) )),其中的一栏为自有的一页. 它不输入React,所以一个工人重新给定 链接 – 作为 PDF 的列表 – 在每个更改上. `staticCss` 单是它的床单。 见 `docs/static-pages.md`。 。 。 .
    
-   **一个固定屏幕上的地方, 和它每个部分都做什么.** `@graview/pages/device`是因为 `renderScreen(store, declaration, place, { profile: "eink", viewport, viewer, page })` 在视图端口为电子链接阅读器绘制一个位置, 其主机名称为: 其颜色为十六个灰色( 主机将图片量化到其面板), 不 移动,没有悬浮,没有脚本,没有获取到任何东西, 键入手臂的长度, 每一个媒体在 至少64 px——在固定的布局下,框架本身就起作用了,在页面上是一个很长的地方. 它会回答的 `{ html, css, title, found, renderId, page, taps }`数字 : `taps` 每个可按 区域在取景器像素中的矩形及其作用(`go`, (中文(简体) ), `open`, (中文(简体) ), `act`, (中文(简体) ), `page`, (中文(简体) ), `refresh`),正是浏览器绘制的地方. `tapAt` a. 区域 点; `resolveTap` 说它现在做什么 一个可以交还给 `renderScreen`从来没有 要遵循的 URL —— 只有按下屏幕才能回答, 并且只在屏幕上运行一个动作 屏幕显示应用程序仍在为该座位绘制。 脚上的条是宣言的 `devices.screens`还有家和工作 还有酒吧 它不进口反应,所以 工人画;主机浏览器取相. 见 `docs/static-pages.md`。 。 。 .
    
-   **打开屏幕,从文档.** `@graview/pages/splash`是因为 `splashHtml(brand, { scheme?, name?, title?, kicker?, fade? })` 绘制文档 `brand.splash` —— 说 `plain`, (中文(简体) ), `editorial`, (中文(简体) ), `shader` (这里运出的一些荫道之一,取名: `shader`,从未写入文档)或 `ascii`,以一个像标志一样的图像,一个标题和一个踢球手——作为 `{ html, css, script }`: 主机在应用程序根之前插入其第一个 HTML 中的 3, 以及 剧本一说就把屏幕拿走了 `data-graview-drawn` (或者页面失效, 或15秒后通过),仍为减速运动. 它不进口任何东西,不是反射,不是 框架——所以一页的第一幅颜料从不等待在屏幕封面的捆绑上. `graview preview` 内含; 品牌没有 `splash` 回答空字符串。 屏幕 (一) 以其名称命名的地位; `title` 财务报告和审定财务报表 `kicker` 说一页自己的话 品牌,和 `fade: false` 把它当做自动化`navigator.webdriver`(中文(简体) ) 已经 阴道是 `drift`, (中文(简体) ), `ripple`, (中文(简体) ), `veil` 财务报告和审定财务报表 `caustics` (光从水出.
    

主机应用 `themeCss` 从 `@graview/primitives` (或自行供应) `--graview-*` ; 默认页面完全由这些符号渲染.

## 常见问题

### @graview/pages 是什么？

传统相貌:一种由同一声明所衍生出并驱动场景的路由网络app\.

### 如何安装 @graview/pages？

在项目目录运行 npm install @graview/pages，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.7）、react-dom（\>=19\.2\.7）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @graview/pages 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @graview/pages 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @graview/pages 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.22\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @graview/pages 可以商用吗？

@graview/pages 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @graview/pages 的下载量有多少？

根据 npm 官方下载统计，@graview/pages 在 2026/10/17 – 2026/11/15 这 30 天内被下载 9,657 次，日均约 322 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @graview/pages 还在维护吗？

最新版本 0\.2\.5 发布于 2026/11/16（今天）；至今共发布 77 个版本，其中过去 12 个月发布了 77 个；首次发布于 2026/10/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

