# @ecosia/stylelint-config-property-sort-order-smacss 中文文档

规范地址：https://npmcn.com/package/%40ecosia/stylelint-config-property-sort-order-smacss/

版本：2\.0\.0
npm 元数据更新时间：2025-11-04T17:07:00.586Z
中文译文更新时间：2026-11-13T06:06:05.729Z
软件包许可：SEE LICENSE IN 'LICENSE\.md'

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ecosia/stylelint-config-property-sort-order-smacss
原文对照：https://npmcn.com/package/%40ecosia/stylelint-config-property-sort-order-smacss/?lang=original
项目主页：https://github.com/ecosia/stylelint-config-property-sort-order-smacss#readme
源码仓库：https://github.com/ecosia/stylelint-config-property-sort-order-smacss

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.7 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- peer 依赖：stylelint ^14\.0\.0 \|\| ^15\.0\.0 \|\| ^16\.0\.0
- 首次发布：2025-06-26T14:28:43.312Z
- 最新版本发布：2025-06-26T14:50:00.613Z
- 近 30 天下载量：141438（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

根据 SMACSS 方法对属性排序进行样式林特配置

## 安装

```sh
npm install @ecosia/stylelint-config-property-sort-order-smacss
```

也可以使用：`pnpm add @ecosia/stylelint-config-property-sort-order-smacss`、`yarn add @ecosia/stylelint-config-property-sort-order-smacss`、`bun add @ecosia/stylelint-config-property-sort-order-smacss`

## README

# @ecosia/stylelint-config-property-sort-order-smacs (英语)

[样式林](https://github.com/stylelint/stylelint) 基于属性排序的配置 [卫星](http://smacss.com/) 方法.

## 相关软件包

-   [样式lint - 配置 - 财产类型 - 顺序 - 图标](https://github.com/cahamilton/stylelint-config-property-sort-order-smacss/)

## 使用量

下列情况被视为侵权行为:

```css
a {
  color: red;
  top: 0;
}
```

```css
a {
  top: 0;
  color: black;
  position: absolute;
  display: block;
}
```

以下模式是: _没有_ 被考虑的侵权行为:

```css
a {
  top: 0;
  color: red;
}
```

```css
a {
  display: block;
  position: absolute;
  top: 0;
  color: black;
}
```

参见 [cs-财产类型-顺序-smacs](https://github.com/cahamilton/css-property-sort-order-smacss/blob/v2.2.0/index.js) 财产命令综合清单.

关于Stylelint配置的更多信息,请查看 [配置](https://github.com/stylelint/stylelint/blob/16.0.0/docs/user-guide/configure.md) 向导.

## 高级

**目前这只有在导出 JavaScript 配置的情况下才有可能.**

上文概述的基本用法将强制执行: **严格** 在其组内排序(框、边框、背景等)。 鉴于此配置使用了 [样式lint 顺序](https://github.com/hudochenkov/stylelint-order/tree/6.0.4) 在引擎盖下,还有几处额外的功能可以配置. 这将需要手动生成配置 - 但是在认为合适的额外选项中传递 。 这些规定将适用于: **每个** 属性组.

### 选项

参见 [属性顺序](https://github.com/hudochenkov/stylelint-order/blob/6.0.4/rules/properties-order/README.md#options) 可选选项列表的文档.

所有选项除外 `properties` 财务报告和审定财务报表 `groupName` 可以修改.

### 实例

#### 灵活排序

这将允许同一组内的属性按任何顺序排列.

鉴于:

```js
// stylelint.config.js

const sortOrderSmacss = require('stylelint-config-property-sort-order-smacss/generate');

module.exports = {
  plugins: ['stylelint-order'],
  rules: {
    'order/properties-order': [
      sortOrderSmacss()
    ],
  },
};
```

下列情况被视为侵权行为:

```css
a {
  top: 0;
  position: absolute;
  display: block;
  color: black;
}
```

鉴于:

```js
// stylelint.config.js

const sortOrderSmacss = require('stylelint-config-property-sort-order-smacss/generate');

module.exports = {
  plugins: ['stylelint-order'],
  rules: {
    'order/properties-order': [
      sortOrderSmacss({ order: 'flexible' })
    ],
  },
};
```

以下模式是: _没有_ 被考虑的侵权行为:

```css
a {
  top: 0;
  position: absolute;
  display: block;
  color: black;
}
```

#### 属性组后为空行

这将允许在每个属性组后有一条空行 :

鉴于:

```js
// stylelint.config.js

const sortOrderSmacss = require('stylelint-config-property-sort-order-smacss/generate');

module.exports = {
  plugins: ['stylelint-order'],
  rules: {
    'order/properties-order': [
      sortOrderSmacss({ emptyLineBefore: 'never' })
    ],
  },
};
```

下列情况被视为侵权行为:

```css
a {
  display: block;
  position: absolute;
  top: 0;

  color: black;
}
```

鉴于:

```js
// stylelint.config.js

const sortOrderSmacss = require('stylelint-config-property-sort-order-smacss/generate');

module.exports = {
  plugins: ['stylelint-order'],
  rules: {
    'order/properties-order': [
      sortOrderSmacss({ emptyLineBefore: 'always' })
    ],
  },
};
```

以下模式是: _没有_ 被考虑的侵权行为:

```css
a {
  display: block;
  position: absolute;
  top: 0;

  color: black;
}
```

## 捐款

见 [捐款额](https://npmcn.com/package/%40ecosia/stylelint-config-property-sort-order-smacss/CONTRIBUTING.md) 捐款准则.

## 许可证

见 [利比里亚](https://npmcn.com/package/%40ecosia/stylelint-config-property-sort-order-smacss/LICENSE.md) 获取许可证信息.

## 常见问题

### @ecosia/stylelint-config-property-sort-order-smacss 是什么？

根据 SMACSS 方法对属性排序进行样式林特配置

### 如何安装 @ecosia/stylelint-config-property-sort-order-smacss？

在项目目录运行 npm install @ecosia/stylelint-config-property-sort-order-smacss，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：stylelint（^14\.0\.0 \|\| ^15\.0\.0 \|\| ^16\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ecosia/stylelint-config-property-sort-order-smacss 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ecosia\_\_stylelint-config-property-sort-order-smacss 是否存在。

### @ecosia/stylelint-config-property-sort-order-smacss 支持 ESM 还是 CommonJS？

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

### @ecosia/stylelint-config-property-sort-order-smacss 可以商用吗？

@ecosia/stylelint-config-property-sort-order-smacss 使用 SEE LICENSE IN 'LICENSE\.md' 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @ecosia/stylelint-config-property-sort-order-smacss 的下载量有多少？

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

### @ecosia/stylelint-config-property-sort-order-smacss 还在维护吗？

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