# vue/valid-v-on
enforce valid
v-on
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-on
directive is valid.
# 📖 Rule Details
This rule reports v-on
directives in the following cases:
- The directive does not have that event name. E.g.
<div v-on="foo"></div>
- The directive has invalid modifiers. E.g.
<div v-on:click.bbb="foo"></div>
- The directive does not have that attribute value and any verb modifiers. E.g.
<div v-on:click></div>
<template>
<!-- ✓ GOOD -->
<div v-on="foo"/>
<div v-on:click="foo"/>
<div @click="foo"/>
<div @click.left="foo"/>
<div @click.prevent/>
<div @click.stop/>
<!-- ✗ BAD -->
<div v-on/>
<div v-on:click/>
<div v-on:click.aaa="foo"/>
<div @click/>
</template>
Note
This rule does not check syntax errors in directives because it's checked by vue/no-parsing-error rule.
# 🔧 Options
{
"vue/valid-v-on": ["error", {
"modifiers": []
}]
}
This rule has an object option:
"modifiers"
array of additional allowed modifiers.
# "modifiers": ["foo"]
<template>
<div @click.foo="foo"/>
<div v-on:click.foo="foo"/>
</template>
# 👫 Related Rules
# 🚀 Version
This rule was introduced in eslint-plugin-vue v3.11.0