用 customRef 做一个防抖函数,支持 element 等UI库

简介: 这几天学习Vue的官网,看到 customRef 提供了一个例子,研究半天发现这是一个防抖函数,觉得挺好,于是把这个例子扩展了一下,可以用于表单子控件和查询子控件。

这几天学习Vue的官网,看到 customRef 提供了一个例子,研究半天发现这是一个防抖函数,觉得挺好,于是把这个例子扩展了一下,可以用于表单子控件和查询子控件。


需求



  • v-model


基于 element-plus 封装表单控件,同时也要封装一下表单子控件,还有查询控件。 由于 el-input 这类的组件,把 value 封装成了 v-model,所以无法把组件的属性直接设置给内部的 el-input。 必须在内部设置一个变量,然后做“属性” <==> “变量” 的转换。 这样就比较麻烦,需要一个既优雅又实用的方式来解决。


  • 查询的防抖


查询的时候,理想情况是用户输入一个完整的查询条件,然后自动去后端申请查询,但是vue默认的响应形式是,输入一个字符就会响应,如果立即去后端查询的话,会造成浪费的情况,另外用户体验也不好。 如果用change事件,那么用户输入完毕,还得在其他的地方点一下,比较麻烦。 所以需要一个简单的方式,比如防抖功能来优化用户体验。


设计



用 customRef (自定义的ref)设计get 和 set。


  • get:获取组件属性,返回给内部组件,比如 el-input。


  • set:用smit提交给父组件。


  • settimeout:实现防抖。


实施验证



想法挺好的,演示为0的时候也是好用的,但是把延迟设为200的时候确出现问题,首先是 el-input 的字符显示也一起延迟了,另外只会显示最后一个字符,中间的字符都被吃掉了。


这是怎么回事?用html5的 input 试验的时候是没有问题的呀。


办法重臂困难多,几经修改之后终于好用了。


/**
 * 自定义的ref,实现属性和内部变量的数据转换
 * @param { reactive } props 组件的属性
 * @param { object } context 组件的上下文
 * @param { number } delay 延迟刷新的时间,单位:毫秒,默认:0
 * @param { string } name 要对应的属性名称,默认:modelValue
 * @returns 自定义的ref
 */
export const debounceRef = (props, context, delay = 0, name = 'modelValue') => {
  let value = props[name]
  // 计时器
  let timeout
  // 是否输入状态。输入时取 value;输入完毕取 modelValue 属性
  let isInput = false
  return customRef((track, trigger) => {
    return {
      get () {
        track()
        if (isInput) {
          return value
        } else {
          return props[name]
        }
      },
      set (newValue) {
        isInput = true
        value = newValue // 绑定值
        trigger() // 组件内部刷新模板
        clearTimeout(timeout) // 清掉上一次的计时
        timeout = setTimeout(() => {
          // 修改 modelValue 属性
          context.emit(`update:${name}`, newValue) // 提交给父组件
          // 用于区分是哪个组件触发的事件。
          context.emit('my-change', newValue, props.controlId, props.colName)
          isInput = false
        }, delay)
      }
    }
  })
}
复制代码


  • 参数


  1. props: 组件的属性,便于属性值变更的时候可以获得最新值。
  2. context 组件的上下文,方便向父组件提交。
  3. name:v-model的名称,默认是 modelValue。
  4. delay:延迟时间,默认是0。


  • value:内部变量,用于初始值和用户输入的时候的绑定。


  • let timeout:定时器,便于清掉之前的定时。


  • let isInput = false


用户的输入状态,如果用户处于敲键盘的状态,那么获取内部的 value 绑定到 el-inupt; 如果用户没有敲键盘,那么获取父组件的属性值,绑定到 el-inupt。


为啥要这么设置呢?没办法,如果直接获取组件的属性值的话,那么会出现延迟的情况,如果获取内部 value 的话,父组件的属性变化的时候,内部 el-input 不会有变化,所以只好这么折腾一下。


后面的就是常规操作了,get 里面根据状态获取属性和 value,set 里面向父组件提交。


使用



setup (props, context) {
  const value = debounceRef(props, context)
  return {
    value
  }
}
复制代码


<el-input v-model="value"></el-input>
复制代码


基本上和普通的 ref 很像,只是需要设置组件的属性和上下文。


  • 如果名称不是默认的 modelValue 的话,需要传递名称;


  • 如果需要延迟响应的话,需要设置延迟时间,默认是不延迟的。


缺点:



  • 灵活性欠佳,只是针对一个特定需求封装的,没有考虑更多的情况。其他情况在写个函数好了,函数要符合原子性,不要承担太多的职责。


  • 还是要传递属性和上下文,这个也没啥办法省略。


  • CheckBox又不支持延迟了。记得之前好用的。。。


优点:



  • 自我感觉还是比较优雅的。


作者:金色海洋

链接:https://juejin.cn/post/6946813460571389965

来源:稀土掘金

著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

相关文章
|
13天前
|
搜索推荐 前端开发 C#
推荐7款美观且功能强大的WPF UI库
推荐7款美观且功能强大的WPF UI库
|
1月前
|
JavaScript
基于Element UI或Element Plus实现具有倒计时的Message消息提示
本文介绍了如何在Element UI或Element Plus框架中实现具有倒计时功能的消息提示组件,支持多次点击生成多个独立倒计时的消息提示,并提供了详细的实现代码和使用示例。
177 1
基于Element UI或Element Plus实现具有倒计时的Message消息提示
|
30天前
|
API Android开发
Android项目架构设计问题之选择和使用合适的UI库如何解决
Android项目架构设计问题之选择和使用合适的UI库如何解决
38 0
|
1月前
|
JavaScript UED
基于Vue2.0仿Element UI的el-tooltip实现一个气泡框组件,支持多数据类型的显示和内容为空时不显示气泡框
该文章介绍了如何基于Vue2.0仿照Element UI的el-tooltip组件实现一个自定义的气泡框组件,该组件能够根据内容是否为空智能显示或隐藏,支持多种数据类型的显示。
65 0
基于Vue2.0仿Element UI的el-tooltip实现一个气泡框组件,支持多数据类型的显示和内容为空时不显示气泡框
|
1月前
|
JavaScript 开发者
Element UI & Element Plus之改变表格单元格颜色
这篇文章展示了如何在Element UI和Element Plus框架中使用`:cell-style`属性来根据条件改变表格单元格的颜色。
109 0
Element UI & Element Plus之改变表格单元格颜色
|
1月前
|
C# 开发者 Windows
一款基于Fluent设计风格、现代化的WPF UI控件库
一款基于Fluent设计风格、现代化的WPF UI控件库
|
20天前
|
开发者 C# Android开发
明白吗?Xamarin与Native的终极对决:究竟哪种开发方式更适合您的项目需求,让我们一探究竟!
【8月更文挑战第31天】随着移动应用开发的普及,开发者面临多种技术选择。本文对比了跨平台解决方案Xamarin与原生开发方式的优势与劣势。Xamarin使用C#进行跨平台开发,代码复用率高,可大幅降低开发成本;但因基于抽象层,可能影响性能。原生开发则充分利用平台特性,提供最佳用户体验,但需维护多套代码库,增加工作量。开发者应根据项目需求、团队技能和预算综合考量,选择最适合的开发方式。
59 0
|
21天前
|
JavaScript 前端开发 开发者
决战前端之巅!Element UI与Vuetify谁才是Vue.js组件界的霸主?一场关于颜值与实力的较量!
【8月更文挑战第30天】本文对比了两款热门的Vue.js组件库——Element UI与Vuetify。Element UI由饿了么团队打造,提供多种高质量UI组件,设计简洁大方。Vuetify基于Material Design规范,支持Vue.js 2.0及3.0版本,具备前瞻性。两者均涵盖表单、导航、数据展示等组件,Element UI配置选项丰富,而Vuetify则提供了更深层的样式定制功能。开发者可根据项目需求及个人偏好选择合适的组件库。
67 0
|
21天前
|
JavaScript 开发者 UED
Vue.js组件库大对决:Element UI与Vuetify,开发者的罗密欧与朱丽叶!
【8月更文挑战第30天】Element UI和Vuetify是Vue.js开发中的热门组件库,前者简洁高效,后者遵循Material Design,国际化程度高。两者均提供丰富的组件支持,但Vuetify组件更多样,设计更灵活;Element UI在性能和中文支持上更优。文档方面,Element UI更直观易懂,而Vuetify配置灵活但学习成本稍高。选择时需综合考虑项目需求、团队背景及设计风格,以达到最佳开发效果。
65 0
|
1月前
|
数据可视化 数据挖掘 持续交付
Axure Web端元件库:从Quick UI到500+组件的飞跃
在快速变化的数字世界中,产品设计不仅仅是功能的堆砌,更是用户体验的精心雕琢。原型设计作为产品开发过程中的关键环节,其重要性不言而喻。Axure,作为业界领先的原型设计工具,凭借其强大的交互设计和丰富的功能,赢得了全球设计师和开发者的信赖。而Axure Web端元件库,则是这一平台上的一颗璀璨明珠,它以超过500个精心设计的组件为基础,为设计师们打开了一扇通往高效、高质量原型设计的大门。