@aircall/blocks

中文文档
0.52.0发布于 2026/11/02ISCTypeScriptES Module近 30 天下载 2903

空中呼叫区块——在@aircall/ds上建造的更高层次的UI组成

中文使用文档

@ aircall/块

高级UI组成 @aircall/ds - 页面弹壳(DashboardPage 编号 : DashboardStandalonePage),形式层(useForm +该 Form*Field 种子图案表单 包装,空地状态,还有更多.

pnpm add @aircall/blocks @aircall/ds

从您的条目导入预编译的 CSS 一次 . @aircall/blocks/globals.css 已经 捆绑整个 @aircall/ds/globals.css - 这样做 没有 导入两者或复制全部 (Preflight,主题符号,所有DS公用事业):

// ✅ Correct — blocks already includes DS
import '@aircall/blocks/globals.css';

// ❌ Wrong — duplicates all of DS's compiled output
// import '@aircall/ds/globals.css';
// import '@aircall/blocks/globals.css';

如果您自己编写 Tailwind 工具类, 请使用 CSS 条目而不是 JS 导入 :

/* style.css */
@layer theme, base, components, utilities;
@import 'tailwindcss/theme.css' layer(theme);
@import 'tailwindcss/utilities.css' layer(utilities);
@import '@aircall/blocks/globals.css';
@source "./src/**/*.{ts,tsx}";

对于模块编译消费者(您的应用程序作为远程运行在已装入的主机内) DS/blocks Globals),完全省略了两个Globals的进口.

导入 @aircall/blocks 登记a blocks 启用 i18n 命名空间 @aircall/ds共享 i18next example. (原始内容存档于2018-09-29). 要按照用户的语言制作块字符串, 请挂载 DsI18nProvider (从) @aircall/ds(中文(简体) ) 下级 您的响应- i18next 提供者, 提供了活动语言 。 见 页:1 @aircall/ds 读取 aircall-ds/setup 为完整的提供者树提供技能.

人工智能人员——移徙 @dashboard/library? 吗?

这个包裹船 TanStack 意图 移徙技能 内 联合国 skills/ 目录( 在 npm tarball 中公布): aircall-blocks/migrate-dashboard (+ 每一地区的食谱) @dashboard/library 屏幕改为 @aircall/blocks 编号 : @aircall/ds附加时 aircall-blocks/setup启用它们(一次性,与 @aircall/ds:

pnpm add @aircall/blocks@latest @aircall/ds@latest @aircall/react-icons@latest # react-icons >= 0.4.0
npx @tanstack/intent install   # writes the discovery block into CLAUDE.md / AGENTS.md
# allowlist in package.json: { "intent": { "skills": ["@aircall/ds", "@aircall/blocks"] } }

然后,代理人按要求加载指导:

npx @tanstack/intent load "@aircall/blocks#aircall-blocks/migrate-dashboard"

aircall-blocks/setup 以 aircall-ds/setup因此,DS供应商, globals.css,以及 上面有记录的jsdom测试shims 这里也适用.

版本与发布记录

@aircall/blocks 共发布 54 个版本,首次发布于 2026/06/03;过去 12 个月发布了 54 个版本。

版本发布日期距今
0.52.0latest2026/11/025 天前
0.51.12026/11/025 天前
0.49.02026/10/1226 天前
0.47.02026/09/301 个月前
0.46.02026/09/301 个月前
0.45.02026/09/251 个月前

关于 @aircall/blocks 的常见问题

@aircall/blocks 是什么?

空中呼叫区块——在@aircall/ds上建造的更高层次的UI组成

如何安装 @aircall/blocks?

在项目目录运行 npm install @aircall/blocks,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、date-fns(^4.0.0)、react-dom(^18.0.0 || ^19.0.0)、@aircall/ds(*)、@aircall/hooks(*)、@base-ui/react(*)、@aircall/numbers(*)、react-day-picker(^9.0.0)、@aircall/react-icons(*)、class-variance-authority(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aircall/blocks 支持 TypeScript 吗?

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

@aircall/blocks 支持 ESM 还是 CommonJS?

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

@aircall/blocks 可以商用吗?

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

@aircall/blocks 的下载量有多少?

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

@aircall/blocks 还在维护吗?

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