Vue3组件(三)把别人的组件拿过来再封装一下

简介: 在开源世界里面就是这么简单,我们完全可以在开源的UI库的基础上实现自己的想法。

胡一菲说过,做巧克力很简单嘛,把商场里卖的巧克力买回来,融化后加点葡萄干、干果,然后再造型、凝固——巧克力就做好了。


是不是超简单? 是的,在开源世界里面就是这么简单,我们完全可以在开源的UI库的基础上实现自己的想法。


那么为啥要进行二次封装呢?


  • 便于切换UI库。
  • 可以应对版本升级。
  • 可以循环绑定控件。
  • 折腾后自己用着舒服。


定义“接口”



一般UI库都会提供一些列的控件,比如form分类下面的控件,就可以有十多个,那么要封装的话,首先就要确定接口,否则只能封装个寂寞。


简洁期间,定义两个属性,一个事件。


  • modelValue


绑定控件值的,类型可以是string、number、数组等。


  • meta


统一存放控件需要的各种属性,也可以包括回调函数。


  • input


大多数情况都可以用input事件,各个的需要change等事件,不过事件比较宽松,可以灵活设定。


这里的接口并不是面向对象的接口,也没有用TypeScript那样的接口,而是一种约定和协议。原则上做限定,但是实际上还是可以放飞自我。


定义共用方法



vue2.x的时候需要使用mixin的方式,到了vue3.x 可以使用更灵活的方式来实现共用函数的目的。


inputManage


import { ref, watch } from 'vue'
const inputManage = (props, context) => {
 // 绑定控件的值
 const value = ref('')
 // 监听属性,给 value 赋值
 watch(() => props.modelValue, (v1, v2) => {
   value.value = v1
 })
 // 向父组件提交事件
 const myInput = (e) => {
   context.emit('update:modelValue', e)
   context.emit('input', e)
 }
 return {
   value,
   myInput
 }
}
export default inputManage
复制代码


  • 管理类的参数


因为要用到组件的属性和emit,所以需要设置两个参数来接收组件传递过来的属性和emit。

首先用 import 导入需要的方法,然后定义一个用于绑定控件的值 value——ref类型的——用着方便。 然后设置一个 watch 监控属性变化,然后给value赋值。 最后设计一个提交的函数。


基本设定就是这样,以后可以根据需求在完善,比如增加 blur 事件的提交,表单验证的时候可能会用到。


为啥不把组件的属性直接绑定到控件的value?一开始我就是直接绑定的,结果出错了。研究之后发现,element-plus把原生的value给覆盖了,变成了和 v-model 一样的属性了,这样就不能直接绑定组件的属性了。所以很无奈的做了一个内部的转换。


config


const metaInput = {
  type: Object,
  default: () => {
    return {
      // 通用
      controlId: Number, // 编号,区别同一个表单里的其他控件
      colName: String, // 字段名称
      controlType: Number, // 用类型编号表示type
      isClear: {
        // isClear  连续添加时是否恢复默认值
        type: Boolean,
        default: false
      },
      defaultValue: String, // 默认值
      autofocus: { // 是否自动获得焦点
        type: Boolean,
        default: false
      },
      disabled: {
        // 是否禁用
        type: Boolean,
        default: false
      },
      required: { // 必填
        type: Boolean,
        default: true
      },
      readonly: { // 只读
        type: Boolean,
        default: false
      },
      pattern: String, // 用正则做验证。
      class: {
        type: String,
        default: 'ant-input ant-input-sm'
      },
      placeholder: String,
      title: String, // 提示信息
      size: Number, // 字符宽度
      maxlength: Number, // 最大字符数
      autocomplete: { // off
        type: String,
        default: 'on'
      },
      optionKey: String, // 备选文字标识
      optionItem: Object // 备选的选项
    }
  }
}
export default {
  metaInput
}
复制代码


这个是控件需要的属性的说明和验证。这么长的代码,当然要放在独立的地方了。


逐一封装控件



然后就是辛苦活了,一个一个封装呗,这里举一个例子就好,不一一贴代码了。


text 单行文本


<!--单行文本-->
<template>
  <el-input
    v-model="value"
    @input="myInput"
    :rows="12"
    :autosize="{ minRows: 3, maxRows: 6 }"
    :show-word-limit="true"
    :maxlength="meta.maxlength"
    :placeholder="meta.placeholder"
  >
  </el-input>
</template>
<script>
import inputManage from '../manage/inputManage.js'
import { metaInput } from '../manage/config.js'
export default {
  name: 'nf-textarea',
  props: {
    modelValue: String,
    meta: metaInput
  },
  emits: ['input', 'change', 'blur', 'focus', 'clear'],
  setup (props, context) {
    const { value, myInput } = inputManage(props, context)
    return {
      value,
      myInput
    }
  }
}
</script>
复制代码


  • template


按照控件需要的属性,一个一个绑好。


  • js代码


因为把共用的部分都提取出去了,所以需要写的代码就非常少了。 定义两个属性,属性的具体定义放在共用函数里面,这里就很简洁了。


setup里面就是获取变量和方法,然后return就可以了。


其难点就是如何处理控件需要的各种属性,需要一个一个绑定好,这是一个辛苦活,需要一个一个对照。


有些属性还需要做一些转换。不过都搞定后,以后用着就非常方便了。


复选组


<!--多选组-->
<template>
  <el-checkbox-group v-model="checks" @change="myInput">
    <el-checkbox :label="3">备选项</el-checkbox>
    <el-checkbox :label="6">备选项</el-checkbox>
    <el-checkbox :label="9">备选项</el-checkbox>
  </el-checkbox-group>
</template>
复制代码


import inputManage from '../manage/inputManage.js'
import { metaInput } from '../manage/config.js'
import { ref } from 'vue'
export default {
  name: 'nf-el-from-checkbox',
  props: {
    modelValue: String,
    meta: metaInput
  },
  emits: ['input', 'change', 'blur', 'focus', 'clear'],
  setup (props, context) {
    const { value, myInput } = inputManage(props, context)
    const checks = ref([])
    return {
      value,
      myInput,
      checks
    }
  }
}
复制代码


这个稍微有点不同,因为控件的值不是string,而是一个数组,所以需要单独设置一个数组来中转一下。


如果组件有不同的需求,稍微做点修改就好。实在不行重做一个也行。js就是比较随意。。。


其他的就不一一贴了,大同小异。


表单页面里使用控件



都封装好了,那么如何使用呢?


首先要引用进来,然后设置属性就可以了,比如这样。


<el-form ref="form" :model="model" label-width="80px">
      <el-form-item label="活动名称">
        <eltext v-model="model.name" :meta="metaText"/>
      </el-form-item>
      <el-form-item label="活动网址">
        <elurl v-model="model.url" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="年龄要求">
        <elnumber v-model="model.age" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="年龄要求">
        <elrange v-model="model.age" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="活动区域">
        <elselect v-model="model.select" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="活动日期">
        <eldate v-model="model.date" :meta="metaText" @input="myChange"/> -
        <eltime v-model="model.time" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="即时配送">
        <elradios v-model="model.radio" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="活动性质">
        <elcheckbox v-model="model.checks" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="特殊资源">
        <elswitch v-model="model.switch" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item label="活动形式">
        <elarea v-model="model.contact" :meta="metaText" @input="myChange"/>
      </el-form-item>
      <el-form-item>
        <el-button type="primary" @click="onSubmit">立即创建</el-button>
        <el-button>取消</el-button>
      </el-form-item>
    </el-form>
复制代码


本来写了一个el-row版本的,但是代码太长,直接写el-form版的吧。


import { reactive } from 'vue'
import eltext from '@/components/nf-el-form/input-text.vue'
import elarea from '@/components/nf-el-form/textarea.vue'
import elurl from '@/components/nf-el-form/url.vue'
import elnumber from '@/components/nf-el-form/input-number.vue'
import elrange from '@/components/nf-el-form/input-range.vue'
import eldate from '@/components/nf-el-form/input-date.vue'
import eltime from '@/components/nf-el-form/input-time.vue'
import elradios from '@/components/nf-el-form/radios.vue'
import elcheckbox from '@/components/nf-el-form/checkbox.vue'
import elselect from '@/components/nf-el-form/select.vue'
import elswitch from '@/components/nf-el-form/switch.vue'
export default {
  name: 'eleBase',
  components: {
    eltext,
    elarea,
    elurl,
    elnumber,
    elrange,
    eldate,
    eltime,
    elradios,
    elcheckbox,
    elselect,
    elswitch
  },
  setup () {
    // 定义表单实体类
    const model = reactive({
      age: 1,
      url: '',
      name: '',
      contact: '',
      date: null,
      time: null,
      radio: 1,
      checks: [],
      select: 1,
      switch: true
    })
    // 定义样式
    const formTitleStyle = {
      'text-align': 'right',
      'padding-right': '10px'
    }
    // 控件类型的属性
    const metaText = reactive({
      controlId: 103,
      colName: 'controlType',
      controlType: 190,
      optionList: [],
      isClear: false,
      disabled: false,
      required: true,
      pattern: '',
      title: '组件类型',
      placeholder: '请输入组件类型',
      maxlength: 100,
      readonly: false
    })
    const myChange = (e) => {
      // alert(e)
      console.log('changele')
    }
    return {
      model,
      formTitleStyle,
      metaText,
      myChange
    }
  }
}
复制代码


首先是注册组件,然后定义组件需要的属性,然后return就可以了。


能不能简化?



当然可以了,这样的代码对于我这么懒的人,还是太麻烦了。 那么如何简化呢?这个有很多种方法,比如v-for,比如做一个单独的表单组件。


总之方法有很多,具体方法,下次再说。


先看看效果图:


image.png


看图是不是感觉没啥特别的,这个嘛看效果当然没啥特别的了,关键是代码如何实现的,你说对不。


相关文章
|
22天前
|
缓存 JavaScript UED
Vue3中v-model在处理自定义组件双向数据绑定时有哪些注意事项?
在使用`v-model`处理自定义组件双向数据绑定时,要仔细考虑各种因素,确保数据的准确传递和更新,同时提供良好的用户体验和代码可维护性。通过合理的设计和注意事项的遵循,能够更好地发挥`v-model`的优势,实现高效的双向数据绑定效果。
126 64
|
22天前
|
JavaScript 前端开发 API
Vue 3 中 v-model 与 Vue 2 中 v-model 的区别是什么?
总的来说,Vue 3 中的 `v-model` 在灵活性、与组合式 API 的结合、对自定义组件的支持等方面都有了明显的提升和改进,使其更适应现代前端开发的需求和趋势。但需要注意的是,在迁移过程中可能需要对一些代码进行调整和适配。
101 60
|
22天前
|
前端开发 JavaScript 测试技术
Vue3中v-model在处理自定义组件双向数据绑定时,如何避免循环引用?
Web 组件化是一种有效的开发方法,可以提高项目的质量、效率和可维护性。在实际项目中,要结合项目的具体情况,合理应用 Web 组件化的理念和技术,实现项目的成功实施和交付。通过不断地探索和实践,将 Web 组件化的优势充分发挥出来,为前端开发领域的发展做出贡献。
28 8
|
21天前
|
存储 JavaScript 数据管理
除了provide/inject,Vue3中还有哪些方式可以避免v-model的循环引用?
需要注意的是,在实际开发中,应根据具体的项目需求和组件结构来选择合适的方式来避免`v-model`的循环引用。同时,要综合考虑代码的可读性、可维护性和性能等因素,以确保系统的稳定和高效运行。
21 1
|
21天前
|
JavaScript
Vue3中使用provide/inject来避免v-model的循环引用
`provide`和`inject`是 Vue 3 中非常有用的特性,在处理一些复杂的组件间通信问题时,可以提供一种灵活的解决方案。通过合理使用它们,可以帮助我们更好地避免`v-model`的循环引用问题,提高代码的质量和可维护性。
32 1
|
22天前
|
JavaScript
在 Vue 3 中,如何使用 v-model 来处理自定义组件的双向数据绑定?
需要注意的是,在实际开发中,根据具体的业务需求和组件设计,可能需要对上述步骤进行适当的调整和优化,以确保双向数据绑定的正确性和稳定性。同时,深入理解 Vue 3 的响应式机制和组件通信原理,将有助于更好地运用 `v-model` 实现自定义组件的双向数据绑定。
|
JavaScript
Vue的非父子组件之间传值
全局事件总线 一种组件间通信的方式,适用于任意组件间通信
|
缓存 JavaScript 前端开发
Vue Props、Slot、v-once、非父子组件间的传值....
Vue Props、Slot、v-once、非父子组件间的传值....
86 0
|
JavaScript
Vue中父子组件传值
先在⽗组件中给⼦组件的⾃定义属性绑定⼀个⽗组件的变量
|
JavaScript
vue 组件传值
vue 组件传值
84 0
下一篇
DataWorks