# @graview/primitives 中文文档

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

版本：0\.2\.5
npm 元数据更新时间：2026-11-16T13:17:14.403Z
中文译文更新时间：2026-11-17T01:41:19.715Z
软件包许可：Elastic-2\.0

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

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

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

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

## 中文简介

原始的设定,镜头,工作台和视觉系统.

## 安装

```sh
npm install @graview/primitives
```

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

## README

# @ graview/ 原始内容

一个丰富的原始相机,6个镜头,工作台和视觉系统.

**初级** —— 说 `Panel`, (中文(简体) ), `Chip`, (中文(简体) ), `Roster`, (中文(简体) ), `Grid`, (中文(简体) ), `Axis`, (中文(简体) ), `Connector`, (中文(简体) ), `Aggregate`, (中文(简体) ), `Fields`. 足以使新的节点类型在任何方面都变得明智 3个忠诚的人之前,谁写一个观点.

**镜头** ——时间表,日历,覆盖矩阵,板子,计划和状态板. 每个都把ROLES绑在应用程序的田地或种类上 所以一个镜头写给一个 域名被另一个域所重用,而不对其了解。 所有六个是 由大众原始人创造 这使得他们成为了 授权API而不是特权内幕. 画盘时 每个插槽的代码是3个字符或更少 和符号——一个药丸大小到 当任何代码更长时,它里面的字眼,即占地者; `arrange: "shelf"` 设置一个理事会,其x和y作为头带分类。 这个 状态板`columns`) 绘制一个选择字段的值,作为列,在其 命令,并只按动作移动卡片——按键盘或拖动 设置该字段的席位可能运行: “ 书” 等命名步骤到它自己的位置 列中,如果其条件符合该卡,否则一项行为告知 数值.

一个覆盖单元格在一个路径上选择它加入的内容——它的行,它的列和 之间的记录(`data-graview-joins`——并画出该过境点的分界线到 列名和列头.

**一条规则是看似可以承受的.** 胶囊是读者可以选择的选择 做,或唱片的州徽, 没有别的是一个: 在一组选择中 被选中的人戴着它,其余的都是要按的词. 地点 (单位:千美元)`Places`)是滚动的文本标签,当前一个下划线,在每页 宽度。 名字从不剪接到读取的地方: 它剪去它的徽章或进步, 驱动器的马克说它的显示由 名称,而故意切除的东西则将其全名作为标题 可访问名称.

**工作区** ——与域无关的界面部分:何为 以及可以做什么 规则是否有效 发生的事 以及如何把它带回去 如何从景色中退后 所有来源于 计划, 变化无常和操作日志.

**应用程序说一次** —— 说 `AppBar`:每张脸上都放一巴(FR-131)—— 品牌标记(`AppMark`,按给定抽取,绝不是一个SVG能够采取行动)并 该应用程序的名称作为页面的走向, 开关在现场和 页面`faces`fR-137),你作为一个控制者所在的地方 打开每个地方( o)`barPlaces`:家,列表,图片,FR-138; 现场 `useScenePlaces`:所有东西和每张照片,FR-144), 站立在排位上的位置 其余的放在"更"下面 (单位:千美元)`placesThatStand`,FR-145), (法语), 和三种大小相同的工具: 脸放进去了`useBarFind`, (中文(简体) ), `Standing` 财务报告和审定财务报表 `Profile`。 。 。 . `AppTitle` 绘图 标记、名称和下面的行; `useFavicon` 是一个 脸部是主页.

**视觉系统** —— 说 `themeCss(scheme, brand)`两种方案不是 二. 相互倒置:黑暗失去光辉,光照失去对比和收益 烟雾. 一个品牌供应自己的和 `graview check` 测量它。 床单是 三个部分: `themeBaseCss`每张脸都得靠什么; `viewsCss`,块 绘制出一个图谱,每个图谱上都画出一个图谱; 财务报告和审定财务报表 `sceneCss`,规则只有场景绘制(从高地开始的区域, 地块,村落,广告牌, 一个嵌入的场景的脸画 除了它,所以页面上的一页 面部没有他们.

## 设计语言

三层,一个组件只读中层:

| 层 | 何处 | 它所持有的 |
| --- | --- | --- |
| 身份 | @graview/core(设计包,03修订版) | En Dash海军#001769和turquise#00E5B9,纸上#F7F7F2,墨子#18213A,哑音#586174;蒙特塞拉特550,450和600;同机符号 |
| 语义符号 | `themeCss` 把它们写为自定义属性 | 地表(`--graview-ground`, (中文(简体) ), `-panel`, (中文(简体) ), `-panel-muted`, (中文(简体) ), `-panel-warning`, (中文(简体) ), `-bar`, (中文(简体) ), `-float`页:1`--graview-ink`, (中文(简体) ), `-ink-muted`, (中文(简体) ), `-ink-faint`),互动(`--graview-accent`, (中文(简体) ), `-accent-dim`, (中文(简体) ), `-accent-ink`, (中文(简体) ), `-edge`, (中文(简体) ), `-edge-bright`),状态(`--graview-warn`, (中文(简体) ), `-good`, (中文(简体) ), `-bad`),类型(`--graview-font-body`, (中文(简体) ), `-display`, (中文(简体) ), `-mono`, (中文(简体) ), `--graview-weight-display`, (中文(简体) ), `-body`, (中文(简体) ), `-label`),形状(`--graview-radius`, (中文(简体) ), `-radius-sm`, (中文(简体) ), `-pad`, (中文(简体) ), `-pad-sm`, (中文(简体) ), `-gap`), 深度 (中文(简体) )`--graview-lift-low`, (中文(简体) ), `-lift-high`, (中文(简体) ), `--graview-layer-*`)和工具包(e`--graview-kit-*`(中文(简体) ) |
| 应用程序的覆盖 | 该应用的品牌 | 名称 标志 页面图标 两种方案的标志 面相和分量 半径和密度 一种颜色 套件 |

运出的计划基于身份: 纸张,读取墨水和海军 光线,一个深厚的海军地 加上海军的呼声 在黑暗中使光. 既不涂抹洗涤,也不涂发光. 绿宝石根本不是象征:它是符号的点,一个填充是 从来没有文本(1.5:1在纸上;海军在9:7:1上读取),所以没有 框架的绘制取决于它。 宣布自己品牌的应用软件 拥有颜色,面相和标志,框架从不将Graview的标记放入其中.

场景如何与任何地区的颜色相抗衡: 品牌(`accents`)或稳定散列,仅指: block的3个面孔 下方的地块是现场的 所以一个块读 作为两个理由的一个街区。 选择和键盘的位置在 口音,作为一个轮廓 从块起起,从来没有改变 所以海军区的一个小区 仍然读作 选中 。 从另一种模式、端口和 宽度及其颜色以及每个区、区块和关系 它的名字在文字上,所以没有 单独用颜色说。 残疾是阴暗的 无法按下控件; 表示为空、 装入和拒绝 语句.

在蒙特塞拉特,当东道主拥有这些文字时,在读者中 系统 sans 其它: 框架命名了面部, 从未取出. 一个主机想要它进口一次可选副本—— `import "@graview/primitives/montserrat.css"`, 32 KB 个重 400–700,拉丁文,由SIL Open Font License (在包中除以). `GraviewMark` 是绘制 Graview 自己身份的主机的符号—— a 签名,一个托管服务的染色体 —— 内含在它的墨水中 点 `--graview-mark-point` 设定时,装饰,除非给定 `title`, (中文(简体) ), 和光学微切 在28px下.

## 常见问题

### @graview/primitives 是什么？

原始的设定,镜头,工作台和视觉系统\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

