vuejs · ota-meshi · Mar 14, 2020 · Mar 14, 2020
diff --git a/.eslintrc.js b/.eslintrc.js
@@ -29,6 +29,7 @@ module.exports = {
  rules: {
  "consistent-docs-description": "error",
  "no-invalid-meta": "error",
+ "no-invalid-meta-docs-categories": "error",
  'eslint-plugin/require-meta-type': 'error',
  "require-meta-docs-url": ["error", {
  "pattern": `https://eslint.vuejs.org/rules/{{name}}.html`

diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
@@ -5,11 +5,47 @@
 'use strict'
 
 const rules = require('../../tools/lib/rules')
-const categories = require('../../tools/lib/categories')
 
-const uncategorizedRules = rules.filter(rule => !rule.meta.docs.category && !rule.meta.deprecated)
+const uncategorizedRules = rules.filter(rule => !rule.meta.docs.categories && !rule.meta.deprecated)
 const deprecatedRules = rules.filter(rule => rule.meta.deprecated)
 
+const sidebarCategories = [
+ { title: 'Base Rules', categoryIds: ['base'] },
+ { title: 'Priority A: Essential', categoryIds: ['vue3-essential', 'essential'] },
+ { title: 'Priority A: Essential for Vue.js 3.x', categoryIds: ['vue3-essential'] },
+ { title: 'Priority A: Essential for Vue.js 2.x', categoryIds: ['essential'] },
+ { title: 'Priority B: Strongly Recommended', categoryIds: ['vue3-strongly-recommended', 'strongly-recommended'] },
+ { title: 'Priority B: Strongly Recommended for Vue.js 3.x', categoryIds: ['vue3-strongly-recommended'] },
+ { title: 'Priority B: Strongly Recommended for Vue.js 2.x', categoryIds: ['strongly-recommended'] },
+ { title: 'Priority C: Recommended', categoryIds: ['vue3-recommended', 'recommended'] },
+ { title: 'Priority C: Recommended for Vue.js 3.x', categoryIds: ['vue3-recommended'] },
+ { title: 'Priority C: Recommended for Vue.js 2.x', categoryIds: ['recommended'] }
+]
+
+const categorizedRules = []
+for (const { title, categoryIds } of sidebarCategories) {
+ const categoryRules = rules
+ .filter(rule => rule.meta.docs.categories && !rule.meta.deprecated)
+ .filter(rule => categoryIds
+ .every(categoryId => rule.meta.docs.categories.includes(categoryId))
+ )
+ const children = categoryRules
+ .filter(({ ruleId }) => {
+ const exists = categorizedRules.some(({ children }) => children.some(([, alreadyRuleId]) => alreadyRuleId === ruleId))
+ return !exists
+ })
+ .map(({ ruleId, name }) => [`/rules/${name}`, ruleId])
+
+ if (children.length === 0) {
+ continue
+ }
+ categorizedRules.push({
+ title,
+ collapsable: false,
+ children
+ })
+}
+
 const extraCategories = []
 if (uncategorizedRules.length > 0) {
  extraCategories.push({
@@ -59,11 +95,7 @@ module.exports = {
  '/rules/',
 
  // Rules in each category.
- ...categories.map(({ title, rules }) => ({
- title: title.replace(/ \(.+?\)/, ''),
- collapsable: false,
- children: rules.map(({ ruleId, name }) => [`/rules/${name}`, ruleId])
- })),
+ ...categorizedRules,
 
  // Rules in no category.
  ...extraCategories

diff --git a/docs/rules/README.md b/docs/rules/README.md
@@ -26,7 +26,114 @@ Enforce all the rules in this category, as well as all higher priority rules, wi
 | [vue/comment-directive](./comment-directive.md) | support comment-directives in `<template>` | |
 | [vue/jsx-uses-vars](./jsx-uses-vars.md) | prevent variables used in JSX to be marked as unused | |
 
-## Priority A: Essential (Error Prevention)
+## Priority A: Essential (Error Prevention) <badge text="for Vue.js 3.x" vertical="middle">for Vue.js 3.x</badge>
+
+Enforce all the rules in this category, as well as all higher priority rules, with:
+
+```json
+{
+ "extends": "plugin:vue/vue3-essential"
+}
+```
+
+| Rule ID | Description | |
+|:--------|:------------|:---|
+| [vue/no-async-in-computed-properties](./no-async-in-computed-properties.md) | disallow asynchronous actions in computed properties | |
+| [vue/no-deprecated-filter](./no-deprecated-filter.md) | disallow using deprecated filters syntax | |
+| [vue/no-deprecated-scope-attribute](./no-deprecated-scope-attribute.md) | disallow deprecated `scope` attribute (in Vue.js 2.5.0+) | :wrench: |
+| [vue/no-deprecated-slot-attribute](./no-deprecated-slot-attribute.md) | disallow deprecated `slot` attribute (in Vue.js 2.6.0+) | :wrench: |
+| [vue/no-deprecated-slot-scope-attribute](./no-deprecated-slot-scope-attribute.md) | disallow deprecated `slot-scope` attribute (in Vue.js 2.6.0+) | :wrench: |
+| [vue/no-deprecated-v-bind-sync](./no-deprecated-v-bind-sync.md) | disallow use of deprecated `.sync` modifier on `v-bind` directive (in Vue.js 3.0.0+) | :wrench: |
+| [vue/no-dupe-keys](./no-dupe-keys.md) | disallow duplication of field names | |
+| [vue/no-duplicate-attributes](./no-duplicate-attributes.md) | disallow duplication of attributes | |
+| [vue/no-lifecycle-after-await](./no-lifecycle-after-await.md) | disallow asynchronously registered lifecycle hooks | |
+| [vue/no-parsing-error](./no-parsing-error.md) | disallow parsing errors in `<template>` | |
+| [vue/no-ref-as-operand](./no-ref-as-operand.md) | disallow use of value wrapped by `ref()` (Composition API) as an operand | |
+| [vue/no-reserved-keys](./no-reserved-keys.md) | disallow overwriting reserved keys | |
+| [vue/no-setup-props-destructure](./no-setup-props-destructure.md) | disallow destructuring of `props` passed to `setup` | |
+| [vue/no-shared-component-data](./no-shared-component-data.md) | enforce component's data property to be a function | :wrench: |
+| [vue/no-side-effects-in-computed-properties](./no-side-effects-in-computed-properties.md) | disallow side effects in computed properties | |
+| [vue/no-template-key](./no-template-key.md) | disallow `key` attribute on `<template>` | |
+| [vue/no-textarea-mustache](./no-textarea-mustache.md) | disallow mustaches in `<textarea>` | |
+| [vue/no-unused-components](./no-unused-components.md) | disallow registering components that are not used inside templates | |
+| [vue/no-unused-vars](./no-unused-vars.md) | disallow unused variable definitions of v-for directives or scope attributes | |
+| [vue/no-use-v-if-with-v-for](./no-use-v-if-with-v-for.md) | disallow use v-if on the same element as v-for | |
+| [vue/require-component-is](./require-component-is.md) | require `v-bind:is` of `<component>` elements | |
+| [vue/require-prop-type-constructor](./require-prop-type-constructor.md) | require prop type to be a constructor | :wrench: |
+| [vue/require-render-return](./require-render-return.md) | enforce render function to always return value | |
+| [vue/require-v-for-key](./require-v-for-key.md) | require `v-bind:key` with `v-for` directives | |
+| [vue/require-valid-default-prop](./require-valid-default-prop.md) | enforce props default values to be valid | |
+| [vue/return-in-computed-property](./return-in-computed-property.md) | enforce that a return statement is present in computed property | |
+| [vue/use-v-on-exact](./use-v-on-exact.md) | enforce usage of `exact` modifier on `v-on` | |
+| [vue/valid-template-root](./valid-template-root.md) | enforce valid template root | |
+| [vue/valid-v-bind](./valid-v-bind.md) | enforce valid `v-bind` directives | |
+| [vue/valid-v-cloak](./valid-v-cloak.md) | enforce valid `v-cloak` directives | |
+| [vue/valid-v-else-if](./valid-v-else-if.md) | enforce valid `v-else-if` directives | |
+| [vue/valid-v-else](./valid-v-else.md) | enforce valid `v-else` directives | |
+| [vue/valid-v-for](./valid-v-for.md) | enforce valid `v-for` directives | |
+| [vue/valid-v-html](./valid-v-html.md) | enforce valid `v-html` directives | |
+| [vue/valid-v-if](./valid-v-if.md) | enforce valid `v-if` directives | |
+| [vue/valid-v-model](./valid-v-model.md) | enforce valid `v-model` directives | |
+| [vue/valid-v-on](./valid-v-on.md) | enforce valid `v-on` directives | |
+| [vue/valid-v-once](./valid-v-once.md) | enforce valid `v-once` directives | |
+| [vue/valid-v-pre](./valid-v-pre.md) | enforce valid `v-pre` directives | |
+| [vue/valid-v-show](./valid-v-show.md) | enforce valid `v-show` directives | |
+| [vue/valid-v-slot](./valid-v-slot.md) | enforce valid `v-slot` directives | |
+| [vue/valid-v-text](./valid-v-text.md) | enforce valid `v-text` directives | |
+
+## Priority B: Strongly Recommended (Improving Readability) <badge text="for Vue.js 3.x" vertical="middle">for Vue.js 3.x</badge>
+
+Enforce all the rules in this category, as well as all higher priority rules, with:
+
+```json
+{
+ "extends": "plugin:vue/vue3-strongly-recommended"
+}
+```
+
+| Rule ID | Description | |
+|:--------|:------------|:---|
+| [vue/attribute-hyphenation](./attribute-hyphenation.md) | enforce attribute naming style on custom components in template | :wrench: |
+| [vue/component-definition-name-casing](./component-definition-name-casing.md) | enforce specific casing for component definition name | :wrench: |
+| [vue/html-closing-bracket-newline](./html-closing-bracket-newline.md) | require or disallow a line break before tag's closing brackets | :wrench: |
+| [vue/html-closing-bracket-spacing](./html-closing-bracket-spacing.md) | require or disallow a space before tag's closing brackets | :wrench: |
+| [vue/html-end-tags](./html-end-tags.md) | enforce end tag style | :wrench: |
+| [vue/html-indent](./html-indent.md) | enforce consistent indentation in `<template>` | :wrench: |
+| [vue/html-quotes](./html-quotes.md) | enforce quotes style of HTML attributes | :wrench: |
+| [vue/html-self-closing](./html-self-closing.md) | enforce self-closing style | :wrench: |
+| [vue/max-attributes-per-line](./max-attributes-per-line.md) | enforce the maximum number of attributes per line | :wrench: |
+| [vue/multiline-html-element-content-newline](./multiline-html-element-content-newline.md) | require a line break before and after the contents of a multiline element | :wrench: |
+| [vue/mustache-interpolation-spacing](./mustache-interpolation-spacing.md) | enforce unified spacing in mustache interpolations | :wrench: |
+| [vue/no-multi-spaces](./no-multi-spaces.md) | disallow multiple spaces | :wrench: |
+| [vue/no-spaces-around-equal-signs-in-attribute](./no-spaces-around-equal-signs-in-attribute.md) | disallow spaces around equal signs in attribute | :wrench: |
+| [vue/no-template-shadow](./no-template-shadow.md) | disallow variable declarations from shadowing variables declared in the outer scope | |
+| [vue/prop-name-casing](./prop-name-casing.md) | enforce specific casing for the Prop name in Vue components | |
+| [vue/require-default-prop](./require-default-prop.md) | require default value for props | |
+| [vue/require-prop-types](./require-prop-types.md) | require type definitions in props | |
+| [vue/singleline-html-element-content-newline](./singleline-html-element-content-newline.md) | require a line break before and after the contents of a singleline element | :wrench: |
+| [vue/v-bind-style](./v-bind-style.md) | enforce `v-bind` directive style | :wrench: |
+| [vue/v-on-style](./v-on-style.md) | enforce `v-on` directive style | :wrench: |
+| [vue/v-slot-style](./v-slot-style.md) | enforce `v-slot` directive style | :wrench: |
+
+## Priority C: Recommended (Minimizing Arbitrary Choices and Cognitive Overhead) <badge text="for Vue.js 3.x" vertical="middle">for Vue.js 3.x</badge>
+
+Enforce all the rules in this category, as well as all higher priority rules, with:
+
+```json
+{
+ "extends": "plugin:vue/vue3-recommended"
+}
+```
+
+| Rule ID | Description | |
+|:--------|:------------|:---|
+| [vue/attributes-order](./attributes-order.md) | enforce order of attributes | :wrench: |
+| [vue/component-tags-order](./component-tags-order.md) | enforce order of component top-level elements | |
+| [vue/no-v-html](./no-v-html.md) | disallow use of v-html to prevent XSS attack | |
+| [vue/order-in-components](./order-in-components.md) | enforce order of properties in components | :wrench: |
+| [vue/this-in-template](./this-in-template.md) | disallow usage of `this` in template | |
+
+## Priority A: Essential (Error Prevention) <badge text="for Vue.js 2.x" vertical="middle" type="warn">for Vue.js 2.x</badge>
 
 Enforce all the rules in this category, as well as all higher priority rules, with:
 
@@ -77,7 +184,7 @@ Enforce all the rules in this category, as well as all higher priority rules, wi
 | [vue/valid-v-slot](./valid-v-slot.md) | enforce valid `v-slot` directives | |
 | [vue/valid-v-text](./valid-v-text.md) | enforce valid `v-text` directives | |
 
-## Priority B: Strongly Recommended (Improving Readability)
+## Priority B: Strongly Recommended (Improving Readability) <badge text="for Vue.js 2.x" vertical="middle" type="warn">for Vue.js 2.x</badge>
 
 Enforce all the rules in this category, as well as all higher priority rules, with:
 
@@ -111,7 +218,7 @@ Enforce all the rules in this category, as well as all higher priority rules, wi
 | [vue/v-on-style](./v-on-style.md) | enforce `v-on` directive style | :wrench: |
 | [vue/v-slot-style](./v-slot-style.md) | enforce `v-slot` directive style | :wrench: |
 
-## Priority C: Recommended (Minimizing Arbitrary Choices and Cognitive Overhead)
+## Priority C: Recommended (Minimizing Arbitrary Choices and Cognitive Overhead) <badge text="for Vue.js 2.x" vertical="middle" type="warn">for Vue.js 2.x</badge>
 
 Enforce all the rules in this category, as well as all higher priority rules, with:
 
@@ -160,18 +267,10 @@ For example:
 | [vue/match-component-file-name](./match-component-file-name.md) | require component name property to match its file name | |
 | [vue/max-len](./max-len.md) | enforce a maximum line length | |
 | [vue/no-boolean-default](./no-boolean-default.md) | disallow boolean defaults | :wrench: |
-| [vue/no-deprecated-filter](./no-deprecated-filter.md) | disallow using deprecated filters syntax | |
-| [vue/no-deprecated-scope-attribute](./no-deprecated-scope-attribute.md) | disallow deprecated `scope` attribute (in Vue.js 2.5.0+) | :wrench: |
-| [vue/no-deprecated-slot-attribute](./no-deprecated-slot-attribute.md) | disallow deprecated `slot` attribute (in Vue.js 2.6.0+) | :wrench: |
-| [vue/no-deprecated-slot-scope-attribute](./no-deprecated-slot-scope-attribute.md) | disallow deprecated `slot-scope` attribute (in Vue.js 2.6.0+) | :wrench: |
-| [vue/no-deprecated-v-bind-sync](./no-deprecated-v-bind-sync.md) | disallow use of deprecated `.sync` modifier on `v-bind` directive (in Vue.js 3.0.0+) | :wrench: |
 | [vue/no-empty-pattern](./no-empty-pattern.md) | disallow empty destructuring patterns | |
 | [vue/no-irregular-whitespace](./no-irregular-whitespace.md) | disallow irregular whitespace | |
-| [vue/no-lifecycle-after-await](./no-lifecycle-after-await.md) | disallow asynchronously registered lifecycle hooks | |
-| [vue/no-ref-as-operand](./no-ref-as-operand.md) | disallow use of value wrapped by `ref()` (Composition API) as an operand | |
 | [vue/no-reserved-component-names](./no-reserved-component-names.md) | disallow the use of reserved names in component definitions | |
 | [vue/no-restricted-syntax](./no-restricted-syntax.md) | disallow specified syntax | |
-| [vue/no-setup-props-destructure](./no-setup-props-destructure.md) | disallow destructuring of `props` passed to `setup` | |
 | [vue/no-static-inline-styles](./no-static-inline-styles.md) | disallow static inline `style` attributes | |
 | [vue/no-unsupported-features](./no-unsupported-features.md) | disallow unsupported Vue.js syntax on the specified version | :wrench: |
 | [vue/object-curly-spacing](./object-curly-spacing.md) | enforce consistent spacing inside braces | :wrench: |

diff --git a/docs/rules/attribute-hyphenation.md b/docs/rules/attribute-hyphenation.md
@@ -7,7 +7,7 @@ description: enforce attribute naming style on custom components in template
 # vue/attribute-hyphenation
 > enforce attribute naming style on custom components in template
 
-- :gear: This rule is included in `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
+- :gear: This rule is included in all of `"plugin:vue/vue3-strongly-recommended"`, `"plugin:vue/strongly-recommended"`, `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 ## :book: Rule Details

diff --git a/docs/rules/attributes-order.md b/docs/rules/attributes-order.md
@@ -7,7 +7,7 @@ description: enforce order of attributes
 # vue/attributes-order
 > enforce order of attributes
 
-- :gear: This rule is included in `"plugin:vue/recommended"`.
+- :gear: This rule is included in `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 ## :book: Rule Details

diff --git a/docs/rules/component-definition-name-casing.md b/docs/rules/component-definition-name-casing.md
@@ -7,7 +7,7 @@ description: enforce specific casing for component definition name
 # vue/component-definition-name-casing
 > enforce specific casing for component definition name
 
-- :gear: This rule is included in `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
+- :gear: This rule is included in all of `"plugin:vue/vue3-strongly-recommended"`, `"plugin:vue/strongly-recommended"`, `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 Define a style for component definition name casing for consistency purposes.

diff --git a/docs/rules/component-tags-order.md b/docs/rules/component-tags-order.md
@@ -7,7 +7,7 @@ description: enforce order of component top-level elements
 # vue/component-tags-order
 > enforce order of component top-level elements
 
-- :gear: This rule is included in `"plugin:vue/recommended"`.
+- :gear: This rule is included in `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 
 ## :book: Rule Details
 

diff --git a/docs/rules/html-closing-bracket-newline.md b/docs/rules/html-closing-bracket-newline.md
@@ -7,7 +7,7 @@ description: require or disallow a line break before tag's closing brackets
 # vue/html-closing-bracket-newline
 > require or disallow a line break before tag's closing brackets
 
-- :gear: This rule is included in `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
+- :gear: This rule is included in all of `"plugin:vue/vue3-strongly-recommended"`, `"plugin:vue/strongly-recommended"`, `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 People have their own preference about the location of closing brackets.

diff --git a/docs/rules/html-closing-bracket-spacing.md b/docs/rules/html-closing-bracket-spacing.md
@@ -7,7 +7,7 @@ description: require or disallow a space before tag's closing brackets
 # vue/html-closing-bracket-spacing
 > require or disallow a space before tag's closing brackets
 
-- :gear: This rule is included in `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
+- :gear: This rule is included in all of `"plugin:vue/vue3-strongly-recommended"`, `"plugin:vue/strongly-recommended"`, `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 ## :book: Rule Details

diff --git a/docs/rules/html-end-tags.md b/docs/rules/html-end-tags.md
@@ -7,7 +7,7 @@ description: enforce end tag style
 # vue/html-end-tags
 > enforce end tag style
 
-- :gear: This rule is included in `"plugin:vue/strongly-recommended"` and `"plugin:vue/recommended"`.
+- :gear: This rule is included in all of `"plugin:vue/vue3-strongly-recommended"`, `"plugin:vue/strongly-recommended"`, `"plugin:vue/vue3-recommended"` and `"plugin:vue/recommended"`.
 - :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
 
 ## :book: Rule Details