文章目录
- 章节介绍
- 组件的概念及组件的基本使用方式
- 组件之间是如何进行互相通信的
- 组件的属性与事件是如何进行处理的
- 组件的内容是如何组合与分发处理的
- [仿Element Plus框架的el-button按钮组件实现](#仿Element Plus框架的el-button按钮组件实现)
- [单文件组件SFC及Vue CLI脚手架的安装使用](#单文件组件SFC及Vue CLI脚手架的安装使用)
- 脚手架原理之webpack处理html文件和模块打包
- 脚手架原理之webpack启动服务器和处理sourcemap
- 脚手架原理之webpack处理样式模块和图片模块
- 脚手架原理之webpack处理单文件组件及loader转换
- [仿Element Plus的el-rate评分组件实现(单文件组件)](#仿Element Plus的el-rate评分组件实现(单文件组件))
章节介绍
小伙伴大家好,本章将学习Vue3组件应用及单文件组件 - 抽象独立的代码。
本章学习目标
全面了解Vue3组件的相关概念,掌握组件之间的通信以及如何封装一个可复用的组件。了解什么是单文件组件SFC,以及脚手架的使用和底层实现机制,对工程化有一定的认知。
学习前的准备工作
官网地址:https://cn.vuejs.org/,可配套阅读文档,作为学习的辅助资料。
Vue.js文件下载地址
下载地址:https://unpkg.com/vue@3.2.36/dist/vue.global.js
组件的概念及组件的基本使用方式
组件的概念
组件是带有名称的可复用实例,通常一个应用会以一棵嵌套的组件树的形式来组织,比如:页头、侧边栏、内容区等组件。
组件可以拥有自己独立的结构,样式,逻辑。这样对于后期的维护是非常方便的。下面给出评分组件与按钮组件的抽离过程。
组件的命名方式与规范
- 定义组件可通过驼峰、短线两种风格定义
- 调用组件推荐短线方式
vue
<div id="app">
<my-head></my-head>
</div>
<script>
let app = Vue.createApp({
data(){
return {
}
}
})
app.component('my-head', {
template: `
<header>
<div>{{ message }}</div>
<h2>logo</h2>
<ul>
<li>首页</li>
<li>视频</li>
<li>音乐</li>
</ul>
</header>`,
data(){
return {
message: 'hello world'
}
}
});
let vm = app.mount('#app');
</script>
根组件
app容器可以看成根组件,所以根组件跟普通组件都具备相同的配置信息,例如:data、computed、methods等等选项。
vue
<div id="app">
<my-head></my-head>
</div>
<script>
// 根组件
let RootApp = {
data(){
return {
}
}
};
// MyHead组件
let MyHead = {
template: `
<header>
<div>{{ message }}</div>
<h2>logo</h2>
<ul>
<li>首页</li>
<li>视频</li>
<li>音乐</li>
</ul>
</header>
`
};
let app = Vue.createApp(RootApp)
app.component('MyHead', MyHead);
let vm = app.mount('#app');
</script>
根组件与MyHead组件形成了父子组件。
局部组件与全局组件
局部组件只能在指定的组件内进行使用,而全局组件可以在容器app下的任意位置进行使用。
组件之间是如何进行互相通信的
上一个小节中,我们了解了组件是可以组合的,那么就形成了父子组件,父子组件之间是可以进行通信的, 那么为什么要通信呢?主要是为了让组件满足不同的需求。
父子通信
最常见的通信方式就是父传子,或者子传父,那么父传子通过props实现,而子传父则通过emits自定义事件实现。
vue
<div id="app">
<my-head :count="count" @custom-click="handleClick"></my-head>
</div>
<script>
let app = Vue.createApp({
data(){
return {
count: 10
}
},
methods: {
handleClick(data){
console.log(data);
}
}
})
app.component('MyHead', {
props: ['count'],
emits: ['custom-click'],
template: `
<header>
<div>{{ count }}</div>
<h2>logo</h2>
<ul>
<li>首页</li>
<li>视频</li>
<li>音乐</li>
</ul>
</header>`,
mouted(){
this.$emit('custom-click', 'MyHead Data')
}
});
let vm = app.mount('#app');
</script>
父子通信需要注意的点
- 组件通信的props是可以定义类型的,在运行期间会进行检测
- 组件之间的数据是单向流动的,子组件不能直接修改传递过来的值
- 但是有时候也需要数据的双向流动,可利用v-model来实现
组件的属性与事件是如何进行处理的
有时候组件上的属性或事件并不想进行组件通信,那么Vue是如何处理的呢?
组件的属性与事件
默认不通过props接收的话,属性会直接挂载到组件容器上,事件也是如此,会直接挂载到组件容器上。可通过 inheritAttrs 选项阻止这种行为,通过指定这个属性为false,可以避免组件属性和事件向容器传递。可通过 $attrs 内置语法,给指定元素传递属性和事件,代码如下:
vue
<div id="app">
<my-head title="hello world" class="box" @click="handleClick"></my-head>
</div>
<script>
let app = Vue.createApp({
data(){
return {
}
},
methods: {
handleClick(ev){
console.log(ev.currentTarget);
}
}
})
app.component('MyHead', {
template: `
<header>
<h2 v-bind:title="$attrs.title">logo</h2>
<ul v-bind:class="$attrs.class">
<li>首页</li>
<li>视频</li>
<li>音乐</li>
</ul>
</header>
`,
mounted(){
console.log( this.$attrs ); // 也可以完成父子通信操作
},
inheritAttrs: false // 阻止默认的属性传递到容器的操作
});
let vm = app.mount('#app');
</script>
$attrs也可以实现组件之间的间接通信。
组件的内容是如何组合与分发处理的
在前面的小节中,我们学习了组件之间的通信,让组件之间实现了不同的需求,我们通过给组件添加不同的属性来实现。那么在Vue中如何去传递不同的组件结构呢?这就涉及到了组件内容的分发处理。
插槽slot
在Vue中是通过插槽slot方式来进行分发处理的,Vue 实现了一套内容分发的 API,这套 API 的设计灵感源自 Web Components 规范草案,将 元素作为承载分发内容的出口。
vue
<div id="app">
<my-head>
<p>logo</p>
</my-head>
</div>
<script>
let app = Vue.createApp({
data(){
return {
message: 'hello'
}
}
})
app.component('MyHead', {
data(){
return {
};
},
template: `
<header>
<slot></slot>
</header>`,
});
let vm = app.mount('#app');
</script>
组件内的结构,即<p>logo</p>
会被分发到<slot></slot>
所在的区域。
内容分发与插槽的注意点
- 渲染作用域 -> 插槽只能获取当前组件的作用域
- 具名插槽 -> 处理多个插槽的需求,通过v-slot指令实现,简写为#
- 作用域插槽 -> 希望插槽能访问子组件的数据
完整代码如下:
vue
<div id="app">
<my-head>
<template #title>
<p>logo, {{ message }}, {{ count }}</p>
</template>
<template #list="{ list }">
<ul>
<li v-for="item in list">{{ item }}</li>
</ul>
</template>
</my-head>
</div>
<script>
let app = Vue.createApp({
data(){
return {
message: 'hello'
}
}
})
app.component('MyHead', {
data(){
return {
count: 123,
list: ['首页', '视频', '音乐']
};
},
template: `
<header>
<slot name="title"></slot>
<hr>
<slot name="list" :list="list"></slot>
</header>
`,
});
let vm = app.mount('#app');
</script>
仿Element Plus框架的el-button按钮组件实现
本小节利用前面学习的组件通信知识,来完成一个仿Element Plus框架的el-button按钮组件实现。仿造的地址:uhttps://element-plus.org/zh-CN/component/button.html
实现需求
- 按钮类型
- 按钮尺寸
- 按钮文字
- 添加图标
完整代码如下:
vue
<style>
.el-button{
display: inline-flex;
justify-content: center;
align-items: center;
line-height: 1;
height: 32px;
white-space: nowrap;
cursor: pointer;
background-color: #ffffff;
border: 1px solid #dcdfe6;
border-color: #dcdfe6;;
color: #606266;
-webkit-appearance: none;
text-align: center;
box-sizing: border-box;
outline: none;
transition: .1s;
font-weight: 500;
user-select: none;
vertical-align: middle;
padding: 8px 15px;
font-size: 14px;
border-radius: 4px;
}
.el-button--primary{
color: white;
background-color: #409eff;
}
.el-button--success{
color: white;
background-color: #67c23a;
}
.el-button--large{
height: 40px;
padding: 12px 19px;
font-size: 14px;
}
.el-button--small{
height: 24px;
padding: 5px 11px;
font-size: 12px;
border-radius: 3px;
}
</style>
<link rel="stylesheet" href="./iconfont/iconfont.css">
<script src="../vue.global.js"></script>
<div id="app">
<el-button>default</el-button>
<el-button type="primary" size="small">Primary</el-button>
<el-button type="success" size="large">Success</el-button>
<el-button type="success" size="large">
<template #icon>
<i class="iconfont iconfangdajing"></i>
</template>
Success
</el-button>
</div>
<script>
let ElButton = {
data(){
return {
buttonClass: {
'el-button': true,
[`el-button--${this.type}`]: this.type !== '',
[`el-button--${this.size}`]: this.size !== ''
}
}
},
props: {
type: {
type: String,
default: ''
},
size: {
type: String,
default: ''
}
},
template: `
<button :class="buttonClass">
<slot name="icon"></slot>
<slot></slot>
</button>`
};
let vm = Vue.createApp({
data(){
return {
}
},
components: {
ElButton
}
}).mount('#app');
</script>
单文件组件SFC及Vue CLI脚手架的安装使用
Vue 单文件组件(又名 *.vue 文件,缩写为 SFC)是一种特殊的文件格式,它允许将 Vue 组件的模板、逻辑 与 样式封装在单个文件中。
为什么要使用 SFC
使用 SFC 必须使用构建工具,但作为回报带来了以下优点:
- 使用熟悉的 HTML、CSS 和 JavaScript 语法编写模块化的组件
- 让本来就强相关的关注点自然内聚
- 预编译模板,避免运行时的编译开销
- 组件作用域的 CSS
- 在使用组合式 API 时语法更简单
- 通过交叉分析模板和逻辑代码能进行更多编译时优化
- 更好的 IDE 支持,提供自动补全和对模板中表达式的类型检查
- 开箱即用的模块热更新 (HMR) 支持
如何支持SFC
可通过项目脚手架来进行支持,Vue支持Vite脚手架和Vue CLI脚手架。这里我们先来介绍Vue CLI的基本使用方式。
she
# 安装
npm install -g @vue/cli
# 创建项目
vue create vue-study
# 选择default
default (babel, eslint)
# 启动脚手架
npm run serve
通过localhost:8080进行访问。
脚手架文件的组成
- src/main.js -> 主入口模块
- src/App.vue -> 根组件
- src/components -> 组件集合
- src/assets -> 静态资源
单文件的代码组成
- template -> 编写结构
- script -> 编写逻辑
- style -> 编写样式
其中style中的scoped属性,可以让样式成为局部的,不会影响到其他组件,只会作用于当前组件生效,同时在脚手架下支持常见的文件进行模块化操作,例如:图片、样式、.vue文件等。
脚手架原理之webpack处理html文件和模块打包
为了更好的理解项目脚手架的使用,我们来学习一下webpack工具,因为脚手架的底层就是基于webpack工具实现的。
安装
webpack工具是基于nodejs的,所以首先要有nodejs环境,其次需要下载两个模块,一个是代码中使用的webpack模块,另一个是终端中使用的webpack-cli模块。
she
npm install --save-dev webpack
npm install --save-dev webpack-cli
配置文件
通过编写webpack.config.js文件,来编写webpack的配置信息,完成工具的操作行为。webpack最大的优点就是可以把模块化的JS文件进行合并打包,这样可以减少网络请求数,具体是通过entry和output这两个字段来完成的。
javascript
// webpack.config.js
module.exports = {
entry: {
main: './src/main.js'
},
output: {
path: __dirname + '/dist',
clean: true
}
}
在终端中进行nodejs脚本build的调用,这样去进行webpack执行,需要我们自己配置一下package.json的脚本。
shell
npm run build # -> webpack
这样在项目目录下就产生了一个 /dist 文件夹,里面有合并打包后的文件。那么我们该如何预览这个文件呢?一般可通过html文件进行引入,然后再通过浏览器进行访问。
但是html的编写还需要我们自己引入要预览的JS文件,不是特别的方便,所以是否可以做到自动完成html的操作呢?答案是可以利用webpack工具的插件HtmlWebpackPlugin来实现。
这样HtmlWebpackPlugin插件是需要安装的,通过npm i HtmlWebpackPlugin
来完成。
javascript
// webpack.config.js
module.exports = {
...,
plugins: [
new HtmlWebpackPlugin({
template: './public/index.html',
title: 'vue-study'
}),
new VueLoaderPlugin()
]
}
脚手架原理之webpack启动服务器和处理sourcemap
启动服务环境
目前我们的webpack是没有服务环境的,那么如何启动一个web服务器呢?可以通过webpack-dev-server模块,下载使用即可。
she
npm install webpack-dev-server
安装好后,再package.json中配置scripts脚本,"serve": "webpack-dev-server"
,然后运行serve脚本。这样就会启动一个http://localhost:8080的服务。
当开启了web服务后,咱们的/dist文件可以不用存在了,服务会把dist的资源打入到内存中,这样可以大大加快编译的速度,所以/dist文件夹可以删除掉了,不影响服务的启动和访问。
处理sourcemap
socurcemap启动映射文件的作用,可以通过浏览器查找到原始的文件,这样对于调试是非常有帮助的,配置如下:
js
module.exports = {
devtool: 'inline-source-map'
}
脚手架原理之webpack处理样式模块和图片模块
loader预处理文件
在模块化使用中,默认只会支持JS文件,那么怎么能够让其他类型的文件,例如:css文件、图片文件、json文件等等都可以当作模块化进行使用呢?这就需要使用loader技术。
支持css模块化
可以通过安装,css-loader
和style-loader
这两个模块来支持css模块化操作。其中css-loader
作用是让css文件能够import方式进行使用,而style-loader
的作用是把css代码抽离到<style>
标签中,这样样式就可以在页面中生效。
js
module.exports = {
module: {
rules: [
{
test: /\.css$/i,
use: ['style-loader', 'css-loader']
}
]
}
}
注意数组的顺序是先执行后面再执行前面,所以先写style-loader
再写css-loader
,这样就可以通过import './assets/common.css'
在main.js中进行使用。
图片模块
同样的情况,如果让webpack支持图片模块化也要使用对应的loader,不过在最新版本的webpack中已经内置了对图片的处理,所以只需要配置好信息就可以支持图片模块化。
js
module.exports = {
module: {
rules: [
...,
{
test: /\.(png|jpg|gif)$/i,
type: 'asset/resource'
}
]
}
}
脚手架原理之webpack处理单文件组件及loader转换
处理单文件组件
目前我们的webpack还不支持对.vue文件的识别,也不支持.vue模块化使用,所以需要安装一些模块来实现。
she
npm install vue @vue/compiler-sfc vue-loader
vue模块主要是为了让vue功能生效。@vue/complier-sfc是对单文件组件的支持。vue-loader是把单文件组件进行转换。下面看一下webpack的完整配置,如下:
javascript
const HtmlWebpackPlugin = require('html-webpack-plugin');
const { VueLoaderPlugin } = require('vue-loader');
module.exports = {
entry: {
main: './src/main.js'
},
output: {
path: __dirname + '/dist',
clean: true
},
devtool: 'inline-source-map',
module: {
rules: [
{
test: /\.css$/i,
use: ['style-loader', 'css-loader']
},
{
test: /\.(png|jpg|gif)$/i,
type: 'asset/resource'
},
{
test: /\.vue$/i,
use: ['vue-loader']
}
]
},
plugins: [
new HtmlWebpackPlugin({
template: './public/index.html',
title: 'vue-study'
}),
new VueLoaderPlugin()
],
mode: 'development'
};
通过配置操作后,目前已经可以完成一个小型的脚手架,支持模块化文件,也支持.vue文件的使用,还可以启动web服务器。
仿Element Plus的el-rate评分组件实现(单文件组件)
插件的安装
在完成本小节案例之前,先安装一下vsCode和chrome的相关插件。
- vsCode Plugin : Vue Language Features (Volar)
- vsCode Plugin : Vue VSCode Snippets
- Chrome Plugin: Vue.js devtools
这些插件都有助于vue框架的使用。下面就看一下我们要做的案例吧。
前面我们仿Element Plus实现了一个按钮组件,不过没有在脚手架的环境下,本小节会在脚手架的环境下完成一个仿Element Plus的el-rate评分组件实现。仿造组件的地址:https://element-plus.org/zh-CN/component/rate.html
实现需求
- 最大分值
- 选中分值
- 事件交互
vue
<template>
<ul class="rate">
<li v-for="index in max" :key="index" @mouseenter=" $emit('update:modelValue', index) " @mouseleave=" $emit('update:modelValue', initValue) " @click=" initValue = index "><i :class="rateClass(index)"></i></li>
</ul>
</template>
<script>
import '@/assets/iconfont/iconfont.css'
export default {
data(){
return {
initValue: this.modelValue
}
},
props: {
max: {
type: Number,
default: 5
},
modelValue: {
type: Number,
default: 0
}
},
emits: ['update:modelValue'],
methods: {
rateClass(index){
return {
iconfont: true,
'icon-xingxing': true,
active: this.modelValue >= index
}
}
}
}
</script>
<style scoped>
.rate{
display: flex;
list-style: none;
}
.rate i{
font-size: 30px;
color: #ccc;
}
.rate .active{
color: blueviolet;
}
</style>
调用评分组件,如下:
vue
<template>
<h2>hello vue</h2>
<el-rate v-model="value1"></el-rate>{{ value1 }}
<el-rate :max="6" v-model="value2"></el-rate>{{ value2 }}
</template>
<script>
import ElRateVue from './components/ElRate.vue'
export default {
name: 'App',
data(){
return {
value1: 0,
value2: 3
}
},
components: {
ElRate: ElRateVue
}
}
</script>
总结内容
- 全面掌握组件的基本操作:通信、属性、事件、内容分发等
- 实现可复用的组件,例如:按钮组件、评分组件等
- 实现可复用的组件,例如:按钮组件、评分组件等
- 脚手架原理分析,实现一个基于webpack工具的简易脚手架
- 了解Vite脚手架,下一代前端开发与构建工具