认识自定义指令
在Vue的模板语法中我们学习过各种各样的指令:v-show、v-for、v-model等等,除了使用这些指令之外,Vue也允许我们来自定义自己的指令。
注意:在Vue中,代码的复用和抽象主要还是通过组件 通常在某些情况下,你需要对DOM元素进行底层操作,这个时候就会用到自定义指令
自定义指令分为两种
- 自定义局部指令:组件中通过
directives选项,只能在当前组件中使用 - 自定义全局指令:app的
directive方法,可以在任意组件中被使用
比如我们来做一个非常简单的案例:当某个元素挂载完成后可以自定获取焦点
- 实现方式一:如果我们使用默认的实现方式;
- 实现方式二:自定义一个 v-focus 的局部指令;
- 实现方式三:自定义一个 v-focus 的全局指令;
实现方式一:聚焦的默认实现
<template>
<div class="app">
<input type="text" ref="inputRef">
<!-- <input type="text" v-focus> -->
</div>
</template>
<script setup>
// 聚焦的默认实现
// import useInput from "./hooks/useInput"
// const { inputRef } = useInput()
</script>
// useInput.js
import { ref, onMounted } from 'vue';
export default function useInput() {
const inputRef = ref()
onMounted(() => {
inputRef.value?.focus()
})
return { inputRef }
}
实现方式二:局部自定义指令
这个自定义指令实现非常简单,我们只需要在组件选项中使用 directives 即可; 它是一个对象,在对象中编写我们自定义指令的名称(注意:这里不需要加v-); 自定义指令有一个生命周期,是在组件挂载后调用的 mounted,我们可以在其中完成操作
export default {
directives: {
focus: {
// 生命周期的函数(自定义指令)
mounted(el) {
// console.log("v-focus应用的元素被挂载了", el)
el?.focus()
}
}
}
}
// 2.方式二: 自定义指令(局部指令)
const vFocus = {
// 生命周期的函数(自定义指令)
mounted(el) {
// console.log("v-focus应用的元素被挂载了", el)
el?.focus()
}
}
方式三:自定义全局指令
自定义一个全局的v-focus指令可以让我们在任何地方直接使用
app.directive("focus", {
// 生命周期的函数(自定义指令)
mounted(el) {
// console.log("v-focus应用的元素被挂载了", el)
el?.focus()
}
})
指令的生命周期
- 一个指令定义的对象,Vue提供了如下的几个钩子函数:
- created:在绑定元素的 attribute 或事件监听器被应用之前调用;
- beforeMount:当指令第一次绑定到元素并且在挂载父组件之前调用;
- mounted:在绑定元素的父组件被挂载后调用;
- beforeUpdate:在更新包含组件的 VNode 之前调用;
- updated:在包含组件的 VNode 及其子组件的 VNode 更新后调用;
- beforeUnmount:在卸载绑定元素的父组件之前调用;
- unmounted:当指令与元素解除绑定且父组件已卸载时,只调用一次;
指令的参数和修饰符
- 如果我们指令需要接受一些参数或者修饰符应该如何操作呢?
- info是参数的名称;
- aaa-bbb是修饰符的名称;
- 后面是传入的具体的值;
- 在我们的生命周期中,我们可以通过 bindings 获取到对应的内容:
<h2 v-xx:info.abc.cba="message">哈哈哈哈</h2>
认识Teleport
- 在组件化开发中,我们封装一个组件A,在另外一个组件B中使用:
- 那么组件A中template的元素,会被挂载到组件B中template的某个位置;
- 最终我们的应用程序会形成一颗DOM树结构;
- 但是某些情况下,我们希望组件不是挂载在这个组件树上的,可能是移动到Vue app之外的其他位置:
- 比如移动到body元素上,或者我们有其他的div#app之外的元素上;
- 这个时候我们就可以通过teleport来完成;
- Teleport是什么呢?
- 它是一个Vue提供的内置组件,类似于react的Portals;
- teleport翻译过来是心灵传输、远距离运输的意思; ✓ 它有两个属性: ➢ to:指定将其中的内容移动到的目标元素,可以使用选择器; ➢ disabled:是否禁用 teleport 的功能;
异步组件和Suspense
- 注意:目前(2022-09-19)Suspense显示的是一个实验性的特性,API随时可能会修改。
- Suspense是一个内置的全局组件,该组件有两个插槽:
- default:如果default可以显示,那么显示default的内容;
- fallback:如果default无法显示,那么会显示fallback插槽的内容;
<suspense>
<template #default>
<async-home/>
</template>
<template #fallback>
<h2>Loading</h2>
</template>
</suspense>
认识Vue插件
- 通常我们向Vue全局添加一些功能时,会采用插件的模式,它有两种编写方式:
- 对象类型:一个对象,但是必须包含一个 install 的函数,该函数会在安装插件时执行;
- 函数类型:一个function,这个函数会在安装插件时自动执行;
- 插件可以完成的功能没有限制,比如下面的几种都是可以的:
- 添加全局方法或者 property,通过把它们添加到 config.globalProperties 上实现;
- 添加全局资源:指令/过滤器/过渡等;
- 通过全局 mixin 来添加一些组件选项;
- 一个库,提供自己的 API,同时提供上面提到的一个或多个功能;
插件的编写方式
对象类型的写法
// 方式一: 传入对象的情况
app.use({
install: function(app) {
console.log("传入对象的install被执行:", app)
}
})
函数类型的写法
app.use(function(app) {
console.log("传入函数被执行:", app)
})
认识h函数
- Vue推荐在绝大数情况下使用模板来创建你的HTML,然后一些特殊的场景,你真的需要JavaScript的完全编程的能力,这个时候你可以使用 渲染函数 ,它比模板更接近编译器;
- 前面我们讲解过VNode和VDOM的概念:
- Vue在生成真实的DOM之前,会将我们的节点转换成VNode,而VNode组合在一起形成一颗树结构,就是虚拟DOM (VDOM);
- 事实上,我们之前编写的 template 中的HTML 最终也是使用渲染函数生成对应的VNode;
- 那么,如果你想充分的利用JavaScript的编程能力,我们可以自己来编写 createVNode 函数,生成对应的VNode;
- 那么我们应该怎么来做呢?使用 h()函数:
- h() 函数是一个用于创建 vnode 的一个函数;
- 其实更准备的命名是 createVNode() 函数,但是为了简便在Vue将之简化为 h() 函数;
h()函数 如何使用
- h函数可以在两个地方使用:
- render函数选项中;
- setup函数选项中(setup本身需要是一个函数类型,函数再返回h函数创建的VNode);
<script>
import { h } from 'vue'
export default {
render() {
return h("div", { className: "app" }, [
h("h2", { className: "title" }, "我是标题"),
h("p", { className: "content" }, "我是内容, 哈哈哈"),
])
}
}
</script>
<template>
<render/>
<h2 class="">内容</h2>
</template>
<script>
import { h, ref } from 'vue'
import Home from "./Home.vue"
export default {
setup() {
const counter = ref(0)
const increment = () => {
counter.value++
}
const decrement = () => {
counter.value--
}
return () => h("div", { className: "app" }, [
h("h2", null, `当前计数: ${counter.value}`),
h("button", { onClick: increment }, "+1"),
h("button", { onClick: decrement }, "-1"),
h(Home)
])
}
}
</script>
<!-- <script setup>
import { ref, h } from 'vue';
import Home from './Home.vue'
const counter = ref(0)
const increment = () => {
counter.value++
}
const decrement = () => {
counter.value--
}
const render = () => h("div", { className: "app" }, [
h("h2", null, `当前计数: ${counter.value}`),
h("button", { onClick: increment }, "+1"),
h("button", { onClick: decrement }, "-1"),
h(Home)
])
</script> -->
jsx的babel配置
- 如果我们希望在项目中使用jsx,那么我们需要添加对jsx的支持:
- jsx我们通常会通过Babel来进行转换(React编写的jsx就是通过babel转换的);
- j对于Vue来说,我们只需要在Babel中配置对应的插件即可;
- 安装Babel支持Vue的jsx插件: npm install @vue/babel-plugin-jsx -D 如果是Vite环境,需要安装插件: npm install @vitejs/plugin-vue-jsx -D
jsx计数器案例
<template>
<jsx/>
</template>
<!-- <script lang="jsx">
import { ref } from 'vue'
import About from './About.vue'
export default {
setup() {
const counter = ref(0)
const increment = () => {
counter.value++
}
const decrement = () => {
counter.value--
}
return () => (
<div class="app">
<h2>当前计数: { counter.value }</h2>
<button onClick={ increment }>+1</button>
<button onClick={ decrement }>-1</button>
<About/>
</div>
)
}
}
</script> -->
<script lang="jsx" setup>
import { ref } from 'vue'
import About from "./About.vue"
const counter = ref(0)
const increment = () => {
counter.value++
}
const decrement = () => {
counter.value--
}
const jsx = () => (
<div class="app">
<h2>当前计数: { counter.value }</h2>
<button onClick={ increment }>+1</button>
<button onClick={ decrement }>-1</button>
<About/>
</div>
)
</script>
实现过渡动画
- 在开发中,我们想要给一个组件的显示和消失添加某种过渡动画,可以很好的增加用户体验:
- React框架本身并没有提供任何动画相关的API,所以在React中使用过渡动画我们需要使用一个第三方库 react-transitiongroup;
- Vue中为我们提供一些内置组件和对应的API来完成动画,利用它们我们可以方便的实现过渡动画效果;
Vue的transition动画
- Vue 提供了 transition 的封装组件,在下列情形中,可以给任何元素和组件添加进入/离开过渡:
- 条件渲染 (使用 v-if)条件展示 (使用 v-show)
- 动态组件
- 组件根节点
<template>
<div class="app">
<div>
<button @click="isShow = !isShow">切换</button>
</div>
<transition name="xx">
<h2 v-if="isShow">哈哈哈哈</h2>
</transition>
</div>
</template>
<script setup>
import { ref } from 'vue';
const isShow = ref(false)
</script>
<style scoped>
h2 {
display: inline-block;
}
.xx-enter-from,
.xx-leave-to {
opacity: 0;
transform: scale(0.6);
}
.xx-enter-to,
.xx-leave-from {
opacity: 1;
transform: scale(1);
}
.xx-enter-active,
.xx-leave-active {
transition: all 2s ease;
}
</style>
Transition组件的原理
- 我们会发现,Vue自动给h2元素添加了动画,这是什么原因呢?
- 当插入或删除包含在 transition 组件中的元素时,Vue 将会做以下处理:
- 1.自动嗅探目标元素是否应用了CSS过渡或者动画,如果有,那么在恰当的时机添加/删除 CSS类名;
- 2.如果 transition 组件提供了JavaScript钩子函数,这些钩子函数将在恰当的时机被调用;
- 3.如果没有找到JavaScript钩子并且也没有检测到CSS过渡/动画,DOM插入、删除操作将会立即执行;
过渡动画class
- 我们会发现上面提到了很多个class,事实上Vue就是帮助我们在这些class之间来回切换完成的动画:
- v-enter-from:定义进入过渡的开始状态。
- 在元素被插入之前生效,在元素被插入之后的下一帧移除。
- v-enter-active:定义进入过渡生效时的状态。
- 在整个进入过渡的阶段中应用,在元素被插入之前生效,在过渡/动画完成之后移除。这个类可以被用来定义进入过渡的过程时间,延迟和曲线 函数。
- v-enter-to:定义进入过渡的结束状态。
- 在元素被插入之后下一帧生效 (与此同时 v-enter-from 被移除),在过渡/动画完成之后移除。
- v-leave-from:定义离开过渡的开始状态。
- 在离开过渡被触发时立刻生效,下一帧被移除。
- v-leave-active:定义离开过渡生效时的状态。
- 在整个离开过渡的阶段中应用,在离开过渡被触发时立刻生效,在过渡/动画完成之后移除。这个类可以被用来定义离开过渡的过程时间,延迟 和曲线函数。
- v-leave-to:离开过渡的结束状态。
- 在离开过渡被触发之后下一帧生效 (与此同时 v-leave-from 被删除),在过渡/动画完成之后移除。
class添加的时机和命名规则
如果我们使用的是一个没有name的transition,那么所有的class是以 v- 作为默认前缀;
- 如果我们添加了一个name属性,比如 ,那么所有的class会以 xx- 开头;
过渡css动画
前面我们是通过transition来实现的动画效果,另外我们也可以通过animation来实现。
- Vue为了知道过渡的完成,内部是在监听 transitionend 或 animationend,到底使用哪一个取决于元素应用的CSS规则:
- 如果我们只是使用了其中的一个,那么Vue能自动识别类型并设置监听; ◼ 但是如果我们同时使用了过渡和动画呢?
- 并且在这个情况下可能某一个动画执行结束时,另外一个动画还没有结束; 在这种情况下,我们可以设置 type 属性为 animation 或者 transition 来明确的告知Vue监听的类型;
<style scoped>
h2 {
display: inline-block;
}
.xx-enter-active {
animation: xxAnim 2s ease;
}
.xx-leave-active {
/* animation: xxLeaveAnim 2s ease; */
animation: xxAnim 2s ease reverse;
}
@keyframes xxAnim {
0% {
transform: scale(0);
opacity: 0;
}
50% {
transform: scale(1.2);
opacity: 0.5;
}
100% {
transform: scale(1);
opacity: 1;
}
}
@keyframes xxLeaveAnim {
0% {
transform: translateX(0);
opacity: 1;
}
100% {
transform: translateX(-500px);
opacity: 0;
}
}
</style>
同时设置过渡和动画(一般不设置)
- Vue为了知道过渡的完成,内部是在监听 transitionend 或 animationend,到底使用哪一个取决于元素应用的CSS规则:
- 如果我们只是使用了其中的一个,那么Vue能自动识别类型并设置监听;
- 但是如果我们同时使用了过渡和动画呢?
- 并且在这个情况下可能某一个动画执行结束时,另外一个动画还没有结束;
- 在这种情况下,我们可以设置 type 属性为 animation 或者 transition 来明确的告知Vue监听的类型;
显示的指定动画时间
- 我们也可以显示的来指定过渡的时间,通过 duration 属性。
- duration可以设置两种类型的值:
- number类型:同时设置进入和离开的过渡时间;
- object类型:分别设置进入和离开的过渡时间;
过渡的模式mode
- 如果我们不希望同时执行进入和离开动画,那么我们需要设置transition的过渡模式:
- in-out: 新元素先进行过渡,完成之后当前元素过渡离开;
- out-in: 当前元素先进行过渡,完成之后新元素过渡进入;
appear初次渲染
默认情况下,首次渲染的时候是没有动画的,如果我们希望给他添加上去动画,那么就可以增加另外一个属性appear
列表的过渡
- 如果希望渲染的是一个列表,并且该列表中添加删除数据也希望有动画执行呢?
这个时候我们要使用
<transition-group>组件来完成; - 使用
<transition-group>有如下的特点:
- 默认情况下,它不会渲染一个元素的包裹器,但是你可以指定一个元素并以 tag attribute 进行渲染;
- 过渡模式不可用,因为我们不再相互切换特有的元素;
- 内部元素总是需要提供唯一的 key attribute 值;
- CSS 过渡的类将会应用在内部的元素中,而不是这个组/容器本身;
列表过渡的基本使用
<template>
<div class="app">
<button @click="addNumber">添加数字</button>
<button @click="removeNumber">删除数字</button>
<button @click="shuffleNumber">打乱数字</button>
<transition-group tag="div" name="xx">
<template v-for="item in nums" :key="item">
<span>{{ item }}</span>
</template>
</transition-group>
</div>
</template>
<script setup>
import { reactive, ref } from 'vue';
import { shuffle } from "underscore";
const nums = ref([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
const addNumber = () => {
nums.value.splice(randomIndex(), 0, nums.value.length)
}
const removeNumber = () => {
nums.value.splice(randomIndex(), 1)
}
const shuffleNumber = () => {
nums.value = shuffle(nums.value)
}
const randomIndex = () => {
return Math.floor(Math.random() * nums.value.length)
}
</script>
<style scoped>
span {
margin-right: 10px;
display: inline-block;
}
.xx-enter-from,
.xx-leave-to {
opacity: 0;
transform: translateY(30px);
}
.xx-enter-to,
.xx-leave-from {
opacity: 1;
transform: translateY(0);
}
.xx-enter-active,
.xx-leave-active {
transition: all 2s ease;
}
.xx-leave-active {
position: absolute;
}
/* 针对其他移动的阶段需要的动画 */
.xx-move {
transition: all 2s ease;
}
</style>