# @glimstone/react 中文文档

规范地址：https://npmcn.com/package/%40glimstone/react/

版本：4\.5\.4
npm 元数据更新时间：2026-11-16T14:51:23.980Z
中文译文更新时间：2026-11-16T15:58:55.104Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40glimstone/react
原文对照：https://npmcn.com/package/%40glimstone/react/?lang=original
项目主页：https://junkerderprovinz.github.io/glimstone/
源码仓库：https://github.com/junkerderprovinz/glimstone

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

- 包体积（解压后）：333 kB，180 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0，@zag-js/menu ^1\.48\.0，@zag-js/tour ^1\.48\.0，@zag-js/react ^1\.48\.0，@zag-js/steps ^1\.48\.0，@zag-js/timer ^1\.48\.0，@zag-js/avatar ^1\.48\.0，@zag-js/select ^1\.48\.0，@zag-js/slider ^1\.48\.0，@zag-js/marquee ^1\.48\.0，@zag-js/carousel ^1\.48\.0，@zag-js/combobox ^1\.48\.0，@zag-js/splitter ^1\.48\.0，@zag-js/accordion ^1\.48\.0，@zag-js/pin-input ^1\.48\.0，@zag-js/hover-card ^1\.48\.0，@zag-js/pagination ^1\.48\.0，@zag-js/tags-input ^1\.48\.0，@zag-js/collapsible ^1\.48\.0，@zag-js/date-picker ^1\.48\.0，@zag-js/file-upload ^1\.48\.0，@zag-js/scroll-area ^1\.48\.0，@zag-js/angle-slider ^1\.48\.0，@zag-js/rating-group ^1\.48\.0，@zag-js/signature-pad ^1\.48\.0，@zag-js/floating-panel ^1\.48\.0，@internationalized/date ^3\.12\.4
- 首次发布：2026-11-03T16:09:14.479Z
- 最新版本发布：2026-11-16T14:51:23.524Z
- 近 30 天下载量：3918（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

GlimStone 用于反应的组件

## 安装

```sh
npm install @glimstone/react
```

也可以使用：`pnpm add @glimstone/react`、`yarn add @glimstone/react`、`bun add @glimstone/react`

## README

# @ glimstone/ 反应

构成部分 [胶质](https://junkerderprovinz.github.io/glimstone/) 页:1 反应19. `@glimstone/core` 说一个控制必须是什么样子 并决定什么 它显示。这些 说一个控制 **实值**,所以一个应用程序使用它们而不是 重建他们.

这种区别是这一一揽子方案存在的原因。 两个应用软件 单是散文就以两种不同的方言得出了相同的设计语言: 一 呼叫开关 `Toggle` 并保持它在 `components/Toggle.tsx`,另一个 说吧 `Switch` 并把它留在一个 `Field.tsx` 辅助其他六个控制; 一个是 `ConfirmDialog`,另一个有 `Confirm`所有这一切都是正确的 阅读同一文件,然后必须重新适用每一项规则 每个方言都用手.

## 用这个

```sh
npm install @glimstone/core @glimstone/react
```

```tsx
import "@glimstone/core/tokens.css";
import { applyCachedAppearance, applyStoredLabelModes } from "@glimstone/core";
import { Button, setGlyphResolver } from "@glimstone/react";
import { Select } from "@glimstone/react/Select";

applyCachedAppearance();
applyStoredLabelModes();
setGlyphResolver((key) => appGlyphs[key]);
```

打给两个 `apply` 函数在第一个渲染器前的 app 根,而不是 从编辑它们的设置页面中, 或应用程序在默认外观中打开 并停下来. `setStoragePrefix()` 在他们选择应用程序之前 以自己的名义储存。 在 Tailwind v4 负载下 `@glimstone/core/tailwind-theme.css` 符号后; 组件本身 不要用尾风课.

`Select`, (中文(简体) ), `Combobox` 财务报告和审定财务报表 `Slider` 从他们自己的条目和需要 `@zag-js/react` 及其机器软件包(`@zag-js/select` 财务报告和审定财务报表 `@zag-js/menu`, (中文(简体) ), `@zag-js/combobox`, (中文(简体) ), `@zag-js/slider`) (中文(简体) ). 剩下的东西 不需要他们.

## 这是什么

| 构成部分 | 这是什么 |
| --- | --- |
| `Button` | 每个按钮,包括标签引擎的文本/glyph/两种模式和芯片形式 |
| `Toggle` | 开关 永远没有复选框 |
| `Card` | 地表 和划出一个方向的地方 |
| `Badge` | 状态药丸和卡片的填充部分 |
| `Select` | 在Zag的精选机上 和它的菜单机上 |
| `Combobox` | 将长列表过滤为某人的字段 |
| `Slider` | 区域上的值, 标签旁的文字值 |
| `DropdownListbox` | 折旧、使用 `Select` |
| `ConfirmDialog` + 键 `useConfirm` | 确定一个破坏性动作的表面, 和给它一个传送门的钩子, Escape, Tab 陷阱, 并聚焦回要求的控制器 |
| `ToastViewport` | 瞬间反馈; 队列是核心的 `toastEngine` |
| `InfoBubble`, (中文(简体) ), `IconTipButton` | “ (一) ” 解释和唯一图标控件上的悬空名称 |
| `InfoTile` | 带有版本、帮助和关于卡片的相接相接的相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相相相接相接相接相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 |
| `ReadmeButton` | README 形状的按钮及其片段 |
| `CryptoDonateDialog`, (中文(简体) ), `CoffeeDialog`, (中文(简体) ), `PaypalDialog` | 三个窗口 |
| `Selector` | 横向选择器:标签、过滤栏、分块取取出器、一个或多个值,以及 `orientation="vertical"` 设置区域页面旁的牌列 |
| `NumberField` | 一个在球场和轮子内有两个后台的号码,同时它有焦点 |
| `SidebarRow` | 栏杆一行:glyph,以标签模式标出单词,当前页面和一个计数 |
| `EmptyState` | 列表、表或面板显示什么,当它没有 |
| `SubCard` | 卡片内装入的套接字组,替换折叠出局 |
| `UnavailableNotice` | 当环境完全禁止的时候 控制会是什么样子 |
| `WindowBar` | 桌面应用程序在 Windows 和 Linux 上的标题栏 |
| `Window` | 普通窗口:标题 Notch, 任意添加的正文和脚; 窗口堆栈 |
| `ContextMenu`, (中文(简体) ), `MenuBar` | 一个点的菜单和一个头条的菜单行,有子菜单,行会勾出一个框,选择,键盖和计数. 用指针打开后, 第一行仅在按下键后显示其环 |
| `Checkbox` | "别再出现"的画框 以及一起应用的选择, `slim` 在一个稠密的行里, 每个设定都是 `Toggle` |
| `Kbd`, (中文(简体) ), `Pill` | 密钥盖和列表行的静态数据平面 |
| `TextField`, (中文(简体) ), `TextArea` | 以行需要的宽度表示 `error` 对于他们无法接受的价值 |
| `FieldError` | 对于应用程序本身的字段, 字段下的线条是它无法承受的 |
| `FieldRow`, (中文(简体) ), `FieldRowGroup` | 被贴上标签的一行:名称以"(一)"为开头,控制于其结尾,由行来命名,或作为一粒药丸的单独值,并有一行为他们的名字共用一列. `useFieldName` 给一个应用程序自己的控制 同一名称 |
| `GlyphField` | 里面有胶片的字段,如过滤器,然后在盒子里控制 |
| `Table` | 各栏中的事实简介 |
| `PasswordField`, (中文(简体) ), `CopyField` | 一个在球场内有显眼的秘密 一个在单相间有复制的按钮的值 |
| `Fortress`, (中文(简体) ), `FortressPairing`, (中文(简体) ), `InstanceCard`, (中文(简体) ), `FortressAppCard`, (中文(简体) ), `FortressPermissions` | App's Ectorys分页中的要塞: app's own cards as children, 其它应用的开关, 每套应用的开卡, 每套应用的开出一行, 每套应用的开关, 以及加入短语的窗口, 删除一个实例并显示在它的QR代码旁边的短语. `FortressPairing` 是在对等设置中修改短语和句子的卡片 |
| `SignInCard`, (中文(简体) ), `SignInField` | 登录页:应用的标志和名称,密码,当应用请求一个时的代码,密码和同名卡中的重置表. 应用程序自己的字段,按钮和步骤进入 `fields`, (中文(简体) ), `actions` 财务报告和审定财务报表 `step`,以及 `SignInField` 给出应用程序上方的标签 |
| `PathField`, (中文(简体) ), `Tree` | 用按钮询问应用程序的路径, 打开时加载的层次, 用于按钮后面的拾取者 |
| `ListRow`, (中文(简体) ), `RowMark`, (中文(简体) ), `GlyphTile` | 一行有瓦片、徽章和按钮的列表 悬浮在其中的一行,一行的圆标被选为对许多人的动作,一个小手持为格言 |
| `ListTable` | 列表页面列表: 点击标题排序, 每列过滤器, 在其内浮动的搜索, 并按文件管理器选择行 |
| `IconButton` | 每个标签模式的正方形上的一个格言,用于保留其文本的行,作为链接 `href`,打开或关闭 `pressed`,以及 `absent` 以按住缺失按钮的位置 |
| `Meter`, (中文(简体) ), `ProgressBar` | 诸如磁盘等级别,从阈值起为红色 `quiet` 以一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平一平 只有条子移动 |
| `BusyRing`, (中文(简体) ), `SkeletonRow` | 当应用程序在某事上工作时会转动的环,以及一行在列表加载时会持有列表行位置的环. 两只都只有400毫秒 |
| `Popover`, (中文(简体) ), `Sheet` | 一个小面板旁边的触发器在上层, 一个面板在一行细节的端边, a `<dialog>` 以窗口脚显示模式 |
| `ColorPicker` | 平方形、 花花条、 带有颜色名称的预览、 十六进制字段和应用程序, 在页面中或浮在它的表边 |
| `useLabelMode`, (中文(简体) ), `useTipBubble`, (中文(简体) ), `usePortalHue` | 部件需要的小钩子 |
| `glyphs` | 标记组件自己绘制,以及 `setGlyphResolver`,将一个应用程序连接起来,注册它自己设置的图标 |

## 这里有什么

**图标集.** 图标的含义属于应用程序: 只有它知道它 自己的动作被称为"现在备份". 格利姆斯通号舰船 规格 (`glyphs.md` 和一项职能, `setGlyphResolver`, (中文(简体) ), 按钮问的意思。 在启动时注册,每个按钮都可以 显示为 glyph 模式; 跳过它, 按钮会倒回 被交接的 glyph 模式, 然后单独发短信.

**翻译.** 每个字符串都是道具. 这些部件带有命令和命令 行为,应用程序带有自己的语言.

**数据.** 没有组件获取任何信息 。 版本卡取其版本 作为道具及其更新检查作为函数而不是读取健康 端点,所以同一组件服务于一个不同的应用程序.

## 信息砖

`InfoTile` 每张牌取一个道具对象和一个 `hueIndex` 第一届 他们;其他人采取下一个立场。 它不带卡就还牌 包装器,所以它们堆积在页面本身的节奏.

-   **版本 :** `rows` 首先列出应用程序,然后列出GlimStone和每个组件 应用船,每艘都有 `name`,可选 `sub` 线条 `version` 读取 从建筑和 `repoUrl` 其发布页 数字打开。 一行 , 继续 无 `repoUrl`,或不是出版发行的建筑,显示 编号为纯文本。 GlimStone 一行套装 `latest`,因此其数字打开 最新发布时间 `GLIMSTONE_RELEASE_URL`。 。 。 . `updateCheck.run` 检查他们所有 并决心如何 许多人有新版本;按钮转动 `ok` 与 `upToDate`, (中文(简体) ), `warn` 与 `updatesFound(n)`,或 `danger` 与 `checkFailed` 当它拒绝的时候,它将震动. 应用程序把失败的原因 放在它的土司。 一个扣子 检查前: `whatsNew`,该应用程序自己的"New ^ n"按钮,该按钮打开其 窗口,以发布注释和更改为制表符,或者,在一个应用程序中 标记无更改,“释放注释”来自 `onReleaseNotes` 与 `text.releaseNotes`打开笔记。 这张卡从不画两者.
-   **帮助 :** 报告句, GitHub, 与 `IconDiscord` 作为 `discordGlyph` 当句子名称 Discord 和 `discordUrl` 财务报告和审定财务报表 `text.discordButton` 设置,电子邮件为 `MAIL_SVG` 当 句子名称 `mailAddress` 设定, 手册何时 `manualUrl` 财务报告和审定财务报表 `text.manual` 设置,与 `MANUAL_SVG` 作为 `manualGlyph` 财务报告和审定财务报表 "打开"作为 `text.manualSub`,并且错误报告何时 `onBugReport` 财务报告和审定财务报表 `text.bugReport` 设置,与 `IconDiagnostics` 作为 `bugGlyph` 和"下载" 作为 `text.bugReportSub`。 。 。 .
-   **关于:** 制造者的句子,然后用 给排在它下面.

更新检查的格子来自应用程序的解析器 `about.checkUpdates`, (中文(简体) ), `about.upToDate`, (中文(简体) ), `about.updatesFound` 财务报告和审定财务报表 `about.checkFailed`,在"释放笔记"下 `about.releaseNotes`。 。 。 .

## 常见问题

### @glimstone/react 是什么？

GlimStone 用于反应的组件

### 如何安装 @glimstone/react？

在项目目录运行 npm install @glimstone/react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、react-dom（^19\.0\.0）、@zag-js/menu（^1\.48\.0）、@zag-js/tour（^1\.48\.0）、@zag-js/react（^1\.48\.0）、@zag-js/steps（^1\.48\.0）、@zag-js/timer（^1\.48\.0）、@zag-js/avatar（^1\.48\.0）、@zag-js/select（^1\.48\.0）、@zag-js/slider（^1\.48\.0）、@zag-js/marquee（^1\.48\.0）、@zag-js/carousel（^1\.48\.0）、@zag-js/combobox（^1\.48\.0）、@zag-js/splitter（^1\.48\.0）、@zag-js/accordion（^1\.48\.0）、@zag-js/pin-input（^1\.48\.0）、@zag-js/hover-card（^1\.48\.0）、@zag-js/pagination（^1\.48\.0）、@zag-js/tags-input（^1\.48\.0）、@zag-js/collapsible（^1\.48\.0）、@zag-js/date-picker（^1\.48\.0）、@zag-js/file-upload（^1\.48\.0）、@zag-js/scroll-area（^1\.48\.0）、@zag-js/angle-slider（^1\.48\.0）、@zag-js/rating-group（^1\.48\.0）、@zag-js/signature-pad（^1\.48\.0）、@zag-js/floating-panel（^1\.48\.0）、@internationalized/date（^3\.12\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @glimstone/react 支持 TypeScript 吗？

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

### @glimstone/react 支持 ESM 还是 CommonJS？

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

### @glimstone/react 可以商用吗？

@glimstone/react 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @glimstone/react 的下载量有多少？

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

### @glimstone/react 还在维护吗？

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

