css-declaration-sorter

css-declaration-sorter

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

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

CSS排序PostCSS插件声明排序样式组织Node.js模块Github开源项目
<img alt='CSS 声明排序器标志' src='https://yellow-cdn.veclightyear.com/835a84d5/52494a9c-13e5-45c4-99fc-43994f4bdf4d.svg?sanitize=true' height='260' align='right'>

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; 将保持此顺序。

编辑推荐精选

商汤小浣熊

商汤小浣熊

最强AI数据分析助手

小浣熊家族Raccoon,您的AI智能助手,致力于通过先进的人工智能技术,为用户提供高效、便捷的智能服务。无论是日常咨询还是专业问题解答,小浣熊都能以快速、准确的响应满足您的需求,让您的生活更加智能便捷。

imini AI

imini AI

像人一样思考的AI智能体

imini 是一款超级AI智能体,能根据人类指令,自主思考、自主完成、并且交付结果的AI智能体。

Keevx

Keevx

AI数字人视频创作平台

Keevx 一款开箱即用的AI数字人视频创作平台,广泛适用于电商广告、企业培训与社媒宣传,让全球企业与个人创作者无需拍摄剪辑,就能快速生成多语言、高质量的专业视频。

即梦AI

即梦AI

一站式AI创作平台

提供 AI 驱动的图片、视频生成及数字人等功能,助力创意创作

扣子-AI办公

扣子-AI办公

AI办公助手,复杂任务高效处理

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
蛙蛙写作

蛙蛙写作

AI小说写作助手,一站式润色、改写、扩写

蛙蛙写作—国内先进的AI写作平台,涵盖小说、学术、社交媒体等多场景。提供续写、改写、润色等功能,助力创作者高效优化写作流程。界面简洁,功能全面,适合各类写作者提升内容品质和工作效率。

AI辅助写作AI工具蛙蛙写作AI写作工具学术助手办公助手营销助手AI助手
问小白

问小白

全能AI智能助手,随时解答生活与工作的多样问题

问小白,由元石科技研发的AI智能助手,快速准确地解答各种生活和工作问题,包括但不限于搜索、规划和社交互动,帮助用户在日常生活中提高效率,轻松管理个人事务。

热门AI助手AI对话AI工具聊天机器人
Transly

Transly

实时语音翻译/同声传译工具

Transly是一个多场景的AI大语言模型驱动的同声传译、专业翻译助手,它拥有超精准的音频识别翻译能力,几乎零延迟的使用体验和支持多国语言可以让你带它走遍全球,无论你是留学生、商务人士、韩剧美剧爱好者,还是出国游玩、多国会议、跨国追星等等,都可以满足你所有需要同传的场景需求,线上线下通用,扫除语言障碍,让全世界的语言交流不再有国界。

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
下拉加载更多