@_linked/primitives

中文文档
1.10.0发布于 2026/10/28MITTypeScriptES Module构建来源已验证近 30 天下载 3331

一个UI组件库:一个无头行为源(Radix UI,cmdk,vaul,或手写)外加一个CSS模块来读取QQ链接/cs设计符文——对数据,形状,或任何特定应用程序都没有了解.

中文使用文档
文档目录4 节
  1. 这里的东西
  2. 其所坐处
  3. 他们
  4. 撰写

@_linked/primitives

一个UI组件库:一个无头行为源,一个CSS模块,没有其他的.

这里的东西

本套装中的每一个组件都是三件事,而不再是:

  1. 无头行为源 —— 说 Radix 用户界面 对于他们大多数人来说, 缩略语 页:1 Command, (中文(简体) ), MultiSelect,以及 Combobox, (中文(简体) ), 输入- otp 页:1 InputOTP, (中文(简体) ), 阴道 页:1 Drawer或手写,但其中无一人有答案Input, (中文(简体) ), Textarea, (中文(简体) ), Heading, (中文(简体) ), Text, (中文(简体) ), Spinner, (中文(简体) ), RelativeTime) (中文(简体) ).
  2. 一个CSS模块 读取设计符号 @_linked/css 并且未定义任何颜色, 相间或自有光线.
  3. 不了解数据、形状或任何特定应用.

第三点是决定事物是否属于这里。 三个问题, 如果对这三项的回答是否定的,则一个组成部分才有资格:

  • 是读还是写数据?
  • 知道SHACL的形状是什么吗?
  • 它是否知道某一具体产品的词汇——状态、核查水平, 域特有徽章变体?

一个需要这些部件的部件 上一层 某样东西使 任意 形状 属于形状驱动的地层; 使 一个产品 概念属于 在产品.

其所坐处

层软件包已经知道
设计符号@_linked/css无 – CSS 自定义属性
无头组件@_linked/primitivesdOM 和标志
数据绑定@_linked/react形状和查询; 无部件的船舶
形状驱动 UI@_linked/ui如何制造任意形状
产品表面申请其自己的域名词汇

分层是阻止同一组件被写出三次的原因. 当a 组件没有显示主机,它会被复制——然后复制漂移.

他们

组件从不硬码值 。 每个都读取回落的组件范围变量 给语义符号:

.Root {
  background: var(--dialog-content-bg, var(--modal-bg));
}

所以,一个组件 使理智的只有 @_linked/css 导入, 应用程序重新皮肤 通过设置语义符号,一个实例可以通过设置 组件范围 1。 见 @_linked/css样式指南 用于符号词汇和所需的导入顺序.

撰写

见 docs/component-authoring-guide.md 在用于槽命名的工作空间根中 符号倒置模式,以及语义映射表.

版本与发布记录

@_linked/primitives 共发布 31 个版本,首次发布于 2026/04/23;过去 12 个月发布了 31 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.10.0latest2026/10/2810 天前
1.9.12026/10/2513 天前
1.9.02026/10/2216 天前
1.8.32026/10/1919 天前
1.8.22026/10/1425 天前
1.8.12026/10/1325 天前

关于 @_linked/primitives 的常见问题

@_linked/primitives 是什么?

一个UI组件库:一个无头行为源(Radix UI,cmdk,vaul,或手写)外加一个CSS模块来读取QQ链接/cs设计符文——对数据,形状,或任何特定应用程序都没有了解.

如何安装 @_linked/primitives?

在项目目录运行 npm install @_linked/primitives,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.2.0 || ^19.0.0)、react-dom(^18.2.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@_linked/primitives 支持 TypeScript 吗?

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

@_linked/primitives 支持 ESM 还是 CommonJS?

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

@_linked/primitives 可以商用吗?

@_linked/primitives 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@_linked/primitives 的下载量有多少?

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

@_linked/primitives 还在维护吗?

最新版本 1.10.0 发布于 2026/10/28(10 天前);至今共发布 31 个版本,其中过去 12 个月发布了 31 个;首次发布于 2026/04/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。