你以为你在封装组件,其实你在引入混乱

一、引子:封装的幻觉

"哎,这几个页面结构差不多,我封装一下好了。"

很多开发者都会在项目中产生这样的冲动,尤其是做中后台系统时,一旦遇到几个结构类似的表单或列表页,就想提取公共组件。看起来像是 DRY(Don't Repeat Yourself)的最佳实践,实际上却很容易误入歧途:

你以为你在封装组件,其实你只是在用配置项、插槽、条件渲染造了个更复杂的黑盒。

真正的问题不是封装,而是封装的边界模糊、结构职责不清、状态逻辑耦合 UI

本文将结合真实案例,拆解初级、中级、高级组件封装的本质差异,帮助你理解------封装从不是目的,系统能力才是高级工程感的核心。


二、常见封装误区与案例拆解

1. 表单组件的封装错觉

我们先来看一个典型的错误封装案例:

xml 复制代码
<!-- 错误的Form封装 -->
<my-form :formData="form" :fields="fields" @submit="onSubmit">
  <template v-slot:extra>
    <button @click="onExport">导出</button>
  </template>
</my-form>

这段代码表面上很优雅,传了 fields 就能渲染表单,还有扩展插槽,甚至可能支持表单校验和重置逻辑。

问题在哪里?

  • 字段职责不清:字段只是表单结构吗?字段还可能影响接口参数格式、权限控制、默认值、展示方式。
  • 表单行为耦合 UI :你把逻辑写在组件内部的 @submit 回调里,这意味着每个使用这个组件的页面都得重复写一样的逻辑。
  • 扩展性差:当你需要根据字段值联动另一个字段,或某些字段有特殊的业务逻辑,组件就无法扩展。
正确做法:字段中心 + 表单驱动
ini 复制代码
const fieldSchema = [
  {
    key: 'status',
    label: '状态',
    component: 'select',
    options: getDict('STATUS'),
    rules: [{ required: true, message: '请选择状态' }],
    apiField: 'status_code',
  },
  // ...
];

然后由通用的 <SmartForm /> 组件自动识别字段类型、权限、字典等信息进行渲染与校验,同时支持联动配置。


2. 列表页状态的误封装

xml 复制代码
<!-- 错误封装:DataList.vue -->
<template>
  <el-table :data="list" />
</template>
<script>
export default {
  props: ['list'],
  mounted() {
    // fetch logic...
  }
}
</script>

你以为你抽象了一个 DataList 组件,便于多个页面复用。

实际你只是把 el-table 包了一层,不支持分页、不支持空状态、不支持 loading。

更重要的是:你没有管理状态本身。

改进方向:抽象 useSmartList()
css 复制代码
const { searchForm, tableProps, onSearch, onReset } = useSmartList({
  api: fetchData,
  defaultQuery: {},
  transform: (data) => data.map(item => ({ ...item, statusLabel: mapStatus(item.status) })),
});

然后配合页面中的 schema、columns 自动渲染,逻辑统一、行为一致。


三、组件封装的三个阶段

等级 开发目标 特征
初级 页面能用,功能不报错 逻辑散乱、字段写死、重复逻辑多
中级 页面结构清晰,组件职责明确 有组件复用,但配置灵活性不足
高级 字段驱动 + 页面生成 + 状态抽象 形成系统能力,字段中心驱动页面

举个例子:表格字段

初级:

less 复制代码
columns: [{ title: '状态', dataIndex: 'status', customRender: val => val === 1 ? '启用' : '禁用' }]

中级:

less 复制代码
columns: [{ title: '状态', dataIndex: 'status', customRender: val => getDictLabel('STATUS', val) }]

高级:

css 复制代码
fieldSchema: [{ key: 'status', label: '状态', dict: 'STATUS' }]
// 由表格组件根据 schema 自动渲染列标题、字典映射、权限控制

四、高级封装的本质:规则驱动 vs 配置堆砌

很多人误以为封装的程度越高,越通用越好。

但高级工程能力的核心在于:规则驱动而不是堆砌配置

  • 👎 低级组件:props 越来越多,写法越来越复杂,一堆 v-ifslot 判断
  • 👍 高级组件:抽象成规则,例如字段权限、字段格式、接口规范、字段联动都由统一 schema 表达

真正的高级封装:

javascript 复制代码
// 一个字段定义
{
  key: 'status',
  label: '状态',
  dict: 'STATUS',
  permissions: ['view'],
  component: 'a-select',
  format: (val) => val === 1 ? '启用' : '禁用',
  visible: (form) => form.type === 'basic'
}

你不是在写"组件",而是在写"字段规则"。字段就是视图,规则决定行为。


五、真正的系统构建力

想成为高级前端,不能只满足于组件层面的复用,而要走向"体系构建力":

  • 字段结构中心:一份配置多端复用
  • 页面模式抽象:编辑、新增、详情、弹窗统一逻辑
  • 行为驱动设计:跳转、保存、校验不再散落各处
  • 状态统一方案:支持缓存、回填、持久化

最终实现:前端是领域规则的建模者,而不仅是功能的搬运工。


六、结语:别被"封装"二字骗了

封装本身并不高级。高级的是你能否看清哪些逻辑可以通用,哪些行为需要抽象,哪些状态需要统一,哪些配置应该中心管理。

很多人写了十几二十个组件,结果维护困难,逻辑混乱。

你以为你在封装组件,其实你在引入混乱。

真正的封装,是为系统构建秩序。

相关推荐
我在北京coding8 分钟前
TypeError: Cannot read properties of undefined (reading ‘queryComponents‘)
前端·javascript·vue.js
前端开发与ui设计的老司机31 分钟前
UI前端与数字孪生结合实践探索:智慧物流的货物追踪与配送优化
前端·ui
全能打工人34 分钟前
前端查询条件加密传输方案(SM2加解密)
前端·sm2前端加密
翻滚吧键盘1 小时前
vue绑定一个返回对象的计算属性
前端·javascript·vue.js
秃了也弱了。2 小时前
Chrome谷歌浏览器插件ModHeader,修改请求头,开发神器
前端·chrome
乆夨(jiuze)2 小时前
记录H5内嵌到flutter App的一个问题,引发后面使用fastClick,引发后面input输入框单击无效问题。。。
前端·javascript·vue.js
忧郁的蛋~2 小时前
HTML表格导出为Excel文件的实现方案
前端·html·excel
小彭努力中2 小时前
141.在 Vue 3 中使用 OpenLayers Link 交互:把地图中心点 / 缩放级别 / 旋转角度实时写进 URL,并同步解析显示
前端·javascript·vue.js·交互
然我3 小时前
别再只用 base64!HTML5 的 Blob 才是二进制处理的王者,面试常考
前端·面试·html
NanLing3 小时前
【纯前端推理】纯端侧 AI 对象检测:用浏览器就能跑的深度学习模型
前端