使用 Vue 3 时应避免的 10 个错误

Posted chuckQu

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用 Vue 3 时应避免的 10 个错误相关的知识,希望对你有一定的参考价值。

Vue 3已经稳定了相当长一段时间了。许多代码库都在生产环境中使用它,其他人最终都将不得不迁移到Vue 3。我现在有机会使用它并记录了我的错误,下面这些错误你可能想要避免。

使用Reactive声明原始值

数据声明在过去都是非常直接的,但是现在有很多帮助函数供我们使用。目前的规则是:

  • 使用reactive声明Object, Array, Map, Set
  • 使用ref声明String, Number, Boolean

为一个原始值使用reactive会返回一个警告,并且该值不会成为可响应式数据。

/* DOES NOT WORK AS EXPECTED */
<script setup>
import  reactive  from "vue";

const count = reactive(0);
</script>

[Vue warn]: value cannot be made reactive

矛盾的是,另一种方式是可行的。例如,使用ref来声明一个Array会在内部调用reactive

解构响应式数据

假设你有一个响应式对象拥有count属性,并且有一个按钮来递增count

<template>
  Counter:  state.count 
  <button @click="add">Increase</button>
</template>

<script>
import  reactive  from "vue";
export default 
  setup() 
    const state = reactive( count: 0 );

    function add() 
      state.count++;
    

    return 
      state,
      add,
    ;
  ,
;
</script>

上述逻辑相当直接,而且如预期的那样工作,但你可能会利用javascript的解构来做以下事情:

/* DOES NOT WORK AS EXPECTED */
<template>
  <div>Counter:  count </div>
  <button @click="add">Increase</button>
</template>

<script>
import  reactive  from "vue";
export default 
  setup() 
    const state = reactive( count: 0 );

    function add() 
      state.count++;
    

    return 
      ...state,
      add,
    ;
  ,
;
</script>

代码看起来是一样的,而且根据我们以前的经验应该是可行的,但事实上,Vue的响应式跟踪是通过属性访问进行的。这意味着我们不能赋值或解构一个响应式对象,因为与第一个引用的响应式连接已经断开。这就是使用响应式帮助函数的局限性之一。

对.value感到困惑

同样的,使用ref的一个怪异模式可能也很难习惯。

Ref接收一个值,并返回响应式对象。该值在对象内部的.value属性下可用。

const count = ref(0)

console.log(count) //  value: 0 
console.log(count.value) // 0

count.value++
console.log(count.value) // 1

但是ref在模板文件中使用时会被解包,并且不需要.value

<script setup>
import  ref  from \'vue\'

const count = ref(0)

function increment() 
  count.value++

</script>

<template>
  <button @click="increment">
     count  // no .value needed
  </button>
</template>

但是要小心了!解包只在顶级属性中生效。下面的代码片段会生成[object Object]

// DON\'T DO THIS
<script setup>
import  ref  from \'vue\'

const object =  foo: ref(1) 

</script>

<template>
   object.foo + 1   // [object Object]
</template>

正确地使用.value需要时间。尽管某些时候我会忘记如何使用,但是使用它的频率越来越高。

触发事件

自从Vue的最初发布以来,子组件就可以与父组件使用emit来通信。你只需要添加自定义事件监听器来监听一个事件。

// 子组件
this.$emit(\'my-event\')

// 父组件
<my-component @my-event="doSomething" />

现在,emit需要使用defineEmits来进行声明。

<script setup>
const emit = defineEmits([\'my-event\'])
emit(\'my-event\')
</script>

另一件要记住的事情是,defineEmitsdefineProps都不需要被导入。它们在使用script setup时自动可用。

<script setup>
const props = defineProps(
  foo: String
)

const emit = defineEmits([\'change\', \'delete\'])
// setup code
</script>

最后,由于事件现在必须被声明,所以不需要使用.native修饰符,事实上它已经被移除了。

声明附加选项

Options API方法有几个属性在script setup中是不被支持的。

  • name
  • inheritAttrs
  • 插件或库所需的自定义选项

解决办法是按照script setupRFC的定义,在同一个组件中设置两个不同的脚本。

<script>
  export default 
    name: \'CustomName\',
    inheritAttrs: false,
    customOptions: 
  
</script>

<script setup>
  // script setup logic
</script>

使用响应式转换

Reactivity Transform是Vue 3的一个实验性但有争议的功能,目的是简化组件的声明方式。它的想法是利用编译时的转换来自动解包一个ref,并使.value过时。但现在它被放弃了,并将在Vue 3.3中被删除。它仍然可以作为一个包使用,但由于它不是Vue核心的一部分,所以最好不要在它身上投入时间。

定义异步组件

以前的异步组件是通过将其包含在一个函数中来声明的。

const asyncModal = () => import(\'./Modal.vue\')

从 Vue 3开始,异步组件需要使用defineAsyncComponent帮助函数来显式地定义。

import  defineAsyncComponent  from \'vue\'

const asyncModal = defineAsyncComponent(() => import(\'./Modal.vue\'))

在模板中使用多余的包裹元素

在Vue 2中,组件模板需要一个单一的根元素,这有时会引入不必要的包裹元素。

<!-- Layout.vue -->
<template>
  <div>
    <header>...</header>
    <main>...</main>
    <footer>...</footer>
  </div>
</template>

现在不再需要这样了,因为现在支持多个根元素。

以上是关于使用 Vue 3 时应避免的 10 个错误的主要内容,如果未能解决你的问题,请参考以下文章

Promise使用时应注意的问题

如何解决vue中避免冗余导航到当前位置错误?

若依vue项目部署步骤,避免刷新时出现404错误

Python老手也会犯的20个新手级错误

避免在每个请求中使用 Axios 在 Vue 中响应错误时进行处理

Vue:props 不会自动分配;手动分配时 - 避免直接改变道具 - 错误