封装一个vue3的公共组件

本文详细介绍了在Vue3中如何封装公共组件,包括重复使用的组件、业务无关的通用组件以及复杂组件的拆分,以提高代码可维护性和一致性,如快递组件选择示例,并提及了全局注册组件的方法。
摘要由CSDN通过智能技术生成

在Vue 3中,封装公共组件的场景包括但不限于以下几种情况:

  • 重复使用的组件:如果你发现某个组件在多个地方重复使用,那么将其封装成公共组件是很有意义的。比如,页面中的各种表单控件(输入框、下拉框、日期选择器等)经常可以被封装成公共组件。

  • 业务无关的通用组件:当有一些组件是业务无关的,并且可以在不同的项目中重复使用时,将其封装成公共组件。比如各种Loading、提示框、消息提示等。

  • 复杂组件的拆分:有些复杂的组件可以被拆分成若干公共组件,每个公共组件承担不同的责任,这样做不但提高了可维护性,也方便了代码的重用。

  • 提高可维护性:封装公共组件可以提高代码的可维护性和可读性。通过组件封装,将业务逻辑和UI组件分离,使得代码结构更加清晰。

  • 标准化UI风格:封装公共组件有助于保持一致的UI风格。例如,如果你希望所有的表单输入框都具有相同的风格和交互行为,那么可以封装一个通用的表单输入框组件。

这里使用的场景是重复使用的组件:定义一个公共的快递组件选择,首先在项目的src下面定义一个文件夹components,然后在里面创建文件ExpressList.vue。
在这里插入图片描述
ExpressList.vue文件里面的代码

<template>
    <div class="expressValue-list">
        <el-select v-model="expressValue" class="w-220" placeholder="请选择" @change="changeExpress">
            <el-option label="全部" value="" v-if="isAll" />
            <el-option v-for="(item, index) in expressList" :key="item.id" :value="isId ? item.id : item.code" :label="item.name" />
        </el-select>
    </div>
</template>
<script setup >
import { onBeforeMount, ref, watch } from "vue" 
const expressList = ref([])
const props = defineProps({
    listValue: [String, Number],
    isId: {
        default: false,
        type: Boolean
    }, //是否需要id传默认false
    isAll: {
        default: false,
        type: Boolean
    },//是否开启查找全部功能,默认false
    //可以加其它任何根据项目需要的条件,上面的只是举例
})
const emits = defineEmits(['update:listValue']);
const expressValue = computed({
    get: () => { return props.listValue },
    set: newVal => emits('update:listValue', newVal)
});
const changeExpress = (value) => {
    expressValue.value = value
}
//这里真实项目掉接口获取
const getExpress = () => { 
    expressList.value =    [
        {
            "id": "1",
            "code": "YD",
            "name": "韵达速递",
        },
        {
            "id": "2",
            "code": "ZTO",
            "name": "中通快递",
        },
        {
            "id": "3",
            "code": "SF",
            "name": "顺丰速运",
        },
        {
            "id": "4",
            "code": "YTO",
            "name": "圆通速递",
        },
        {
            "id": "5",
            "code": "YZPY",
            "name": "邮政快递包裹",
        },
        {
            "id": "6",
            "code": "STO",
            "name": "申通快递",
        },
        {
            "id": "7",
            "code": "JD",
            "name": "京东快递",
        },
        {
            "id": "8",
            "code": "EMS",
            "name": "EMS",
        },
        {
            "id": "9",
            "code": "HTKY",
            "name": "百世快递",
        },
        {
            "id": "10",
            "code": "JTSD",
            "name": "极兔速递",
        },
        {
            "id": "11",
            "code": "DNWL",
            "name": "丹鸟",
        },
        {
            "id": "12",
            "code": "EMS",
            "name": "邮政电商标快",
        },
        {
            "id": "13",
            "code": "SF",
            "name": "顺丰快运",
        }
    ]
}
onBeforeMount(() => {
    getExpress()
})
</script>

<style lang="scss" scoped>
.expressValue-list {
.w-220{
	width:220px;
}
</style>

到这里一个基础的下拉选择快递的公共组件模版就完成了,最后那么在项目里面怎么使用呢???
向下面这样使用

//父组件
<template>
    <div class="page">
      <ExpressList v-model:listValue="express" :isAll="true"/>
    </div>
</template>
 //express就是双向 绑定的选择下拉框的值
 //isAll=ture ,开启全部查找的功能

最后看截图
在这里插入图片描述
注 :因为公共组件会在项目里面多次使用,所以可以全局注册组件,
关于如何注册全局组件可以看官网 组件注册

  • 10
    点赞
  • 9
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
Vue组件是可重用的UI元素,可以封装公共组件供其他组件和应用程序使用。下面是一个简单的步骤来封装一个Vue公共组件。 1. 创建组件文件:在项目中创建一个组件文件,命名为Example.vue。 2. 编写组件内容:在Example.vue文件中定义组件的模板、样式和行为。 3. 导出组件:在Example.vue文件中使用export default将组件导出,以便其他组件和应用程序可以使用它。 4. 引入组件:在需要使用该组件的文件中,使用import Example from './Example.vue'导入该组件。 5. 注册组件:在需要使用该组件Vue实例中,使用Vue.component('example', Example)注册该组件,其中'example'是组件的名称,可以在模板中使用该名称来引用该组件。 6. 使用组件:在该Vue实例的模板中使用<example></example>标签来使用该组件。 下面是一个简单的示例,演示如何封装一个Vue公共组件: Example.vue文件: ``` <template> <div class="example"> <h2>{{ title }}</h2> <p>{{ content }}</p> </div> </template> <script> export default { name: 'Example', props: { title: String, content: String } } </script> <style> .example { border: 1px solid #ccc; padding: 10px; } .example h2 { margin-top: 0; } </style> ``` 在需要使用该组件的文件中: ``` <template> <div> <example title="Hello" content="This is an example component"></example> </div> </template> <script> import Example from './Example.vue' export default { components: { Example } } </script> ``` 在Vue实例中注册组件: ``` Vue.component('example', Example) ``` 使用组件: ``` <example title="Hello" content="This is an example component"></example> ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Jet_closer

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值