valid-v-if.md

pageClass	sidebarDepth	title	description	since
rule-details	0	vue/valid-v-if	enforce valid `v-if` directives	v3.11.0

vue/valid-v-if

enforce valid v-if directives

• ⚙️ This rule is included in all of "plugin:vue/vue3-essential", "plugin:vue/essential", "plugin:vue/vue3-strongly-recommended", "plugin:vue/strongly-recommended", "plugin:vue/vue3-recommended" and "plugin:vue/recommended".

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

📖 Rule Details

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

• The directive has that argument. E.g. <div v-if:aaa="foo"></div>
• The directive has that modifier. E.g. <div v-if.bbb="foo"></div>
• The directive does not have that attribute value. E.g. <div v-if></div>
• The directive is on the elements which have v-else/v-else-if directives. E.g. <div v-else v-if="foo"></div>

<template>
  <!-- ✓ GOOD -->
  <div v-if="foo"/>
  <div v-else-if="bar"/>
  <div v-else/>

  <!-- ✗ BAD -->
  <div v-if/>
  <div v-if:aaa="foo"/>
  <div v-if.bbb="foo"/>
  <div
    v-if="foo"
    v-else
  />
  <div
    v-if="foo"
    v-else-if="bar"
  />
</template>

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

🔧 Options

Nothing.

👫 Related Rules

• vue/valid-v-else
• vue/valid-v-else-if
• vue/no-parsing-error

🚀 Version

This rule was introduced in eslint-plugin-vue v3.11.0

🔍 Implementation

• Rule source
• Test source