@atlaskit/eslint-plugin-ui-styling-standard

中文文档
3.0.4发布于 2026/11/02Apache-2.0TypeScriptESM + CJS近 30 天下载 3576

用于执行和教育Atlassian UI Styling 标准的 Eslint 插件

中文使用文档

UI Styling 标准 ESLint 插件

UI Styling标准是一套原则,用于指导图集前端的UI代码 代码库和生态系统.

这些是目前的ESLint规则,它们执行并帮助遵守今天的UI Styling标准, 但计划更多时间支持标准.

安装

您必须使用推荐的配置来遵循Atlassian的造型标准,这将确保 与设计系统的兼容性和性能.

module.exports = {
  extends: [
+    'plugin:@atlaskit/ui-styling-standard/recommended',
  ],
};

我们不建议维持你的配置 如果你不使用我们的配置,你将需要 指定单个规则和配置。 将插件添加到您的 eslint.config.cjs 文档和 允许个人规则,因为你准备采纳.

module.exports = {
  plugins: [
+    '@atlaskit/ui-styling-standard',
  ],
  rules: [
+    '@atlaskit/ui-styling-standard/convert-props-syntax': 'warn',
+    '@atlaskit/design-system/local-cx-xcss': 'error',
  ],
};

规则

规则说明建议可修复建议
阿特拉斯基特主题禁止使用 @atlaskit/theme 那个 @compiled/react 无法理解
转换正则语法将样式- 组件- QQ4 或 @ emotion/ styled 所支持的道具语法转换为道具语法 。 结合 no-styled-tagged-template-expression,因为后者的产出可能使用这些库不支持的道具语法.对对
执行风格道具停止使用静态样式 style 组件中的属性对
本地密码确保作为 XCSS API 的一部分的 cx () 函数只在 xcs 道具内使用 。 这种辅助跟踪对jsx元素应用的样式.对
无阵列参数防止使用数组参数来样式化声明函数对对
无阿特拉斯基特主题取消从 @atlaskit/theme对
无类名道具放弃使用 className jSX中的道具对
无容器防止使用 Css 样式中的@ container 查询对
无动力风格CSS- in- JS 调用中使用动态样式对
无出口型取消 Cs 、 密钥框、 样式和 xcs 的导出对
无全球风格通过 CSS- in- JS 或 CSS 模块导入来防止全局样式对
无重要风格否定重要的风格声明对
无输入型值取消样式值的导入对
无记名选择者防止在 Css 样式内使用嵌入式选择器对
无类型放弃使用 styled 进口对
无安全选择者拒绝使用嵌入式 css 函数.对对对
无安全值对静态安非他明来说难以/不可能的去盐风格.对
无未用csmap-财产检测不导出 cssMap 样式对象中未使用的属性。 通过识别定义但从未使用的样式变体,帮助维护清洁代码.对
使用编译确保使用 @compiled/react 或者说 @atlaskit/css 而不是其他 CSS- in- JS 图书馆对对
@atlaskit/design-system/ consistent-cs-prop-usage (英语)确保与 css 财务报告和审定财务报表 xcss 道具用途对对
@atlaskit/design-system/ no-cs-tign-template-expression (英语)拒绝任何 css 源自情感、样式组件或编译的被标记的模板表达式对对
@atlaskit/design-system/ no-keyframes-tagn-template-expression (没有键框标记-模板-表达式)拒绝任何 keyframe 源自情感、样式组件或编译的被标记的模板表达式对对
@atlaskit/design-system/无标签-tigg-template-expression 页面存档备份,存于互联网档案馆拒绝任何 styled 源自情感、样式组件或编译的被标记的模板表达式对对
@atlaskit/design-system/没有空格式的表达禁止任何在将空参数传递到样式.div () (或其他JSX元素)时使用的样式表达式 .对
@atlaskit/design-system/ no-invalid-cs-map (英语)检查通过 assMap 创建的 CSS 映射的有效性。 此功能意在与 TypeScript 的类型检查同时使用 .对
@atlaskit/design-system/no-css-map-scoped (英语)实验用途的减少 cssMapScoped API 来自 @compiled/react。这个API是内部的,不是公共编译的CSS-in-JS接口的一部分.对

版本与发布记录

@atlaskit/eslint-plugin-ui-styling-standard 共发布 101 个版本,首次发布于 2024/01/10;过去 12 个月发布了 29 个版本。

版本发布日期距今
3.0.4latest2026/11/025 天前
3.0.32026/10/299 天前
3.0.22026/10/1424 天前
3.0.12026/10/021 个月前
3.0.02026/10/021 个月前
2.4.12026/10/021 个月前

关于 @atlaskit/eslint-plugin-ui-styling-standard 的常见问题

@atlaskit/eslint-plugin-ui-styling-standard 是什么?

用于执行和教育Atlassian UI Styling 标准的 Eslint 插件

如何安装 @atlaskit/eslint-plugin-ui-styling-standard?

在项目目录运行 npm install @atlaskit/eslint-plugin-ui-styling-standard,或使用 pnpm add / yarn add / bun add。

@atlaskit/eslint-plugin-ui-styling-standard 支持 TypeScript 吗?

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

@atlaskit/eslint-plugin-ui-styling-standard 支持 ESM 还是 CommonJS?

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

@atlaskit/eslint-plugin-ui-styling-standard 可以商用吗?

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

@atlaskit/eslint-plugin-ui-styling-standard 的下载量有多少?

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

@atlaskit/eslint-plugin-ui-styling-standard 还在维护吗?

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