@nuxtjs/stylelint-module
@nuxtjs/stylelint-module
用于 Nuxt 的 Stylelint 模块。一个强大的现代代码检查工具,可帮助您避免错误并强制执行样式规范。
@nuxtjs/stylelint-module
用于 Nuxt.js 的 Stylelint 模块
注意:此分支适用于Nuxt 3 或 Nuxt 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)。
安装
- 将
@nuxtjs/stylelint-module
依赖项添加到您的项目中
使用 pnpm
pnpm add -D @nuxtjs/stylelint-module
或者,使用 yarn
yarn add -D @nuxtjs/stylelint-module
或者,使用 npm
npm install -D @nuxtjs/stylelint-module
- 将
@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
。
cache
- 类型:
Boolean
- 默认值:
true
注意:默认启用缓存以减少执行时间。
include
- 类型:
String|Array[String]
- 默认值:
[nuxt.options.srcDir.'/**/*.{css,scss,sass,less,styl,vue}']
指定目录、文件或 glob 模式。
exclude
- 类型:
Array[String]
- 默认值:
['**/node_modules/**', 'virtual:', nuxt.options.buildDir]
指定要排除的文件和/或目录。
stylelintPath
- 类型:
String
- 默认值:
stylelint
将用于代码检查的 stylelint
实例的路径。
formatter
- 类型:
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 在线为此模块做出贡献
或在本地
- 克隆此存储库
- 使用
pnpm install
安装依赖项 - 使用
pnpm dev:prepare
准备开发服务器 - 使用
pnpm build
构建模块 - 使用
pnpm dev
启动 Playground
许可证
版权所有 (c) Nuxt 模块