背景

在使用 uni-app 开发小程序时,有个填写表单的需求,包含两个输入框,看起来像这样
image.png
两个在普通不过的输入框
因为需要复用一些样式和逻辑,所以将输入框抽象成了组件,代码简化后如下

  1. <template>
  2. <view>
  3. <custom-textarea v-model="text1"></custom-textarea>
  4. <custom-textarea v-model="text2"></custom-textarea>
  5. </view>
  6. </template>
  7. <script>
  8. import CustomTextarea from '@/pages/index/CustomTextarea'
  9. import { api } from '@/api'
  10. export default {
  11. components: { CustomTextarea },
  12. data() {
  13. return {
  14. text1: '',
  15. text2: '',
  16. }
  17. },
  18. watch: {
  19. async text1(newVal) {
  20. await api(newVal)
  21. },
  22. async text2(newVal) {
  23. await api(newVal)
  24. },
  25. },
  26. }
  27. </script>

子组件代码

  1. <template>
  2. <textarea :value="value" class="textarea" @input="handleInput"></textarea>
  3. </template>
  4. <script>
  5. import { debounce } from 'lodash'
  6. export default {
  7. name: 'CustomTextarea',
  8. props: {
  9. value: {
  10. type: String,
  11. },
  12. },
  13. methods: {
  14. handleInput: debounce(function (e) {
  15. console.log('value', e.target.value)
  16. this.$emit('input', e.target.value)
  17. },1000),
  18. },
  19. }
  20. </script>
  21. <style lang="less" scoped>
  22. .textarea {
  23. border: 2rpx solid red;
  24. }
  25. </style>

由于在父组件中需要依赖输入的值请求接口,为避免接口频繁调用,这边引入 lodash debounce 用于防抖
这个需求在 yeyan1996 眼中没有任何难度,但在几天后却收到了部分用户反馈,说在两个输入框分别填写了值,但最终只有一个输入框有效
这时才回头想起代码中的 debounce ….

问题原因

收到用户反馈后,yeyan1996 尝试多次点击输入框,发现问题并不是必现,最终总结出了规律
填写第一个输入框后,快速对第二个输入框进行输入,才会造成最终的表单数据中只有一个值的问题
通过下图子组件的 log 可以看到,虽然 ui 界面显示两个输入框都有值,但实际只触发了第二个输入框的 log
个输入框的 log
lodash防抖失效处理 - 图2
之所以 ui 界面显示两个输入框都有值,是因为是用户直接和 textarea 控件交互,实际并没有更新控件绑定的 value 值
最终结论:第一个输入框中被 debounce 包裹的函数并没有执行

是防抖问题么?

尝试将 debounce 去掉后,果然 bug 解决了
lodash防抖失效处理 - 图3
那么,是防抖的问题么?
不妨先思考下 Vue 组件的实现原理,我在 [Vue.js进阶]从源码角度剖析Vue的生命周期 中提到过,每个 .vue 文件可以理解为一个构造函数,或者一个 Class,而在父组件中引用组件就等于对其的实例化

  1. <view>
  2. <custom-textarea v-model="text1"></custom-textarea>
  3. <custom-textarea v-model="text2"></custom-textarea>
  4. </view>

上述代码即创建了 2 个 CustomTextarea 组件的实例
熟悉面向对象的同学应该知道,构造函数实例化时,同时会创建实例的属性和方法,一般每个实例的属性都不相同,而方法因为是函数,所以会复用,已达到节省内存的效果

  1. class Person {
  2. constructor(name) {
  3. this.name = name
  4. }
  5. eat() {}
  6. }
  7. const person1 = new Person('张三')
  8. const person2 = new Person('李四')
  9. console.log(person1.name === person2.name) // false
  10. console.log(person1.eat === person2.eat) // true

Vue2 的组件借鉴了面向对象的原理,虽然内部的实现方式不同,但最终的行为一致,即组件的每个实例都拥有不同的 data,但会复用相同的 methods
源码地址:https://github.com/vuejs/vue/blob/dev/src/core/instance/state.js#L286
image.png
286 行中 methods 对象是每个组件实例共用的,每实例化一个组件,会创建相同的引用,指向 methods 中的函数
image.png
上图案例中, 所有 custom-textarea 中的 handleInput 都指向同一个函数,而作为 props 的 value 字段是通过父组件传入的,并不会共享(分别为 text1/text2)

解决方案

经过上述的分析,答案显而易见,两个组件实例都指向了同一个被 debounce 包裹的 handleInput 函数
所以在输入第一个值后, 1000 毫秒内快速切换到第二个输入框进行输入,此时由于防抖效果仍存在,导致第一次的输入并没有计算在内
而第二次输入完毕后,经过 1000 毫秒,最终只会执行第二个 custom-textarea 的 handleInput
只要使得每个组件实例的 handleInput 互相独立,即可解决问题

  1. <template>
  2. <textarea :value="value" class="textarea" @input="handleInput"></textarea>
  3. </template>
  4. <script>
  5. import { debounce } from 'lodash'
  6. export default {
  7. name: 'CustomTextarea',
  8. props: {
  9. value: {
  10. type: String,
  11. },
  12. },
  13. data() {
  14. return {
  15. handleInput: null,
  16. }
  17. },
  18. mounted() {
  19. this.handleInput = debounce(function (e) {
  20. console.log('value', e.target.value)
  21. this.$emit('input', e.target.value)
  22. }, 1000)
  23. },
  24. }
  25. </script>
  26. <style lang="less" scoped>
  27. .textarea {
  28. border: 2rpx solid red;
  29. }
  30. </style>

将 handleInput 从 methods 放到 data 中,每次初始化时创建防抖函数,此时每个组件实例的 handleInput 就不会互相干扰
lodash防抖失效处理 - 图6
大功告成🎉🎉🎉

题外话

Vue 组件中通过将 data 定义为一个函数,函数的返回值作为组件的数据来源,使得每个组件实例的数据都不相同
而 Vue 组件中 methods 是所有实例共用的,那么对于 watch/computed/生命周期,它们是否会共用的呢?

  1. <template>
  2. <textarea :value="value" class="textarea" @input="handleInput"></textarea>
  3. </template>
  4. <script>
  5. import { debounce } from 'lodash'
  6. export default {
  7. name: 'CustomTextarea',
  8. props: {
  9. value: {
  10. type: String,
  11. },
  12. },
  13. data() {
  14. return {
  15. handleInput: null,
  16. }
  17. },
  18. computed: {
  19. computedValue() {
  20. return this.value
  21. },
  22. },
  23. watch: {
  24. value(newVal) {
  25. console.log('value', newVal)
  26. },
  27. },
  28. methods:{
  29. method(){}
  30. },
  31. mounted() {
  32. this.handleInput = debounce(function (e) {
  33. this.$emit('input', e.target.value)
  34. }, 1000)
  35. },
  36. }
  37. </script>

和 methods 对象相同,computed 对象的属性名是一个响应式变量,而值是一个函数,所以所有实例也会指向同一个函数,但由于这个函数需要有返回值,所以不会用防抖函数进行包裹,很少遇到函数公用导致的问题
而 watch 也和 methods 对象相同,所有组件实例共用,所以也会存在防抖的问题
至于生命周期本身就是一个函数,如果对生命周期设置了防抖,多个组件实例同时初始化时也会造成只执行一次的情况。