vue/no-template-shadow
Proibir nomes de variáveis que ocultam variáveis de um escopo externo.
| Severidade padrão | Predefinições | Correção automática | Opções |
|---|---|---|---|
warning |
happy-path, nuxt, ecosystem, opinionated |
Não | Nenhuma |
Aplicável a: Templates e blocos de SFC Vue, com o contexto do script quando exigido pela regra.
A verificação compara as vinculações de v-for, v-slot (incluindo #name) e slots com escopo da sintaxe legada dentro do template. Ela reporta o identificador que oculta uma vinculação anterior, incluindo declarações no mesmo elemento, na ordem dos atributos. Elementos irmãos têm escopos independentes. Chaves de propriedades e referências em valores padrão não são declarações, e v-pre torna sua subárvore inerte.
Nomes do script e de propriedades do componente estão fora da verificação atual: uma única vinculação no template não produz um aviso apenas porque uma vinculação no script tem o mesmo nome. Os intervalos de diagnóstico abrangem o identificador como foi escrito no código-fonte, incluindo grafias com escapes e entidades HTML.
Incorreto
O v-for interno declara item novamente e oculta a variável item externa dentro do laço aninhado.
<template>
<div v-for="item in items" :key="item.id"><span v-for="item in item.children" :key="item.id">{{ item.name }}</span></div>
</template>
Correto
O laço interno declara child, deixando item disponível para a linha externa e child para a linha aninhada.
<template>
<div v-for="item in items" :key="item.id"><span v-for="child in item.children" :key="child.id">{{ child.name }}</span></div>
</template>
Configuração (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"vue/no-template-shadow": "warn"
}
},
});
Depois, execute vp run lint.