no-v-for-template-key.md

pageClass	sidebarDepth	title	description	since
rule-details	0	vue/no-v-for-template-key	disallow `key` attribute on `<template v-for>`	v7.0.0

vue/no-v-for-template-key

disallow key attribute on <template v-for>

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

📖 Rule Details

This rule reports the <template v-for> elements which have key attribute.

In Vue.js 2.x, disallows key attribute on <template> elements.

::: warning Note This rule is targeted at Vue.js 2.x. If you are using Vue.js 3.x, enable the vue/no-v-for-template-key-on-child rule instead. Don't enable both rules together; they are conflicting. :::

<template>
  <!-- ✓ GOOD -->
  <template v-for="item in list">
    <div :key="item.id" />
  </template>

  <!-- ✗ BAD -->
  <template v-for="item in list" :key="item.id">
    <div />
  </template>
</template>

::: tip Note If you want to report keys placed on <template> without v-for, use the vue/no-template-key rule. :::

🔧 Options

Nothing.

👫 Related Rules

• vue/no-template-key
• vue/no-v-for-template-key-on-child

📚 Further Reading

• API - Special Attributes - key
• API (for v2) - Special Attributes - key

🚀 Version

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

🔍 Implementation

• Rule source
• Test source