valid-v-slot.md

pageClass	sidebarDepth	title	description
rule-details	0	vue/valid-v-slot	enforce valid `v-slot` directives

vue/valid-v-slot

enforce valid v-slot directives

This rule checks whether every v-slot directive is valid.

📖 Rule Details

This rule reports v-slot directives in the following cases:

• The directive is not owned by a custom element. E.g. <div v-slot=""></div>
• The directive is a named slot and is on a custom element directly. E.g. <my-component v-slot:foo></my-component>
• The directive is the default slot, is on a custom element directly, and there are other named slots. E.g. <my-component v-slot=""><template v-slot:foo></template></my-component>
• The element which has the directive has another v-slot directive. E.g. <my-component v-slot:one v-slot:two></my-component>
• The element which has the directive has another v-slot directive that is distributed to the same slot. E.g. <my-component><template v-slot:foo></template><template v-slot:foo></template></my-component>
• The directive has a dynamic argument which uses the scope properties that the directive defined. E.g. <my-component><template v-slot:[data]="data"></template></my-component>
• The directive has any modifier. E.g. <my-component v-slot.foo></my-component>
• The directive is the default slot, is on a custom element directly, and has no value. E.g. <my-component v-slot></my-component>

<template>
  <!-- ✓ GOOD -->
  <my-component v-slot="data">
    {{data}}
  </my-component>
  <my-component>
    <template v-slot:default>
      default
    <template>
    <template v-slot:one>
      one
    <template>
    <template v-slot:two>
      two
    </template>
  </my-component>

  <!-- ✗ BAD -->
  <div v-slot="data">
    {{data}}
  </div>
  <div>
    <template v-slot:one>
      one
    </template>
  </div>

  <my-component v-slot:one="data">
    {{data}}
  </my-component>
  <my-component v-slot="data">
    {{data}}
    <template v-slot:one>
      one
    </template>
  </my-component>

  <my-component v-slot:one v-slot:two>
    one and two
  </my-component>
  <my-component>
    <template v-slot:one>
      one 1
    </template>
    <template v-slot:one>
      one 2
    </template>
  </my-component>

  <my-component>
    <template v-slot:[data]="data">
      dynamic?
    </template>
  </my-component>

  <my-component v-slot.mod="data">
    {{data}}
  </my-component>

  <my-component v-slot>
    content
  </my-component>
</template>

::: warning Note This rule does not check syntax errors in directives because it's checked by no-parsing-error rule. :::

🔧 Options

Nothing.

👫 Related rules

• no-parsing-error

🔍 Implementation

• Rule source
• Test source