script/prefer-use-template-ref
Recomendar useTemplateRef em vez de ref para referências de template (Vue 3.5+).
| Severidade padrão | Predefinições | Correção automática | Opções |
|---|---|---|---|
warning |
opinionated, nuxt |
Não | Nenhuma |
Aplicável a: Scripts JS/TS em SFCs Vue; os exemplos mostram a forma relevante de Options API ou script setup.
Incorreto
O ref input, que aceita null, está associado ao literal ref="input" do template, identificando-o como uma referência de elemento em vez de um dado comum que aceita null.
<script setup lang="ts">
import { ref } from 'vue'
const input = ref<HTMLInputElement | null>(null)
</script>
<template>
<input ref="input" />
</template>
Correto
useTemplateRef<HTMLInputElement>('input') do Vue 3.5+ torna essa referência de template explícita. O error = ref(null) sem associação permanece um dado comum e fica intencionalmente fora desta regra.
<script setup lang="ts">
import { ref, useTemplateRef } from 'vue'
// Paired with the template ref below.
const input = useTemplateRef<HTMLInputElement>('input')
// A nullable data ref the template never binds as a ref.
const error = ref(null)
</script>
<template>
<input ref="input" />
<p>{{ error }}</p>
</template>
Configuração (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"script/prefer-use-template-ref": "warn"
}
},
});
Depois, execute vp run lint.