Project Icon

css-declaration-sorter

基于属性名称排序CSS声明的Node.js模块和PostCSS插件

css-declaration-sorter是一个用于排序CSS、SCSS或Less声明的工具。它提供字母顺序、SMACSS和同心CSS等多种排序方式,支持嵌套规则和SCSS/Less语法。该工具有助于提高样式的组织性和一致性,可用于优化构建过程或减小CSS文件大小。它作为Node.js模块和PostCSS插件提供,并包含经过验证的预设排序顺序。

CSS 声明排序器标志

CSS 声明排序器

npm

一个 Node.js 模块和 PostCSS 插件,用于根据属性名称对 CSS、SCSS 或 Less 声明进行排序。确保样式组织更加一致有序... 这个包的目标是在构建过程中对项目源代码进行排序,或减小分发的 CSS gzip 压缩后的大小。

查看Prettier 插件以了解如何与各种文件格式一起使用。

优点

  • MDN 兼容性数据 项目获取最新的 CSS 属性。
  • 选择你想要的排序方式或提供自己的排序方式。
  • 支持嵌套规则排序。
  • 当与 postcss-scsspostcss-less 结合使用时,支持 SCSS 和 Less。
  • 提供经过深思熟虑的开箱即用排序方式,经作者认可

字母顺序示例

输入:

body {
    display: block;
    animation: none;
    color: #C55;
    border: 0;
}

输出:

body {
    animation: none;
    border: 0;
    color: #C55;
    display: block;
}

内置排序方式

  • 字母顺序
    alphabetical
    默认,按简单的 a-z 字母顺序排序。

  • SMACSS
    smacss
    从最重要、影响流程的属性到最不重要的属性排序。

    1. 盒子
    2. 边框
    3. 背景
    4. 文本
    5. 其他
  • 同心 CSS
    concentric-css
    从应用于盒模型外部的属性开始排序,向内移动到内在变化。

    1. 定位
    2. 可见性
    3. 盒模型
    4. 尺寸
    5. 文本

使用方法

遵循 PostCSS 插件指南,本包将 PostCSS 作为对等依赖:
npm install postcss css-declaration-sorter --save-dev

命令行

本模块不包含自己的命令行界面,但可与官方 PostCSS CLI 配合使用。要使用以下示例,需要安装 postcss-cli 包作为依赖。

从文件输出结果:
postcss input.css --use css-declaration-sorter | cat

通过覆盖排序多个文件:
postcss *.css --use css-declaration-sorter --replace --no-map

使用 postcss-scss 通过覆盖方式排序目录中所有 SCSS 语法的文件:
postcss ./src/**/*.scss --syntax postcss-scss --use css-declaration-sorter --replace --no-map

使用 package.json 配置,以 SMACSS 顺序通过覆盖方式排序目录中所有 SCSS 语法的文件:

"postcss": {
  "syntax": "postcss-scss",
  "map": false,
  "plugins": {
    "css-declaration-sorter": { "order": "smacss" }
  }
}

postcss ./src/**/*.scss --replace --config package.json

原生 JS

import postcss from 'postcss';
import { cssDeclarationSorter } from 'css-declaration-sorter';

postcss([cssDeclarationSorter({ order: 'smacss' })])
  .process('a { color: hyperblue; display: block; }', { from: undefined })
  .then(result => console.log(
    result.css === 'a { display: block; color: hyperblue; }'
  ));

查看更多与其他工具结合使用的示例


API

cssDeclarationSorter({ order, keepOverrides })

order

类型:stringfunction
默认值:alphabetical
选项:alphabeticalsmacssconcentric-css

提供内置排序方式之一的名称,或传递给 Array.sort 的比较函数。这个函数接收两个声明名称,并根据所需顺序返回 -101

keepOverrides

类型:Boolean
默认值:false

为防止破坏旧版 CSS 中简写声明覆盖长手声明的情况(同时考虑供应商前缀),可以启用此选项。例如,当 keepOverridestrue 时,animation-name: some; animation: greeting; 将保持此顺序。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号