@glimstone/react

中文文档
4.5.4发布于 2026/11/16AGPL-3.0-onlyTypeScriptES Module近 30 天下载 3918

GlimStone 用于反应的组件

中文使用文档
文档目录4 节
  1. 用这个
  2. 这是什么
  3. 这里有什么
  4. 信息砖

@ glimstone/ 反应

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

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

用这个

npm install @glimstone/core @glimstone/react
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带有版本、帮助和关于卡片的相接相接的相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相相相接相接相接相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相
ReadmeButtonREADME 形状的按钮及其片段
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, (中文(简体) ), FortressPermissionsApp'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 共发布 22 个版本,首次发布于 2026/11/04;过去 12 个月发布了 22 个版本。

版本发布日期距今
4.5.4latest2026/11/16今天
4.5.32026/11/16今天
4.5.22026/11/161 天前
4.5.12026/11/151 天前
4.5.02026/11/151 天前
4.4.12026/11/142 天前

关于 @glimstone/react 的常见问题

@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 和提交记录判断。