stylelint 规范你的 css

2021年11月22日 阅读数:13
这篇文章主要向大家介绍stylelint 规范你的 css,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。

TL;DR:css

👉 stylelint 简介html

👉 stylelint 配置vue

👉 stylelint 原理git

stylelint 简介

A mighty, modern linter that helps you avoid errors and enforce conventions in your styles.面试

一个强大、现代的 linter 帮助团队避免规则错误,统一代码风格。和 eslint 相似能够继承开源社区的 config、自定义配置、写个性化的 rules 。npm

stylelint 配置

可按照官方引导 user-guide/get-started 进行配置。笔者目前公司项目采用的是 vue + scss + ts 实现的,这里主要会介绍 vue 和 scss 相关的配置。json

相关依赖

stylelint 版本和依赖存在兼容性问题,下面依赖版本通过验证segmentfault

  • stylelint@3.13.1
  • stylelint-config-recommended-scss@4.3.0
  • stylelint-scss@4.0.0
  • stylelint-config-recess-order@3.0.0
  • stylelint-prettier@2.0.0
  • stylelint-config-prettier@9.0.3

stylelint 插件提供扩展规则,不提供预设配置。(我只提供配置,用不用是你的事)。命名规范为 stylelint-xxxxbabel

咱们项目使用到了 scss 预处理器,须要利用 stylelint-config-recommended-scss 作 scss 规则检查。ide

stylelint-scss 提供了 n 多条规则,stylelint-config-recommended-scss 内开启了部分配置。

面试的时候咱们常常会被问到 css 的重排和重绘,坦白讲写代码的时候并无太多人关心这个。 让 linter 来帮助咱们自动修复多香。stylelint-config-recess-order (属性配置 + stylelint-order插件)能够帮咱们实现

stylelint 与 eslint 相似,都与 Prettier 规则有冲突,stylelint-config-prettier 能够解决这些冲突,stylelint-prettier 插件优化 Prettier 的执行时机

配置文件

能够是 .stylelintrc 或 .stylelintrc.js 或 stylelint.config.cjs 配置文件。推荐使用 .js 文件的形式方便自定义。

module.exports = {
  /* 继承公共配置 */
  "extends":[
    "stylelint-config-recommended-scss",
    "stylelint-config-recess-order",
    "stylelint-prettier/recommended"
  ],
  /* 扩展 stylelint 原生rules 的种类 */
  "plugins": ["stylelint-prettier"],
  /* 项目个性化的规则 */
   rules: {
    "selector-pseudo-element-no-unknown": [
      true,
      {
        ignorePseudoElements: ["v-deep"],
      }
    ],
    "prettier/prettier": true,
    "number-leading-zero": "always",
  }
}

以前搞不懂为啥有些工具配置能支持 monorepo 项目组织形式,读官方文档发现 cosmiconfig 库帮忙作到了这件事情。

Stylelint uses cosmiconfig to find and load your configuration object.

执行脚本

项目配置应结合 lint-stage 、git-hooks 对执行时机和范围作优化。本文只讲手动执行。

package.json:

 "lint:style": "stylelint 'src/**/*.{vue,htm,html,css,scss}' --fix"

在终端执行 npm run lint:style 看下代码的变化吧。

stylelint 原理

stylelint 经过使用 PostCSS API 来分析 CSS 的语法,实现样式的检查。

postcss 是 css 的 编译器。它和 babel 的功能设计相似, 有 parse -> transform -> generater 三个关键环节。开发者能够经过 parse 后的 AST 结构实现自定义的 lint 规则。

stylelint-config-demo