script/prefer-ref-over-reactive
Recomendar o uso de ref() em vez de reactive() para gerenciar estado.
| Severidade padrão | Predefinições | Correção automática | Opções |
|---|---|---|---|
warning |
Nenhuma | 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 estado é criado com reactive, contrariando a preferência desta regra de convenção por refs. O exemplo ilustra uma preferência de estilo, não um objeto reativo inerentemente inválido.
<script setup lang="ts">
// reactive requires careful handling to avoid losing reactivity
const state = reactive({
count: 0,
name: 'foo'
})
</script>
Correto
Os exemplos criam tanto estado escalar quanto de objeto com ref; campos relacionados também podem ser separados em refs distintos. Isso atende à forma preferida de criação de estado.
<script setup lang="ts">
// ref is more explicit and safer
const count = ref(0)
const name = ref('foo')
// For objects, ref still works
const user = ref({ name: 'foo', age: 20 })
// Or use multiple refs for related data
const userName = ref('foo')
const userAge = ref(20)
</script>
Configuração (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"script/prefer-ref-over-reactive": "warn"
}
},
});
Depois, execute vp run lint.