@haatlabs-core/ui

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptES Module近 30 天下载 4676

对一个应用的仪表板进行回放组件,由应用软件来作风格.

中文使用文档
文档目录3 节
  1. 安装
  2. 仪表板的外观
  3. @haatlabs-core/ui/client

@haatlabs-core/ui (英语)

反应组件 apps 共享 。 字体、主题和颜色保留每个应用程序: 组件带有类名,每个应用程序的样式表样式也带有这些名称.

import { Drawer, EmptyState, FullScreen, Loading, SearchBox } from '@haatlabs-core/ui';
构成部分这是什么它使用的分类名称
EmptyState单子显示的是什么 当它没有:标题和下一步要做什么.empty
Loading占位符行数( E)rows)或被贴上辅助技术标签的旋转器.skeleton, (中文(简体) ), .skeleton-row, (中文(简体) ), .skeleton-box, (中文(简体) ), .skeleton-line, (中文(简体) ), .short, (中文(简体) ), .loading, (中文(简体) ), .spinner
Drawer一张卡片的详情附在其列表外,并附有其完整页面的链接; 越狱关闭它.drawer, (中文(简体) ), .drawer-bar, (中文(简体) ), .drawer-body, (中文(简体) ), .row, (中文(简体) ), .spread
FullScreen整个屏幕上的照片; 越狱或点击外部关闭.full-screen, (中文(简体) ), .full-screen-close
SearchBox电话 onSearch 与已修剪的句子一起键入暂停300毫秒.search-box

react, (中文(简体) ), react-dom 财务报告和审定财务报表 react-router-dom 是同伴: 使用该应用程序自己的副本.

安装

pnpm add @haatlabs-core/ui

这些软件包留给你的应用程序,所以应用程序持有一份: react, (中文(简体) ), react-dom, (中文(简体) ), react-router-dom, (中文(简体) ), @tanstack/react-query, (中文(简体) ), zod。 。 。 .

仪表板的外观

寻找每个 Haatlabs 仪表板: 一个侧边栏的应用程序外壳, 浅而暗的主题, 一个口音 每个产品.

import '@fontsource-variable/plus-jakarta-sans/index.css';
import '@fontsource/jetbrains-mono/500.css';
import { AppShell, ThemeStyles } from '@haatlabs-core/ui';

<ThemeStyles accent="indigo" />          // indigo, coral, teal, green, or { solid, textLight, … }
<AppShell
  brand={<Logo />}
  nav={[{ items: [{ label: 'Home', to: '/home' }] }, { label: 'Billing', items: [...] }]}
  account={{ name, detail: email, onSignOut, signingOut }}
  statusChip={<StatusChip to="/credits">₹480.00</StatusChip>}
>
  <Routes>…</Routes>
</AppShell>
  • 主题: 跟踪电脑的设定,直到有人在边栏取出暗光或光 切换;选择保留在浏览器中(haatlabs:theme) (中文(简体) ). 服务 THEME_BOOT_SCRIPT 作为 public/theme-boot.js 装入 <head> (单位:千美元)<script src="/theme-boot.js"></script>: 页面的 CSP 禁止内置脚本,没有它,暗页会闪出光线.
  • 脚指: --hl-* CSS变量(--hl-surface, (中文(简体) ), --hl-text, (中文(简体) ), --hl-accent,),每个 口音在两个主题中测试了4.5:1的对比.
  • 块: PageHeader, (中文(简体) ), Card, (中文(简体) ), Callout, (中文(简体) ), Checklist, (中文(简体) ), StatusChip, (中文(简体) ), ShellSearch。 。 。 .
  • 贝壳会离开 <main> ;其内容区域为 #main,跳过链接的目标.
  • 在应用程序中采用: 跳出 LoginPage是因为 accent编号 :glow 道具(主题的口音和链接) 颜色应用),并将应用程序自己的颜色变量指向主题 (单位:千美元)--surface: var(--hl-surface, #fff))),因此其页面遵循了黑暗的主题.

@haatlabs-core/ui/client

一个应用程序的页面用什么来与其API交谈,以及登录的页面:

  • createTransport({ baseUrl, credentials, fetch, envelope })数字 : call, (中文(简体) ), adminCall, (中文(简体) ), send, (中文(简体) ), queryOf. 书写带有CSRF头(x-csrf-token); 管理员的书写载 x-admin-csrf失败是 ApiError 与API的代码和状态.
  • cookieCredentials(appName):仪表板的会话饼干及其CSRF饼干 <appName>_csrf内部商店管理员,通过 { kind: 'bearer', getToken }。 。 。 .
  • createQueryClient(): 读取和写出网络上或带有5xx的失败已被尝试 - 最多两次 me 再来一次.
  • LoginPage({ client, aside }) 财务报告和审定财务报表 EmailSignInPanel({ client })签了密码, 并给一个商店 安装在Shoppify的电子邮件 与签名.

@tanstack/react-query 财务报告和审定财务报表 zod 是同龄人.

版本与发布记录

@haatlabs-core/ui 共发布 26 个版本,首次发布于 2026/11/07;过去 12 个月发布了 26 个版本。

版本发布日期距今
0.18.5latest2026/11/144 天前
0.18.42026/11/134 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/ui 的常见问题

@haatlabs-core/ui 是什么?

对一个应用的仪表板进行回放组件,由应用软件来作风格.

如何安装 @haatlabs-core/ui?

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

@haatlabs-core/ui 支持 TypeScript 吗?

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

@haatlabs-core/ui 支持 ESM 还是 CommonJS?

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

@haatlabs-core/ui 需要什么版本的 Node.js?

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

@haatlabs-core/ui 可以商用吗?

@haatlabs-core/ui 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/ui 的下载量有多少?

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

@haatlabs-core/ui 还在维护吗?

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