让开源，少一点语言距离。
npm包中文文档

@contentful/experiences-design

中文文档
0.13.12发布于 2026/11/07MITTypeScriptES Module零依赖近 30 天下载 4272

CSS 具有实质性经验的财产公用事业

中文使用文档
中文原文
文档目录3 节
  1. 住在这里的东西
  2. toCss 和CSS财产白名单
  3. 许可证

@ contentful/ 经验设计

⚠️ 内部包裹. 你不直接安装这个——框架适配器(例如. @contentful/experiences-react(c) 将所需公用事业再出口.

将已解析的设计财产记录转化为 CSS-形状值.

住在这里的东西

  • toCssKey(key) 将 CSS 属性名称的设计记录密钥正常化:剥去可选的 cf 前缀和骆驼cf-font-size → fontSize) (中文(简体) ).
  • isCssProperty(key) 编号 : CSS_PROPERTIES - 会员资格检验和基础 Set cSS 属性名称 toCss 将释放.

toCss 和CSS财产白名单

toCss 是设计上的逃生舱的同伴 而不是其中的一部分 建议的样式路径。 组件应该从自动填充的样式中样式 设计道具,在那里他们读 他们申报的钥匙,没有什么 过滤器 — 见 样式组件。 。 。 .

适应者 toCss 助手只保存其正则形式所在的密钥 CSS_PROPERTIES 财务报告和审定财务报表 放下所有东西 这就是语义设计 数值(variant, (中文(简体) ), as, (中文(简体) ), ratio,.) 远离样式对象. 权衡 也就是说,一个真正的 CSS 财产从该集中消失了 .

如果你打那个:

  • 直接读取值 . 已解决的全部记录可从 useDesignValues() 编号 : getDesignValues()· ; toCss 只是一个方便,所以它掉下来的钥匙 仍然可以读取的名字.
  • 扩展设定. CSS_PROPERTIES 导出和可变( n)CSS_PROPERTIES.add('containerType')) ——其中添加的密钥流经 toCss 在下一个渲染.

清单是有意整理的,而不是详尽无遗的(完整的CSS财产) 警告会在语义键上失火 toCss )),该降. 打开 a PR来添加常用属性.

见 ../../AGENTS.md 设计理由 多框架故事.

许可证

麻省理工学院. 见寄存器 LICENSE 财务报告和审定财务报表 NOTICE 完全归属.

版本与发布记录

@contentful/experiences-design 共发布 53 个版本，首次发布于 2026/07/21；过去 12 个月发布了 53 个版本。

版本发布日期距今
0.13.12latest2026/11/074 天前
0.13.112026/11/055 天前
0.13.102026/11/055 天前
0.13.92026/11/046 天前
0.13.82026/10/3111 天前
0.13.72026/10/3011 天前

关于 @contentful/experiences-design 的常见问题

@contentful/experiences-design 是什么？

CSS 具有实质性经验的财产公用事业

如何安装 @contentful/experiences-design？

在项目目录运行 npm install @contentful/experiences-design，或使用 pnpm add / yarn add / bun add。

@contentful/experiences-design 支持 TypeScript 吗？

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

@contentful/experiences-design 支持 ESM 还是 CommonJS？

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

@contentful/experiences-design 可以商用吗？

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

@contentful/experiences-design 的下载量有多少？

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

@contentful/experiences-design 还在维护吗？

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