# vue/valid-v-bind-sync

enforce valid .sync modifier on v-bind directives

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

This rule checks whether every .sync modifier on v-bind directives is valid.

# 📖 Rule Details

This rule reports .sync modifier on v-bind directives in the following cases:

The .sync modifier does not have the attribute value which is valid as LHS. E.g. <MyComponent v-bind:aaa.sync="foo() + bar()" />, <MyComponent v-bind:aaa.sync="a?.b" />
The .sync modifier has potential null object property access. E.g. <MyComponent v-bind:aaa.sync="(a?.b).c" />
The .sync modifier is on non Vue-components. E.g. <input v-bind:aaa.sync="foo"></div>
The .sync modifier's reference is iteration variables. E.g. <div v-for="x in list"><MyComponent v-bind:aaa.sync="x" /></div>

<template>
  <!-- ✓ GOOD -->
  <MyComponent v-bind:aaa.sync="foo"/>
  <MyComponent :aaa.sync="foo"/>

  <div v-for="todo in todos">
    <MyComponent v-bind:aaa.sync="todo.name"/>
    <MyComponent :aaa.sync="todo.name"/>
  </div>

  <!-- ✗ BAD -->
  <MyComponent v-bind:aaa.sync="foo + bar" />
  <MyComponent :aaa.sync="foo + bar" />

  <MyComponent :aaa.sync="a?.b.c" />
  <MyComponent :aaa.sync="(a?.b).c" />

  <input v-bind:aaa.sync="foo">
  <input :aaa.sync="foo">

  <div v-for="todo in todos">
    <MyComponent v-bind:aaa.sync="todo" />
    <MyComponent :aaa.sync="todo" />
  </div>
</template>

Now loading...

Note

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

# 🔧 Options

Nothing.

vue/no-parsing-error

# 📚 Further Reading

Guide (for v2) - .sync Modifier (opens new window)

# 🚀 Version

This rule was introduced in eslint-plugin-vue v7.0.0

# 🔍 Implementation

← vue/no-v-model-argument vue/attribute-hyphenation →