页面越写越大,最后会变成一个几百行的 App.vue:导航、列表、表单、弹窗全在里面。组件化就是把这团东西拆成可命名、可复用、可单独修改的块。
但组件不是“把 HTML 剪成几段”。一个真正好用的组件,要有清晰的输入(props)、输出(事件)、内部状态和边界。
图 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 事件,让父组件决定要不要改。
图 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, currentCode | select |
| ChapterContent | 渲染正文 HTML | content | - |
| QuizCard | 显示一道题 | quiz | submit |
| AnswerForm | 收集答案 | type, value | update:value |
| SiteHeader | 导航与登录态 | user | logout |
拆完以后,页面组件只负责“取数据、组合组件、处理路由”,不再关心每道题怎么渲染。
5.8 本章练习
- 把第 4 章的章节列表拆成 ChapterList 组件,接收 chapters,点击时 emit select。
- 给 CourseCard 增加一个 showBref 属性,默认 true,false 时不显示简介。
- 用 BaseCard + 插槽重做课程卡片,比较两种写法哪个更清晰。
下一章讲路由:多个页面怎么组织,URL 怎么带参数,刷新后怎么还原。