@calcom/cal-sans-ui

中文文档
1.3.0发布于 2026/03/18OFL-1.1TypeScriptES Module零依赖近 30 天下载 1.4万

Cal Sans UI, Cal Sans Text, 以及 Cal Sans Geo 用于 Cal.com 界面

中文使用文档
文档目录9 节
  1. 安装
  2. 与 Next.js 一起使用
  3. Next.js 配置(Next.js < 15)
  4. 应用路由器
  5. 页面路由器
  6. 有尾风CSS
  7. 非下一个js(Vite、CRA等)
  8. 出口
  9. 许可证

@calcom/cal-sans-ui (英语)

Cal Sans UI, Cal Sans Text, 和 Cal Sans Geo 类型面 Cal.com (英语)。 。 。 .

安装

npm install @calcom/cal-sans-ui

下一个.js: 相邻依赖

与 Next.js 一起使用

Next.js 配置(Next.js < 15)

添加 transpilePackages 改为 next.config.js 或者说 next.config.mjs数字 :

/** @type {import('next').NextConfig} */
const nextConfig = {
  transpilePackages: ["@calcom/cal-sans-ui"],
};

export default nextConfig;

应用路由器

单位 app/layout.js 或者说 app/layout.tsx数字 :

import { CalSansUI } from "@calcom/cal-sans-ui/ui";
import { CalSansText } from "@calcom/cal-sans-ui/text";
import { CalSansGeo } from "@calcom/cal-sans-ui/geo";

export default function RootLayout({ children }) {
  return (
    <html lang="en" className={`${CalSansUI.variable} ${CalSansText.variable} ${CalSansGeo.variable}`}>
      <body>{children}</body>
    </html>
  );
}

页面路由器

单位 pages/_app.js数字 :

import { CalSansUI } from "@calcom/cal-sans-ui/ui";

export default function MyApp({ Component, pageProps }) {
  return (
    <main className={CalSansUI.className}>
      <Component {...pageProps} />
    </main>
  );
}

有尾风CSS

将 Cal Sans 映射到 Tailwind 的主题变量, 这样您就可以使用 font-sans (身体),(身体),(身体), font-heading (标题),和 font-display (乔治):

尾风 v4 – 说吧 – tailwind.css数字 :

@theme {
  --font-sans: var(--font-cal-sans-ui), ui-sans-serif, sans-serif;
  --font-heading: var(--font-cal-sans-text), ui-sans-serif, sans-serif;
  --font-display: var(--font-cal-sans-geo), ui-sans-serif, sans-serif;
}

尾风 v3 – 说吧 – tailwind.config.js数字 :

module.exports = {
  theme: {
    extend: {
      fontFamily: {
        sans: ["var(--font-cal-sans-ui)", "sans-serif"],
        heading: ["var(--font-cal-sans-text)", "sans-serif"],
        display: ["var(--font-cal-sans-geo)", "sans-serif"],
      },
    },
  },
};

组件的使用:

<p className="font-sans">Body text uses Cal Sans UI</p>
<h1 className="font-heading">Headings use Cal Sans Text</h1>
<h1 className="font-display">Display text uses Cal Sans Geo</h1>

对于GEOM轴(例如子标题):

<h2 className="font-heading" style={{ fontVariationSettings: '"GEOM" 50' }}>
  Subheading
</h2>

非下一个js(Vite、CRA等)

import "@calcom/cal-sans-ui/ui.css";
import "@calcom/cal-sans-ui/text.css";
import "@calcom/cal-sans-ui/geo.css";
h1 {
  font-family: "Cal Sans Text", sans-serif;
  font-variation-settings: "GEOM" 50;
}

p {
  font-family: "Cal Sans UI", sans-serif;
  font-variation-settings: "GEOM" 0;
}

对于不支持可变字体的浏览器: import "@calcom/cal-sans-ui/ui-non-variable.css"

出口

导入说明
@calcom/cal-sans-ui下一个 : CalSansUI, (中文(简体) ), CalSansUINonVariable, (中文(简体) ), CalSansText, (中文(简体) ), CalSansGeo (皆为一. 偏爱.
@calcom/cal-sans-ui/ui下一个 : CalSansUI (可变).
@calcom/cal-sans-ui/ui-non-variable下一个 : CalSansUINonVariable (静态UI).
@calcom/cal-sans-ui/text下一个 : CalSansText (可变子标题).
@calcom/cal-sans-ui/geo下一个 : CalSansGeo (可变).
@calcom/cal-sans-ui/ui.cssCSS:可变字体.
@calcom/cal-sans-ui/ui-non-variable.cssCSS:静态UI重量.
@calcom/cal-sans-ui/text.cssCSS:卡尔·桑斯文本.
@calcom/cal-sans-ui/geo.cssCSS: Cal Sans Geo. (中文(简体) ).

许可证

SIL 开放字体许可证 1.1. 见 OFL.txt (英语)。 。 。 .

版本与发布记录

@calcom/cal-sans-ui 共发布 4 个版本,首次发布于 2026/02/05;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.3.0latest2026/03/187 个月前
1.2.02026/03/048 个月前
1.0.22026/02/059 个月前
1.0.12026/02/059 个月前

关于 @calcom/cal-sans-ui 的常见问题

@calcom/cal-sans-ui 是什么?

Cal Sans UI, Cal Sans Text, 以及 Cal Sans Geo 用于 Cal.com 界面

如何安装 @calcom/cal-sans-ui?

在项目目录运行 npm install @calcom/cal-sans-ui,或使用 pnpm add / yarn add / bun add。

@calcom/cal-sans-ui 支持 TypeScript 吗?

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

@calcom/cal-sans-ui 支持 ESM 还是 CommonJS?

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

@calcom/cal-sans-ui 可以商用吗?

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

@calcom/cal-sans-ui 的下载量有多少?

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

@calcom/cal-sans-ui 还在维护吗?

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