第5章 组件化

第 5 节 / 共 17 节 课程:前后端穿透

页面越写越大,最后会变成一个几百行的 App.vue:导航、列表、表单、弹窗全在里面。组件化就是把这团东西拆成可命名、可复用、可单独修改的块。

但组件不是“把 HTML 剪成几段”。一个真正好用的组件,要有清晰的输入(props)、输出(事件)、内部状态和边界。

页面是一棵树,不是一个文件App.vue根组件SiteHeader导航与登录态CourseView课程页面SiteFooter页脚ChapterList章节树QuizCard练习题AnswerForm作答与批改拆组件的标准:是否被复用、是否独立变化、是否值得单独测试。
图 5-1 学习平台页面组件树

5.1 什么时候该拆组件

三个信号出现时,就该拆:

  • 重复:同一个结构在多个页面出现,例如导航栏、课程卡片;
  • 独立变化:某一块的交互或数据变化频繁,和页面其他部分无关;
  • 复杂到需要单独测试:例如题目作答卡、文件上传区。

反过来,只出现一次、只有几行、没有独立逻辑的块,先不要拆。过早拆组件会让 props 和事件绕来绕去,比一个大文件更难读。

5.2 一个组件的最小结构

<!-- src/components/CourseCard.vue -->
<template>
  <article class="card">
    <h3>{{ course.name }}</h3>
    <p>{{ course.bref }}</p>
    <button @click="$emit('open', course.id)">进入课程</button>
  </article>
</template>
 
<script setup>
defineProps({
  course: { type: Object, required: true }
})
 
defineEmits(['open'])
</script>
 
<style scoped>
.card { border: 1px solid #e5e7eb; border-radius: 10px; padding: 14px; }
</style>

defineProps 声明输入,defineEmits 声明输出,scoped 让样式只作用于当前组件。父组件这样使用:

<script setup>
import CourseCard from '../components/CourseCard.vue'
const courses = [{ id: 39, name: '前后端穿透', bref: 'Vue + Spring Boot' }]
function openCourse(id) { console.log(id) }
</script>
 
<template>
  <CourseCard
    v-for="c in courses"
    :key="c.id"
    :course="c"
    @open="openCourse"
  />
</template>

5.3 props 是只读的

子组件不能直接修改 props。下面这种写法短期能跑,长期一定出问题:

// 错误:直接改 props
props.course.name = '新名字'

为什么?因为同一个对象可能被多个组件引用,子组件改了,父组件和其他兄弟组件的数据也跟着变,但你找不到是谁改的。正确做法是 emit 事件,让父组件决定要不要改。

数据向下,事件向上父组件 CourseView持有章节列表子组件 ChapterList只负责显示props:chapters父给子,子只读emit:select子通知父,不直接改 props如果子组件直接改 props,数据流就断了:同一个状态会有多个修改入口,调试无从下手。规则:props 只读;要改,emit 事件让父组件改;跨多层,用 provide/inject 或状态库。
图 5-2 父子通信:props 下行,emit 上行

5.4 事件命名与参数

事件名建议用动词,kebab-case:open、select、save、remove。父组件用 @open 监听。

<!-- 子组件 -->
<button @click="$emit('select', chapter.code)">选择</button>
 
<!-- 父组件 -->
<ChapterList @select="code => current = code" />

$emit 的第二个参数开始就是事件参数,可以传多个。不要传一个巨大的对象,父组件会不知道该用哪个字段。

5.5 插槽:让组件有“内容”

有些组件外壳固定,内容由使用方决定,例如弹窗、卡片、布局。用 slot。

<!-- BaseCard.vue -->
<template>
  <section class="card">
    <header><slot name="title">默认标题</slot></header>
    <div class="body"><slot /></div>
  </section>
</template>
 
<!-- 使用 -->
<BaseCard>
  <template #title>课程简介</template>
  <p>这里是正文</p>
</BaseCard>

5.6 生命周期

组件从创建到销毁会经历几个阶段。最常用的是 onMounted(DOM 已挂载,可以发请求、初始化图表)和 onUnmounted(清理定时器、取消订阅)。

<script setup>
import { onMounted, onUnmounted, ref } from 'vue'
 
const timer = ref(null)
 
onMounted(() => {
  timer.value = setInterval(() => console.log('tick'), 1000)
})
 
onUnmounted(() => {
  clearInterval(timer.value)
})
</script>
在组件里创建的定时器、WebSocket、事件监听,必须在卸载时清理。否则组件销毁了,回调还在跑,页面会越来越卡。

5.7 组件拆分实战:章节页

一个章节页可以拆成:

组件职责输入输出
ChapterTree显示课程章节树chapters, currentCodeselect
ChapterContent渲染正文 HTMLcontent-
QuizCard显示一道题quizsubmit
AnswerForm收集答案type, valueupdate:value
SiteHeader导航与登录态userlogout

拆完以后,页面组件只负责“取数据、组合组件、处理路由”,不再关心每道题怎么渲染。

5.8 本章练习

  1. 把第 4 章的章节列表拆成 ChapterList 组件,接收 chapters,点击时 emit select。
  2. 给 CourseCard 增加一个 showBref 属性,默认 true,false 时不显示简介。
  3. 用 BaseCard + 插槽重做课程卡片,比较两种写法哪个更清晰。

下一章讲路由:多个页面怎么组织,URL 怎么带参数,刷新后怎么还原。