Nuxt Nation 大会即将到来。加入我们,时间为 11 月 12 日至 13 日。

stylelint
@nuxtjs/stylelint-module

Nuxt 的 Stylelint 模块。一个强大而现代的代码检查工具,帮助你避免错误并在你的样式中强制执行约定。

@nuxtjs/stylelint-module

npm versionnpm downloadsGithub Actions CICodecovLicense

适用于 Nuxt.js 的 Stylelint 模块

📖 发行说明


注意:此分支适用于与 Nuxt 3Nuxt Bridge 兼容的模块。查看 nuxt2 分支 以获取 Nuxt 2 支持。


需求

你需要确保已安装 stylelint

使用 pnpm

pnpm add -D stylelint

或者,使用 yarn

yarn add -D stylelint

或者,使用 npm

npm install -D stylelint

注意:目前,此模块仅在使用 vite 时与 stylelint 的最新版本 16 兼容,尚未实现对 webpack 的支持(请参阅 https://github.com/webpack-contrib/stylelint-webpack-plugin/issues/342)。

设置

  1. @nuxtjs/stylelint-module 依赖项添加到你的项目中

使用 pnpm

pnpm add -D @nuxtjs/stylelint-module

或者,使用 yarn

yarn add -D @nuxtjs/stylelint-module

或者,使用 npm

npm install -D @nuxtjs/stylelint-module
  1. @nuxtjs/stylelint-module 添加到 nuxt.config.js 文件的 modules 部分
export default {
  modules: [
    // Simple usage
    '@nuxtjs/stylelint-module',

    // With options
    ['@nuxtjs/stylelint-module', { /* module options */ }]
  ]
}

使用顶级选项

export default {
  modules: [
    '@nuxtjs/stylelint-module'
  ],
  stylelint: {
    /* module options */
  }
}

选项

请参阅 stylelint 的选项 以获取可用选项的完整列表。这些选项将直接传递给 stylelint

缓存

  • 类型:Boolean
  • 默认值:true

注意:默认情况下启用缓存以减少执行时间。

包含

  • 类型:String|Array[String]
  • 默认值:[nuxt.options.srcDir.'/**/*.{css,scss,sass,less,styl,vue}']

指定目录、文件或通配符。

排除

  • 类型:Array[String]
  • 默认值:['**/node_modules/**', 'virtual:', nuxt.options.buildDir]

指定要排除的文件和/或目录。

stylelintPath

  • 类型:String
  • 默认值:stylelint

将用于代码检查的 stylelint 实例的路径。

格式化程序

  • 类型:Function
  • 默认值:'string'

指定要用于格式化结果的格式化程序。

lintOnStart

  • 类型:Boolean
  • 默认值:true

在项目启动时检查所有匹配的文件,速度太慢,谨慎开启。

lintDirtyOnly

  • 类型:Boolean
  • 默认值:true

运行 Stylelint 时仅检查已更改的文件,除了 buildStart 钩子,禁用时将检查 include 选项中指定的所有文件。

emitWarning

  • 类型:Boolean
  • 默认值:true

将打印找到的警告。

emitError

  • 类型:Boolean
  • 默认值:true

将打印找到的错误。

failOnWarning

  • 类型:Boolean
  • 默认值:false

如果存在任何警告,则会导致模块构建失败,基于 emitWarning

failOnError

  • 类型:Boolean
  • 默认值:true

如果存在任何错误,则会导致模块构建失败,基于 emitError

贡献

你可以在线使用 CodeSandBox 为此模块做出贡献

Edit @nuxtjs/robots

或本地

  1. 克隆此存储库
  2. 使用 pnpm install 安装依赖项
  3. 使用 pnpm dev:prepare 准备开发服务器
  4. 使用 pnpm build 构建模块
  5. 使用 pnpm dev 启动游乐场

许可证

MIT 许可证

版权所有 (c) Nuxt 模块