@adecore/ui

中文文档
0.57.0发布于 2026/11/08FSL-1.1-MITTypeScriptES Module构建来源已验证近 30 天下载 2.3万

React 组件,一个主题,格式化器和一个设置对话框,用于React 19, Base UI和Tailwind 4上的桌面级应用程序.

中文使用文档
文档目录6 节
  1. 安装
  2. 设置
  3. 工作空间
  4. 入境点
  5. 文档
  6. 许可证

@ adcore/ ui (英语)

npm Docs

对表现类似桌面软件的应用程序进行回放组件:带有快捷键的菜单,对话框上的对话,工具提示,字段,土司和一个设置对话框. 每个数字和日期都通过遵循语言的格式器和一个人物设定的区域,一个符号主题将其全部画出. 建于反应19上, 基础UI, (中文(简体) ), 卢西德 尾风4.

对每个组件进行现场演示的文件

安装

bun add @adecore/ui

反应19, react-dom, (中文(简体) ), i18next 财务报告和审定财务报表 react-i18next 是同伴的依赖关系; 应用程序带来了它们.

设置

在 Tailwind 之后导入主题, 让 Tailwind 为它使用的类扫描库 。 这个 @source 路径相对 CSS 文件.

@import "tailwindcss";
@import "@adecore/ui/theme.css";
@source "../node_modules/@adecore/ui/dist";

将应用程序包入 UIProvider 一次,高于图书馆的第一部分。 它在应用的i18next(英语和荷兰语的"飞船")中添加了图书馆的词,将格式化者交给他们 格式来源 并挂载工具提示提供者.

import i18next from 'i18next';
import { UIProvider } from '@adecore/ui';

createRoot(root).render(
    <UIProvider i18n={i18next} formatSource={formatSource}>
        <App />
    </UIProvider>
);

从那里,每个组件都可以使用:

<Menu.Root>
    <IconButton icon={Ellipsis} label="More" render={<Menu.Trigger />} />
    <Menu.Popup align="end">
        <Menu.Item onClick={rename}>
            Rename <Kbd shortcut={KEY_SHORTCUTS.rename} />
        </Menu.Item>
        <Menu.Item onClick={remove}>Remove</Menu.Item>
    </Menu.Popup>
</Menu.Root>

开始 覆盖了其余部分:格式源,一种第三语言,可选的棋子和如何进行本地取出的工作.

工作空间

Workspace 设置一个工具栏、边区和内容,以标准或房间布局. SplitView 以文档标签嵌入可调整面板,以及 TabStrip 绘制标签。 一个视图移动到另一个面板时会挂起。 应用程序保持文档状态, 决定是否关闭标签并保存版式 。 这个 工作空间指南 覆盖可控布局模式,并有演示.

入境点

导入它所持有的
@adecore/ui部件、钩子和助手
@adecore/ui/settingsSettingsDialog 和窗帘部分
@adecore/ui/format数字、日期、期限和区域,以及 setFormatSource
@adecore/ui/testing应用测试的假象,例如 fakeFormatSource()
@adecore/ui/testing/dedupeA 类 bun test 连接到退出的应用程序预装
@adecore/ui/theme.css主题

没有别的是公开的。 没有任何模块在导入上起作用,所以捆绑机只保留应用程序的用途.

文档

页次它包含什么
开始安装,主题, UIProvider,格式源和一个本地取出
原则从类型尺度到键盘焦点
主题光和暗的每个标志, 如何设置口音
构成部分在侧边栏中分组的每个组件有活演示的一页
格式化数字、日期、期限和区域
测试应用程序测试的假冒和链接检出预装

许可证

FSL-1.1-MIT,见 自由主义。 。 。 .

版本与发布记录

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

版本发布日期距今
0.57.0latest2026/11/08今天
0.56.42026/11/07今天
0.56.32026/11/07今天
0.56.22026/11/07今天
0.56.12026/11/07今天
0.56.02026/11/07今天

其他发布通道:next → 0.17.0-beta.2。

关于 @adecore/ui 的常见问题

@adecore/ui 是什么?

React 组件,一个主题,格式化器和一个设置对话框,用于React 19, Base UI和Tailwind 4上的桌面级应用程序.

如何安装 @adecore/ui?

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

@adecore/ui 支持 TypeScript 吗?

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

@adecore/ui 支持 ESM 还是 CommonJS?

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

@adecore/ui 可以商用吗?

@adecore/ui 使用 FSL-1.1-MIT 许可。声明的许可为 FSL-1.1-MIT,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@adecore/ui 的下载量有多少?

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

@adecore/ui 还在维护吗?

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