@ant-design/cssinjs

中文文档
2.1.2发布于 2026/03/05MITTypeScriptESM + CJS近 30 天下载 1306.3万

蚂蚁的分辨度

中文使用文档
文档目录11 节
  1. 现场直播
  2. 安装
  3. 发展
  4. 许可证
  5. API 密码
  6. 样式提供
  7. 创建缓存
  8. 创建主题
  9. 设计 切换相关的 API
  10. 提取样式
  11. 变形

@ 蚂蚁设计/ csinjs

NPM version npm download dumi build status Codecov bundle size

组件级别 csinjs 溶液用于 蚂蚁设计它是一个子集 情感 带有设计符号逻辑包装. 请随意直接使用情感 如果你想找到一个网络csinjs解决方案。 cssinjs 相关 Dep 软件包 :

  • 样式
  • @emotion/ hash (英语)
  • @ emotion/ 无单位

现场直播

https://ant-design.github.io/csinjs/ (中文(简体) )

安装

npm install @ant-design/cssinjs

或者说

yarn add @ant-design/cssinjs
pnpm add @ant-design/cssinjs

发展

npm install
npm start

许可证

@ant-design/csinjs根据麻省理工学院的许可发布.

API 密码

样式提供

Prop国家类型默认
自动清除删除组件时清除注入样式元素 .布尔虚假
缓存配置 csinjs 缓存实体 。 只有在您需要 sr 自行提取样式时才设置 .缓存实体- 说吧
优先级使用 :where 减少散列Id css 选择器优先级的选择器'low' | 'high''low'
集装箱告诉Cssinjs在哪里注入样式.元素QQ 阴影旋转document.head
srInline 语录组件导出内置 <style /> 在苏维埃社会主义共和国后退。 不建议.布尔虚假
变压器在文档中注入前先转换 cs 。 请注意: transformers 不支持动态更新变形器 []- 说吧

创建缓存

返回样式提供的缓存实体.

创建主题

创建主题对象 。 当提供同一算法时,它将返回同一对象.

自兹 @ant-design/cssinjs 对缓存命中性能使用强烈的限制,我们建议查看演示 basic.tsx 用于 animation.tsx 用于动画使用.

提取样式

从缓存取出样式,然后以字符串的形式返回.

参数

  • cache (Cache):包含样式的缓存实例.
  • options (对象QQ布尔,可选): 提取样式的选项 .
    • plain (布尔,可选): 如果选中的话, 样式将以简单格式返回 。 默认是虚假的.
    • types (字符串 [],可选): 取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取的取取取取取取取取取取取取取取取取取 默认为 ['style','tken','cssVar'].

回返

  • (字符串):被提取的样式为字符串.

示例

import { extractStyle, createCache } from '@ant-design/cssinjs';

// 创建并填充缓存
const cache = createCache();
// 注意:在实际使用中,缓存通常会在渲染组件时自动填充

// 提取样式
const styles = extractStyle(cache, { plain: true, types: ['style', 'token'] });

// 使用提取的样式
const styleElement = document.createElement('style');
styleElement.innerHTML = styles;
document.head.appendChild(styleElement);

变形

当您需要转换 CSS Object 在插入样式前 。 你用得着 transformers 处理此事项:

import {
  legacyLogicalPropertiesTransformer,
  StyleProvider,
} from '@ant-design/cssinjs';

export default () => (
  <StyleProvider transformers={[legacyLogicalPropertiesTransformer]}>
    <MyApp />
  </StyleProvider>
);

以下是我们提供的转变:

传统工艺

将逻辑属性转换为遗留属性 。 譬如说. marginBlockStart 改为 marginTop数字 :

  • 设置
  • 边距
  • 粘贴
  • 边框

px2rem 转换器

将像素单位转换为雷姆单位. px2rem 转换器. options

版本与发布记录

@ant-design/cssinjs 共发布 136 个版本,首次发布于 2022/01/27;过去 12 个月发布了 7 个版本。

版本发布日期距今
2.1.2latest2026/03/058 个月前
2.1.12026/03/048 个月前
2.1.02026/02/098 个月前
2.0.32026/01/149 个月前
2.0.22026/01/059 个月前
2.0.12025/11/2511 个月前

其他发布通道:next → 2.0.0-alpha.9。

关于 @ant-design/cssinjs 的常见问题

@ant-design/cssinjs 是什么?

蚂蚁的分辨度

如何安装 @ant-design/cssinjs?

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

@ant-design/cssinjs 支持 TypeScript 吗?

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

@ant-design/cssinjs 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ant-design/cssinjs 可以商用吗?

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

@ant-design/cssinjs 的下载量有多少?

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

@ant-design/cssinjs 还在维护吗?

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