Vue2 秘籍(二)
原文:
zh.annas-archive.org/md5/dd7447834c754d87cebc9999e0cff7f3译者:飞龙
第三章:过渡和动画
本章将涵盖以下内容:
-
与第三方 CSS 动画库(如 animate.css)集成
-
添加自己的过渡类
-
使用 JavaScript 而不是 CSS 进行动画
-
在初始渲染时进行过渡
-
在元素之间进行过渡
-
在过渡中在进入阶段之前让元素离开
-
为列表元素添加进入和离开过渡
-
在列表中移动的元素进行过渡
-
动画化组件的状态
-
将可重用的过渡打包成组件
-
动态过渡
介绍
本章包含与过渡和动画相关的示例。Vue 有自己的标签用于处理元素进入或离开场景时的过渡:<transition>和<transition-group>。您将学习如何使用它们,以便为您的客户提供更好的用户体验。
Vue 过渡非常强大,因为它们是完全可定制的,并且可以轻松地结合 JavaScript 和 CSS 样式,同时具有非常直观的默认值,这样您就可以在不需要所有花哨效果的情况下编写更少的代码。
即使没有过渡标签,您也可以在组件中动画化大部分内容,只需将状态变量绑定到某些可见属性即可。
最后,一旦您掌握了关于 Vue 过渡和动画的所有知识,您可以轻松地将它们打包到分层组件中,并在整个应用程序中重复使用它们。这不仅使它们强大,而且易于使用和维护。
与第三方 CSS 动画库(如 animate.css)集成
图形界面不仅需要可用性和易于理解,还应提供实惠性和愉悦性。通过提供过渡效果,可以以有趣的方式提供网站的工作方式的提示。在本示例中,我们将介绍如何在应用程序中使用 CSS 库。
准备工作
在开始之前,您可以查看daneden.github.io/animate.css/,如所示,只是为了了解可用的动画效果,但您实际上不需要任何特殊知识来继续:
操作步骤
假设您正在创建一个预订出租车的应用程序。我们将创建一个简单而有趣的界面。
首先,将animate.css库添加到依赖列表中(参考“选择开发环境”教程来学习如何做)。
接下来,我们需要使用我们通常的包装器:
<div id="app">
</div>
在包装器内部,我们将放置一个按钮来呼叫出租车:
<button @click="taxiCalled = true">
Call a cab
</button>
你可以看出我们将使用taxiCalled变量来跟踪按钮是否被按下。
让我们添加一个表情符号,以向用户确认出租车已被呼叫:
<p v-if="taxiCalled">
</p>
此时,我们可以添加一些 JavaScript 代码:
new Vue({
el: '#app',
data: {
taxiCalled: false
}
})
运行应用程序,当你按下按钮时,你会看到出租车立即出现。我们是一家很酷的出租车公司,所以让我们让出租车通过过渡驶向我们:
<transition
enter-active-class="animated slideInRight">
<p v-if="taxiCalled">
</p>
</transition>
现在运行你的应用程序;如果你呼叫出租车,它将从右侧滑动到你这里:
出租车将从右向左滑动,如图所示:
它是如何工作的...
每个过渡应用四个类。两个类在元素进入场景时应用,另外两个类在元素离开时应用:
| 名称 | 应用时机 | 移除时机 |
|---|---|---|
v-enter | 元素插入之前 | 一帧后 |
v-enter-active | 元素插入之前 | 过渡结束时 |
v-enter-to | 一帧后 | 过渡结束时 |
v-leave | 过渡开始时 | 一帧后 |
v-leave-active | 过渡开始时 | 过渡结束时 |
v-leave-to | 一帧后 | 过渡结束时 |
这里,初始的v代表你的过渡名称。如果你没有指定名称,将使用v。
虽然过渡的开始是一个明确定义的瞬间,但过渡的结束对于浏览器来说需要一些工作。例如,如果 CSS 动画循环,动画的持续时间只会是一个迭代。此外,这可能会在未来的版本中发生变化,所以请记住这一点。
在我们的例子中,我们想要提供一个第三方的v-enter-active,而不是编写我们自己的。问题是我们的库已经为我们想要使用的动画类(slideInRight)有一个不同的名称。由于我们无法更改类的名称,我们告诉 Vue 使用slideInRight而不是寻找v-enter-active类。
为了做到这一点,我们使用了以下代码:
<transition enter-active-class="animated slideInRight">
这意味着我们的v-enter-active现在被称为animated slideInRight。Vue 将在元素插入之前附加这两个类,并在过渡结束时删除它们。只要注意animated是animate.css附带的一种辅助类。
添加自己的过渡类
如果您的应用程序具有丰富的动画效果,并且希望通过混合和匹配在其他项目中重用您的 CSS 类,那么这就是适合您的方法。您还将了解一种用于高性能动画的重要技术,称为 FLIP(First Last Invert Play)。虽然后一种技术通常由 Vue 自动触发,但我们将手动实现它以更好地理解其工作原理。
准备工作
要完成此方法,您应该了解 CSS 动画和过渡的工作原理。这超出了本书的范围,但您可以在css3.bradshawenterprises.com/找到一个很好的入门指南。这个网站也很棒,因为它会解释您何时可以使用动画和过渡效果。
操作步骤...
我们将为出租车公司构建一个界面(类似于前面的示例),用户可以通过点击按钮呼叫出租车,并在呼叫出租车时提供一个漂亮的动画反馈。
编写以下 HTML 代码来创建按钮:
<div id="app">
<button @click="taxiCalled = true">
Call a cab
</button>
<p v-if="taxiCalled">
</p>
</div>
然后,您在以下 JavaScript 代码中将taxiCalled变量初始化为false:
new Vue({
el: '#app',
data: {
taxiCalled: false
}
})
此时,我们将在 CSS 中创建自定义过渡效果:
.slideInRight {
transform: translateX(200px);
}
.go {
transition: all 2s ease-out;
}
将您的汽车表情包装在 Vue 过渡中:
<transition
enter-class="slideInRight"
enter-active-class="go">
<p v-if="taxiCalled">
</p>
</transition>
当您运行代码并点击“Call a cab”按钮时,您将看到一辆出租车停在旁边。
工作原理...
当我们点击按钮时,taxiCalled变量变为true,Vue 将出租车插入到您的页面中。在实际执行此操作之前,它会读取您在enter-class中指定的类(在本例中仅为slideInRight)并将其应用于包装元素(带有出租车表情的<p>元素)。它还会应用在enter-class-active中指定的类(在本例中仅为go)。
enter-class中的类在第一帧后被移除,enter-class-active中的类在动画结束时也被移除。
此处创建的动画遵循 FLIP 技术,由四个点组成:
-
First (F):您将属性保持为动画的第一帧;在我们的例子中,我们希望出租车从屏幕右侧开始。
-
Last (L):您将属性保持为动画的最后一帧,也就是在我们的例子中出现在屏幕左侧的出租车。
-
反转(I):您反转了在第一帧和最后一帧之间注册的属性变化。由于我们的出租车向左移动,在最后一帧它将位于-200 像素偏移处。我们反转它,并将
slideInRight类的 transform 设置为translateX(200px),这样出租车出现时将位于+200 像素偏移处。 -
播放(P):我们为每个已触摸的属性创建一个过渡。在出租车示例中,我们使用 transform 属性,因此我们使用
writetransition: all 2s ease-out来平滑地过渡出租车。
Vue 在<transition-group>标签内部自动使用此技术使过渡效果正常工作。有关此内容的更多信息,请参阅“为列表元素添加进入和离开过渡”配方。
使用 JavaScript 进行动画而不是 CSS
普遍认为使用 JavaScript 进行动画会更慢,动画应该在 CSS 中完成。事实是,如果使用正确,JavaScript 中的动画可以具有相似或更好的性能。在本配方中,我们将使用简单但强大的 Velocity.js(velocityjs.org/)库创建动画:
准备工作
本配方假设您对 Velocity 库没有任何了解,但假设您对 CSS 中的动画或使用 JavaScript 库(如 jQuery)进行动画非常熟悉。如果您从未见过 CSS 动画,并且想要快速入门,请完成前两个配方,然后您应该能够跟上。
操作步骤...
我们仍在寻找一个完美的过渡效果,用于一家出租车公司(与前一个配方中相同),以在等待出租车时娱乐我们的客户。我们有一个按钮来呼叫出租车,当我们预订时会出现一个小出租车表情符号。
在任何其他操作之前,将 Velocity 库添加为项目的依赖项- cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js。
以下是创建界面骨架的 HTML 代码:
<div id="app">
<button @click="taxiCalled = true">
Call a cab
</button>
<p v-if="taxiCalled">
</p>
</div>
我们的 Vue 模型非常简单,只包含taxiCalled变量:
new Vue({
el: '#app',
data: {
taxiCalled: false
}
})
通过将小出租车包装在 Vue 过渡中创建动画:
<transition
@enter="enter"
:css="false"
>
<p v-if="taxiCalled">
</p>
</transition>
当按下按钮插入出租车表情符号时,将调用 enter 方法。
您需要将 enter 方法添加到 Vue 实例中,代码如下:
methods: {
enter (el) {
Velocity(el,
{ opacity: [1, 0], translateX: ["0px", "200px"] },
{ duration: 2000, easing: "ease-out" })
}
}
运行代码并按下按钮预订出租车!
工作原理...
正如你可能已经注意到的,你的代码中没有 CSS。动画完全由 JavaScript 驱动。让我们来解析一下 Vue 过渡:
<transition
@enter="enter"
:css="false"
>
<p v-if="taxiCalled">
</p>
</transition>
尽管这仍然是一个可以使用 CSS 的过渡,但我们希望告诉 Vue 关闭 CSS 并节省宝贵的 CPU 周期,通过设置:css="false"。这将使 Vue 跳过与 CSS 动画相关的所有代码,并防止 CSS 干扰我们纯粹的 JavaScript 动画。
精彩的部分在于@enter="enter"。我们将触发元素插入时的钩子绑定到enter方法上。方法本身如下所示:
enter (el) {
Velocity(el,
{ opacity: [1, 0], translateX: ["0px", "200px"] },
{ duration: 2000, easing: "ease-out" }
)
}
在这里,我们调用了 Velocity 库。el参数由 Vue 免费传递,并且它指的是被插入的元素(在我们的例子中,是包含汽车表情符号的<p>元素)。
Velocity 函数的语法如下所示:
Velocity( elementToAnimate, propertiesToAnimate, [options] )
还有其他语法可能,但我们将坚持这个。
在调用这个函数时,我们将段落元素作为第一个参数传递;然后我们说透明度应该从 0 变为 1,并且同时元素应该从 x 轴上的起始位置 200 像素移动到其原点。作为选项,我们指定动画持续时间为两秒,并且我们希望在接近结束时缓和动画。
我认为一切都很清楚,也许除了我们如何传递opacity和translateX参数。
这就是 Velocity 所谓的forcefeeding--我们告诉 Velocity 透明度应该从 0 开始到 1。同样,我们告诉 VelocitytranslateX属性应该从 200 像素开始,结束于 0 像素。
一般来说,我们可以避免传递数组来指定属性的初始值;Velocity 会计算如何过渡。
例如,我们可以有以下 CSS 类:
p {
opacity: 0;
}
如果我们将 Velocity 调用重写如下:
Velocity(el,
{ opacity: 1 }
)
汽车将慢慢出现。Velocity 查询了元素的初始值,然后将其过渡到 1。这种方法的问题在于,由于涉及对 DOM 的查询,某些动画可能会变慢,特别是当您有很多并发动画时。
我们可以通过使用 begin 选项来获得与 force-feeding 相同的效果,如下所示:
Velocity(el,
{ opacity: 1 },
{ begin: () => { el.style.opacity = 0 } }
)
在动画开始之前(也就是元素插入之前),将不透明度设置为零。这将有助于在较慢的浏览器中,在将元素完全移到右侧并开始动画之前,仍然会显示一闪而过的汽车。
JavaScript 动画的可能钩子在下表中总结如下:
| 属性 | 描述 |
|---|---|
@before-enter | 在元素插入之前调用此函数。 |
@enter | 在元素插入时调用此函数。 |
@after-enter | 在元素插入并完成动画时调用此函数。 |
@enter-cancelled | 在动画仍在进行中但元素必须离开时调用此函数。如果使用 Velocity,可以执行类似Velocity(el, "stop")的操作。 |
@before-leave | 在触发离开函数之前调用此函数。 |
@leave | 在元素离开时调用此函数。 |
@after-leave | 在元素离开页面时调用此函数。 |
@leave-cancelled | 在离开调用完成之前必须插入元素时调用此函数。仅适用于 v-show。 |
请注意,这些钩子对于任何库都有效,不仅仅适用于 Velocity。
还有更多...
我们可以尝试使用此界面实现一个取消按钮。如果用户错误地预订了出租车,点击取消按钮将删除预订,并且通过小出租车表情消失来显示这一点。
首先,让我们添加一个取消按钮:
<button @click="taxiCalled = false">
Cancel
</button>
这很容易;现在我们添加离开过渡效果:
<transition
@enter="enter"
@leave="leave"
:css="false"
>
<p v-if="taxiCalled">
</p>
</transition>
这将带我们到离开方法:
leave (el) {
Velocity(el,
{ opacity: [0, 1], 'font-size': ['0.1em', '1em'] },
{ duration: 200})
}
我们所做的是让表情符号消失并缩小。
如果尝试运行代码,会遇到一些问题。
当点击取消按钮时,应该发生的是离开动画应该开始,出租车应该变小并最终消失。但实际上,什么都没有发生,出租车突然消失了。
取消动画无法按计划播放的原因是,由于动画是用 JavaScript 编写而不是 CSS,Vue 无法判断动画何时完成。特别是,Vue 认为离开动画在开始之前就已经完成了。这就是我们的汽车消失的原因。
诀窍在于第二个参数。每个钩子都调用一个带有两个参数的函数。我们已经看到了第一个参数el,它是动画的主题。第二个参数是一个回调函数,当调用时,告诉 Vue 动画已经完成。
我们将利用 Velocity 有一个名为complete的选项,它期望在动画(从 Velocity 的角度)完成时调用一个函数。
让我们根据这个新信息重写我们的代码:
leave (el, done) {
Velocity(el,
{ opacity: [0, 1], 'font-size': ['0.1em', '1em'] },
{ duration: 200 })
}
通过在我们的函数中添加done参数,让 Vue 知道我们希望在动画完成时调用一个回调。我们不需要显式地使用回调,因为 Vue 会自己找出来,但是由于依赖默认行为总是一个坏主意(如果它们没有被记录,它们可能会改变),让我们在动画完成时调用done函数:
leave (el, done) {
Velocity(el,
{ opacity: [0, 1], 'font-size': ['0.1em', '1em'] },
{ duration: 200, complete: done })
}
运行你的代码,然后按下取消按钮来取消你的出租车!
在初始渲染时进行过渡
通过使用appear关键字,我们可以在元素首次加载时为其添加过渡效果。这有助于提高用户体验,因为它给人一种页面更具响应性和加载速度更快的印象,尤其是当你将其应用于许多元素时。
准备工作
这个示例不需要任何特定的知识,但是如果你至少完成了“使用 CSS 过渡为应用程序添加一些乐趣”这个示例,那么这将是小菜一碟。
操作步骤...
我们将构建一个关于美国演员 Fill Murray 的页面;不是 Bill Murray。你可以在www.fillmurray.com找到关于他的更多信息。我们将使用这个网站上的图片来填充我们关于他的页面。
在我们的 HTML 中,让我们写一个标题作为我们页面的标题:
<h1>
The Fill Murray Page
</h1>
在标题之后,我们将放置我们的 Vue 应用程序:
<div id="app">
<img src="https://fillmurray.com/50/70">
<p>
The internet was missing the ability to
provide custom-sized placeholder images of Bill Murray.
Now it can.
</p>
</div>
在浏览器中呈现时,将显示如下:
我们的页面现在非常简单。我们希望 Fill Murray 的图片淡入。我们必须将其包装在一个过渡中:
<transition appear>
<img src="https://fillmurray.com/50/70">
</transition>
以下是 CSS 类:
img {
float: left;
padding: 5px
}
.v-enter {
opacity: 0
}
.v-enter-active {
transition: opacity 2s
}
现在运行我们的页面,图片将会慢慢出现,但同时也会移动文本。为了修复这个问题,我们必须提前指定图片的大小:
<transition appear>
<img src="https://fillmurray.com/50/70" width="50" height="70">
</transition>
这样,我们的浏览器将为图片预留一些空间,以便它慢慢出现。
工作原理...
transition标签中的appear指令将使组件在首次出现时带有关联的过渡效果(如果找到)。
在组件的第一次渲染中,有许多可能的方法来指定过渡效果。在所有情况下,必须指定appear指令。
当存在该指令时,Vue 首先会查找 JavaScript 钩子或标签中指定的 CSS 类:
<transition
appear
@before-appear="customBeforeAppearHook"
@appear="customAppearHook"
@after-appear="customAfterAppearHook"
appear-class="custom-appear-class"
appear-active-class="custom-appear-active-class"
>
<p>My element</p>
</transition>
之后,如果指定了名称,Vue 将查找该元素的入场过渡效果:
<transition appear name="myTransition">
<p>My element</p>
</transition>
上述代码将查找以下命名的类:
.myTransition-enter {...}
.myTransition-enter-active {...}
如果其他方法都失败了,Vue 将查找元素插入的默认 CSS 类(v-enter和v-enter-active)。顺便说一句,这就是我们在示例中所做的。
依赖这些默认值并不是一个好的做法;在这里,我们只是作为演示而这样做。您应该始终为过渡效果命名。
也许值得一提的是,为什么我们必须为图像添加宽度和高度。原因是当我们在 HTML 中指定图像 URL 时,浏览器无法提前知道图像的大小,因此默认情况下不会为其保留任何空间。只有通过提前指定图像的大小,浏览器才能在加载图像之前正确地组合页面。
元素之间的过渡
网页上的所有内容都是元素。借助 Vue 的v-if和v-show指令,您可以轻松地使它们出现和消失。通过过渡效果,您甚至可以轻松控制它们的出现方式并添加魔法效果。本示例将解释如何实现。
准备工作
在进行本示例之前,您应该对 Vue 过渡效果和 CSS 的工作原理有一定的了解。如果您完成了第二章中的“使用 CSS 过渡为应用程序增添乐趣”示例,这将很容易实现。
操作步骤
既然我们谈到了魔法,我们将把一只青蛙变成公主。变换本身将是一个过渡效果。
我们将创建一个按钮,当按下时,表示对青蛙的亲吻:
<div id="app">
<button @click="kisses++">
Kiss!</button>
</div>
每次按下按钮时,变量 kisses 都会增加。变量将初始化为零,如下面的代码所示:
new Vue({
el: '#app',
data: {
kisses: 0
}
})
接下来,我们需要青蛙和公主,它们将立即添加到按钮之后:
<transition name="fade">
<p v-if="kisses < 3" key="frog">
frog</p>
<p v-if="kisses >= 3" key="princess">
princess</p>
</transition>
淡入淡出过渡效果的 CSS 代码如下:
.fade-enter-active, .fade-leave-active {
transition: opacity .5s
}
.fade-enter, .fade-leave-active {
opacity: 0
}
为了使其正常工作,我们需要添加一个最后的 CSS 选择器:
p {
margin: 0;
position: absolute;
font-size: 3em;
}
如果运行应用程序并多次点击亲吻按钮,您应该会看到青蛙变成公主:
这个过渡效果将具有淡入淡出的效果:
青蛙表情符号将变成公主表情符号:
工作原理如下...
当我们写下这两个元素时,我们使用了key属性来指定谁是青蛙,谁是公主。这是因为,否则 Vue 优化系统将会启动。它会发现这两个元素的内容可以互换,而不需要交换元素本身,因此不会发生过渡,因为元素是相同的,只有内容发生了变化。
如果我们移除key属性,我们可以看到青蛙和公主会改变,但没有任何过渡效果:
<transition name="fade">
<p v-if="kisses < 3">
frog</p>
<p v-if="kisses >= 3">
princess</p>
</transition>
考虑到我们使用了两个不同的元素,如下所示:
<p v-if="kisses < 3" >
frog</p>
<span v-if="kisses >= 3">
princess</span>
同时,我们相应地修改了<p>的 CSS 选择器:
p, span {
margin: 0;
position: absolute;
font-size: 3em;
display: block;
}
现在,如果我们再次启动应用程序,一切都可以正常工作,而不需要使用任何key属性。
即使在不必要的情况下,通常也建议使用键,就像前面的例子一样。特别是当项目具有不同的语义含义时,这一点尤为重要。这样做的原因有几个。主要原因是,当多个人在同一行代码上工作时,修改key属性不会像将span元素切换回p元素那样容易破坏应用程序,这将破坏我们刚刚看到的过渡效果。
还有更多...
在这里,我们介绍了前面一篇文章的两个子案例:在多个元素之间切换和绑定key属性。
在多个元素之间进行过渡
我们可以以一种简单直接的方式扩展刚刚完成的示例。
假设如果我们亲吻公主/青蛙的次数太多,她会变成圣诞老人,这可能会或可能不会吸引人,这取决于你的年龄。
首先,我们添加第三个元素:
<transition name="fade">
<p v-if="kisses < 3" key="frog">
frog</p>
<p v-else-if="kisses >= 3 && kisses <= 5" key="princess">
princess</p>
<p v-else key="santa">
santa</p>
</transition>
我们可以立即启动应用程序,当我们亲吻公主/青蛙超过五次时,圣诞老人将以相同的淡入淡出过渡效果出现:
使用这个设置,我们只能使用在前两个元素之间使用的相同过渡效果。
关于此有一个解决方法,在“动态过渡”一章中有解释。
动态设置 key 属性
如果我们已经有一些可用的数据,我们不必为所有的元素编写 key。我们可以以另一种方式编写相同的应用程序,但不重复元素,如下所示:
<transition name="fade">
<p :key="transformation">{{emoji}}{{transformation}}</p>
</transition>
当然,这意味着我们必须根据亲吻的次数为transformation和emoji变量提供一个合理的值。
为了做到这一点,我们将它们绑定到计算属性上:
computed: {
transformation () {
if (this.kisses < 3) {
return 'frog'
}
if (this.kisses >= 3 && this.kisses <= 5) {
return 'princess'
}
if (this.kisses > 5) {
return 'santa'
}
},
emoji () {
switch (this.transformation) {
case 'frog': return '
'
case 'princess': return '
'
case 'santa': return '
'
}
}
}
我们在模板中减少了一些复杂性,增加了 Vue 实例中的一些逻辑。如果我们预计未来会有更复杂的逻辑或者转换数量增加,这样做从长远来看是有好处的。
在过渡中让元素在进入阶段之前离开
在“在元素之间过渡”这个示例中,我们探讨了如何在两个元素之间进行过渡。Vue 的默认行为是在第一个元素离开的同时开始进入的元素的过渡;但这并不总是理想的。
在本示例中,您将了解到这个重要的特殊情况以及如何解决它。
准备工作
本示例是在两个元素之间过渡的基础上构建的,解决了一个特定的问题。如果您不知道我们在谈论什么,请返回上一个示例,您很快就能理解。
操作步骤
首先,如果您还没有遇到这个问题,您将看到问题所在。接下来,我们将看到 Vue 为我们提供了什么来解决它。
两个元素的问题
让我们为我们的网站创建一个轮播效果。用户一次只能查看一个产品,然后可以滑动到下一个产品。要滑动到下一个产品,用户需要点击一个按钮。
首先,我们需要在 Vue 实例中有我们的产品列表:
new Vue({
el: '#app',
data: {
product: 0,
products: ['
umbrella', '
computer', '
ball', '
camera']
}
})
在我们的 HTML 中,我们只需要一个按钮和一个元素的视图:
<div id="app">
<button @click="product++">next</button>
<transition name="slide">
<p :key="products[product % 4]">{{products[product % 4]}}</p>
</transition>
</div>
模 4(product%4)只是因为我们希望在产品列表结束时重新开始。
为了设置我们的滑动过渡,我们需要以下规则:
.slide-enter-active, .slide-leave-active {
transition: transform .5s
}
.slide-enter {
transform: translateX(300px)
}
.slide-leave-active {
transform: translateX(-300px);
}
此外,为了使一切看起来好看,我们最后加上以下内容:
p {
position: absolute;
margin: 0;
font-size: 3em;
}
如果您现在运行代码,您将看到一个漂亮的轮播效果:
现在,让我们尝试从最后一个规则中删除position: absolute:
p {
margin: 0;
font-size: 3em;
}
如果您现在运行代码,您将看到产品之间出现奇怪的跳动:
这就是我们要解决的问题。第二个过渡在第一个产品离开之前就开始了。如果定位不是绝对的,我们将看到一些奇怪的效果。
过渡模式
为了解决这个问题,我们将更改过渡模式。让我们修改<transition>的代码:
<transition name="slide" mode="out-in">
<p :key="products[product%4]">{{products[product%4]}}</p>
</transition>
现在运行程序,您将看到产品在进入屏幕之前需要更长的时间滑动。它们在进入之前等待上一个项目离开。
工作原理...
总结一下,您有两种不同的方式来管理 Vue 组件之间的过渡。默认方式是同时开始“进入”过渡和“离开”过渡。我们可以通过以下方式明确表示:
<transition mode="in-out">
<!-- elements -->
</transition>
我们可以通过等待out部分完成后再开始in动画来改变这种默认行为。我们通过以下方式实现了这一点:
<transition mode="out-in">
<!-- elements -->
</transition>
当元素具有绝对定位样式时,前者很有用,而后者更适用于在页面上放置更多内容之前需要等待有一个清晰的路径的情况。
绝对定位不会在元素重叠时关心它们,因为它们不遵循页面的流动。另一方面,静态定位将在第一个元素之后添加第二个元素,如果两个元素同时显示,过渡会变得尴尬。
为列表中的元素添加进入和离开过渡
我们已经在“创建一个动态的、带动画的列表”一节中看到了动画列表;在这里,我们将尝试添加一种视觉方式来提示列表中的元素被添加或删除。这可以为用户体验增加很多,因为您有机会向用户解释为什么添加或删除了一个元素。
准备工作
如前所述,如果您已经完成了“创建一个动态的、带动画的列表”一节,那么您已经准备好了。如果您对 CSS 和过渡有一些了解,可能会有所帮助。如果您觉得有需要,可以浏览本章中的其他示例。
操作步骤...
我们将建立一个学习编程的教学大纲。当我们完成一个主题时,我们会感到宽慰,并希望通过让主题从教学大纲中漂移出去来体现这种感觉。
列表的数据将在我们的 Vue 实例中:
new Vue({
el: '#app',
data: {
syllabus: [
'HTML',
'CSS',
'Scratch',
'JavaScript',
'Python'
]
}
})
列表将在我们的 HTML 中打印出来,代码如下:
<div id="app">
<h3>Syllabus</h3>
<ul>
<li v-for="topic in syllabus">
{{topic}}
</li>
</ul>
</div>
当我们按下一个按钮时,我们希望主题从列表中消失。为了实现这一点,我们需要修改我们已经编写的代码。
首先,在每个主题之前添加一个 Done 按钮:
<li v-for="topic in syllabus">
<button @click="completed(topic)">Done</button>{{topic}}
</li>
在这里,completed 方法将如下所示:
methods: {
completed (topic) {
let index = this.syllabus.indexOf(topic)
this.syllabus.splice(index, 1)
}
}
现在运行代码将显示一个简单的应用程序,用于勾选我们已经学习过的主题。然而,我们希望有一个动画让我们感到宽慰。
为此,我们需要编辑列表的容器。我们删除<ul>标签,并告诉<transition-group>编译为<ul>标签:
<transition-group tag="ul">
<li v-for="topic in syllabus" :key="topic">
<button @click="completed(topic)">Done</button>{{topic}}
</li>
</transition-group>
请注意,我们还根据主题为每个列表元素添加了一个键。我们需要做的最后一件事是在我们的 CSS 中添加过渡规则:
.v-leave-active {
transition: all 1s;
opacity: 0;
transform: translateY(-30px);
}
现在,当点击 Done 按钮时,主题将以过渡的方式消失,如下所示:
工作原理...
<transition-group>标签表示一组同时显示的元素的容器。默认情况下,它表示<span>标签,但通过将标签属性设置为ul,我们使其表示无序列表。
列表中的每个元素必须具有唯一的键,否则过渡效果将无法工作。Vue 会负责对进入或离开的每个元素应用过渡效果。
在列表中移动的过渡元素
在这个示例中,您将构建一个根据列表变化而移动的元素列表。当您希望告诉用户某些内容已更改并且列表已相应更新时,这种特定的动画非常有用。它还将帮助用户确定插入元素的位置。
准备工作
这个示例有点高级;如果您对 Vue 中的过渡效果不太熟悉,我建议您完成本章中的一些示例。如果您可以轻松完成“为列表元素添加进入和离开过渡效果”示例,那么您就可以开始了。
操作步骤...
您将构建一个小游戏-公交车站模拟器!
每当一辆公交车(用表情符号表示)离开车站时,其他所有公交车都会稍微前进一点,以便占据它的位置。每辆公交车都有一个编号,如 Vue 实例数据所示:
new Vue({
el: '#app',
data: {
buses: [1,2,3,4,5],
nextBus: 6
}
})
每当有新的公交车到达时,它将被分配一个递增的编号。我们希望每两秒钟有一辆新的公交车离开或到达。我们可以在组件挂载到屏幕上时挂接一个定时器来实现这一点。在数据之后,写入以下内容:
mounted () {
setInterval(() => {
const headOrTail = () => Math.random() > 0.5
if (headOrTail()) {
this.buses.push(this.nextBus)
this.nextBus += 1
} else {
this.buses.splice(0, 1)
}
}, 2000)
}
我们应用的 HTML 将如下所示:
<div id="app">
<h3>Bus station simulator</h3>
<transition-group tag="p" name="station">
<span v-for="bus in buses" :key="bus">
</span>
</transition-group>
</div>
为了使公交车移动,我们需要在前缀 station 下指定一些 CSS 规则:
.station-leave-active, .station-enter-active {
transition: all 2s;
position: absolute;
}
.station-leave-to {
opacity: 0;
transform: translateX(-30px);
}
.station-enter {
opacity: 0;
transform: translateX(30px);
}
.station-move {
transition: 2s;
}
span {
display: inline-block;
margin: 3px;
}
现在启动应用程序将导致一个有序的公交车队列,每两秒钟离开或到达一辆公交车:
工作原理...
我们应用程序的核心是<transition-group>标签。它管理着所有以其键标识的公交车:
<transition-group tag="p" name="station">
<span v-for="bus in buses" :key="bus">
</span>
</transition-group>
每当公交车进入或离开场景时,Vue 会自动触发 FLIP 动画(参见“为过渡效果添加自定义过渡类”示例)。
为了明确概念,假设我们有公交车[1, 2, 3],公交车 1 离开场景。接下来发生的是,在动画实际开始之前,将记住第一辆公交车的<span>元素的属性。因此,我们可以检索到描述属性的以下对象:
{
bottom:110.4375
height:26
left:11
right:27
top:84.4375
width:16
}
Vue 对<transition-group>标签内的所有键入元素都执行此操作。
在此之后,station-leave-active类将应用于第一辆公交车。让我们简要回顾一下规则是什么:
.station-leave-active, .station-enter-active {
transition: all 2s;
position: absolute;
}
我们注意到位置变为绝对定位。这意味着元素从页面的正常流程中移除。这反过来意味着所有在它后面的公交车将突然移动以填补留下的空白空间。Vue 还记录了此阶段所有公交车的属性,这被认为是动画的最终帧。这个帧实际上不是一个真正的显示帧;它只是用作计算元素最终位置的抽象:
Vue 将计算最终帧和起始帧之间的差异,并应用样式使公交车在初始帧中显示,即使它们实际上并不在那里。这些样式将在一帧后被移除。公交车缓慢爬行到它们的最终帧位置而不是立即移动到它们的新位置的原因是它们是span元素,并且我们指定了任何转换样式(Vue 用于伪造它们的位置一帧)必须过渡两秒钟:
.station-move {
transition: 2s;
}
换句话说,在帧-1 时,三辆公交车都在原位,并记录了它们的位置。
在帧 0 中,第一辆公交车从页面流程中移除,其他公交车立即移动到它后面。在同一帧中,Vue 记录它们的新位置并应用一个转换,将公交车移回到它们在帧-1 中的位置,从而看起来没有人移动。
在帧 1 中,转换被移除,但由于我们有一个过渡效果,公交车将缓慢移动到它们的最终位置。
动画化组件的状态
在计算机中,一切都是数字。在 Vue 中,一切都是数字的东西都可以以某种方式进行动画。在这个示例中,您将控制一个弹跳球,它将通过缓动动画平滑地定位自己。
准备工作
要完成这个示例,您至少需要对 JavaScript 有一些了解。JavaScript 的技术细节超出了本书的范围,但我将在“它是如何工作的...”部分为您解释代码,所以不要太担心。
操作步骤
在我们的 HTML 中,我们只会添加两个元素:一个输入框,我们将在其中输入弹跳球的期望位置,以及球本身:
<div id="app">
<input type="number">
<div class="ball"></div>
</div>
为了正确渲染球,编写以下 CSS 规则,它将显示在屏幕上:
.ball {
width: 3em;
height: 3em;
background-color: red;
border-radius: 50%;
position: absolute;
left: 10em;
}
我们想要控制条的 Y 位置。为此,我们将绑定球的top属性。
<div id="app">
<input type="number">
<div class="ball" :style="'top: ' + height + 'em'"></div>
</div>
高度将成为我们 Vue 实例模型的一部分:
new Vue({
el: '#app',
data: {
height: 0
}
})
现在,由于我们希望每当enteredHeight发生变化时,球都能以新位置进行动画,一个想法是绑定输入元素的@change事件:
<div id="app">
<input type="number" @input="move">
<div class="ball" :style="'top: ' + height + 'em'"></div>
</div>
移动方法将负责将球的当前高度缓慢过渡到指定值。
在执行此操作之前,您将添加Tween.js库作为依赖项。官方存储库位于github.com/tweenjs/tween.js。如果您使用 JSFiddle,可以添加 README.md 页面中指定的 CDN 链接。
在添加库之后添加移动方法,如下所示:
methods: {
move (event) {
const newHeight = Number(event.target.value)
const _this = this
const animate = (time) => {
requestAnimationFrame(animate)
TWEEN.update(time)
}
new TWEEN.Tween({ H: this.height })
.easing(TWEEN.Easing.Bounce.Out)
.to({ H: newHeight }, 1000)
.onUpdate(function () {
_this.height = this.H
})
.start()
animate()
}
}
尝试启动应用程序并在编辑其高度时看到球弹跳:
当我们改变高度时,球的位置也会改变:
工作原理...
这里的一般原则是,您有一个元素或组件的状态。当状态是数字性质时,您可以根据特定的曲线或加速度从一个值“tween”(从中间)到另一个值。
让我们来分解代码,好吗?
首先,我们要做的是将指定的新高度保存到newHeight变量中:
const newHeight = Number(event.target.value)
在下一行中,我们还将 Vue 实例保存在_this助手变量中:
const _this = this
我们这样做的原因一分钟后就会清楚:
const animate = (time) => {
requestAnimationFrame(animate)
TWEEN.update(time)
}
在上述代码中,我们将所有动画包装在一个函数中。这是 Tween.js 库的惯用方式,并标识我们将用于动画的主循环。如果我们有其他 tween,这是触发它们的地方:
new TWEEN.Tween({ H: this.height })
.easing(TWEEN.Easing.Bounce.Out)
.to({ H: newHeight }, 1000)
.onUpdate(function () {
_this.height = this.H
})
.start()
这是对我们库的 API 调用。首先,我们创建一个对象,该对象将保存高度值的副本,而不是我们组件的实际值。通常,在这里放置表示状态本身的对象。由于 Vue 的限制(或 Tween.js 的限制),我们使用了一种不同的策略;我们正在动画化状态的副本,并在每一帧中同步真实状态:
Tween({ H: this.height })
第一行将此副本初始化为球的当前实际高度:
easing(TWEEN.Easing.Bounce.Out)
我们选择了类似弹跳球的缓动效果:
.to({ H: newHeight }, 1000)
此行设置目标高度和动画持续时间(以毫秒为单位):
onUpdate(function () {
_this.height = this.H
})
在这里,我们将动画的高度复制回真实的元素。由于这个函数将 this 绑定到复制的状态,我们被迫使用 ES5 语法来访问它。这就是为什么我们有一个变量来引用 Vue 实例的原因。如果我们使用 ES6 语法,我们将无法直接获取H的值。
将可重用的过渡打包到组件中
我们的网站上可能有一个我们想要在用户流程中重复使用的签名过渡。如果您想要保持代码的组织性,将过渡打包到组件中可能是一个不错的策略。在这个示例中,您将构建一个简单的过渡组件。
准备工作
如果您已经通过 Vue 的过渡工作了一遍,那么按照这个示例是有意义的。此外,由于我们正在使用组件,您至少应该对它们有一个概念。浏览一下下一章,了解一下组件的基本知识。特别是,我们将创建一个功能组件,其解剖学在创建一个功能组件的示例中有详细介绍。
如何做...
我们将为新闻门户网站构建一个签名过渡。实际上,我们将使用一个预制的过渡效果,它在优秀的 magic 库(github.com/miniMAC/magic)中,所以您应该将其作为依赖项添加到您的项目中。您可以在cdnjs.com/libraries/magic找到 CDN 链接(转到该页面查找链接,不要将其复制为链接)。
首先,您将构建网站页面,然后构建过渡本身。最后,您只需将过渡添加到不同的元素中。
构建基本网页
我们的网页将由两个按钮组成,每个按钮都会显示一个卡片:一个是一个食谱,另一个是最新的突发新闻:
<div id="app">
<button @click="showRecipe = !showRecipe">
Recipe
</button>
<button @click="showNews= !showNews">
Breaking News
</button>
<article v-if="showRecipe" class="card">
<h3>
Apple Pie Recipe
</h3>
<p>
Ingredients: apple pie. Procedure: serve hot.
</p>
</article>
<article v-if="showNews" class="card">
<h3>
Breaking news
</h3>
<p>
Donald Duck is the new president of the USA.
</p>
</article>
</div>
这些卡片将因为以下 CSS 规则而具有独特的风格:
.card {
position: relative;
background-color: FloralWhite;
width: 9em;
height: 9em;
margin: 0.5em;
padding: 0.5em;
font-family: sans-serif;
box-shadow: 0px 0px 10px 2px rgba(0,0,0,0.3);
}
JavaScript 部分将是一个非常简单的 Vue 实例:
new Vue({
el: '#app',
data: {
showRecipe: false,
showNews: false
}
})
运行这段代码将显示您的网页:
构建可重用的过渡
我们决定在显示卡片时,在我们的网站上使用一个过渡效果。由于我们打算在网站的所有内容中重复使用这个动画,最好将它打包到一个组件中。
在 Vue 实例之前,我们声明以下组件:
Vue.component('puff', {
functional: true,
render: function (createElement, context) {
var data = {
props: {
'enter-active-class': 'magictime puffIn',
'leave-active-class': 'magictime puffOut'
}
}
return createElement('transition', data, context.children)
}
})
puffIn和puffOut动画在magic.css中定义。
在我们页面的元素中使用我们的过渡
现在,我们只需编辑我们的网页,将<puff>组件添加到我们的卡片中:
<div id="app">
<button @click="showRecipe = !showRecipe">
Recipe
</button>
<button @click="showNews = !showNews">
Breaking News
</button>
<puff>
<article v-if="showRecipe" class="card">
<h3>
Apple Pie Recipe
</h3>
<p>
Ingredients: apple pie. Procedure: serve hot.
</p>
</article>
</puff>
<puff>
<article v-if="showNews" class="card">
<h3>
Breaking news
</h3>
<p>
Donald Duck is the new president of the USA.
</p>
</article>
</puff>
</div>
当按下带有“puff”效果的按钮时,卡片将出现和消失。
工作原理...
我们代码中唯一棘手的部分是构建<puff>组件。一旦我们完成了这一步,无论我们放入其中的内容都将根据我们的过渡效果出现和消失。在我们的示例中,我们使用了一个已经制作好的过渡效果。在现实世界中,我们可能会创建一个非常复杂的动画,每次以相同的方式应用可能会很困难。将其封装在组件中更容易维护。
有两个因素使<puff>组件作为可重用的过渡效果工作:
props: {
'enter-active-class': 'magictime puffIn',
'leave-active-class': 'magictime puffOut'
}
在这里,我们指定了组件在进入和离开时必须采用的类;这里没有什么特别的,我们已经在“与第三方 CSS 动画库集成,如 animate.css”一节中做过了。
最后,我们返回实际的元素:
return createElement('transition', data, context.children)
这一行创建了我们元素的根,即一个只有一个子元素<transition>标签--context.children。这意味着子元素未指定;组件将把实际传递给模板的子元素作为子元素。在我们的示例中,我们传递了一些卡片,它们很快就被显示出来了。
动态过渡效果
在 Vue 中,响应性是一个常见的主题,因此过渡效果可以是动态的。不仅过渡效果本身,而且它们的所有属性都可以绑定到响应式变量上。这使我们能够在任何给定的时刻控制使用哪种过渡效果。
准备工作
本示例是在“元素之间进行过渡”一节的基础上构建的。如果您已经了解过渡效果,就不需要回去了,但如果您觉得有所遗漏,最好先完成那一节。
操作步骤...
我们将用一些吻将青蛙变成公主,但如果我们吻得太多,公主将变成圣诞老人。当然,我们说的是表情符号。
我们的 HTML 设置非常简单:
<div id="app">
<button @click="kisses++">
Kiss!</button>
<transition :name="kindOfTransformation" :mode="transformationMode">
<p :key="transformation">{{emoji}}{{transformation}}</p>
</transition>
</div>
只需注意这里的大多数属性都绑定到变量上。以下是 JavaScript 的实现方式。
首先,我们将创建一个带有所有数据的简单 Vue 实例:
new Vue({
el: '#app',
data: {
kisses: 0,
kindOfTransformation: 'fade',
transformationMode: 'in-out'
}
})
我们所指的淡入淡出效果是以下 CSS:
.fade-enter-active, .fade-leave-active {
transition: opacity .5s
}
.fade-enter, .fade-leave-active {
opacity: 0
}
变量 transformation 和 emoji 由两个计算属性定义:
computed: {
transformation () {
if (this.kisses < 3) {
return 'frog'
}
if (this.kisses >= 3 && this.kisses <= 5) {
return 'princess'
}
if (this.kisses > 5) {
return 'santa'
}
},
emoji () {
switch (this.transformation) {
case 'frog': return '
'
case 'princess': return '
'
case 'santa': return '
'
}
}
}
虽然我们在青蛙和公主之间使用了淡入淡出过渡效果,但我们希望在公主和青蛙之间使用其他过渡效果。我们将使用以下过渡效果类:
.zoom-leave-active, .zoom-enter-active {
transition: transform .5s;
}
.zoom-leave-active, .zoom-enter {
transform: scale(0)
}
现在,由于我们将过渡的名称绑定到一个变量上,我们可以通过编程方式轻松地切换它。我们可以通过将以下突出显示的行添加到计算属性中来实现这一点:
transformation () {
if (this.kisses < 3) {
return 'frog'
}
if (this.kisses >= 3 && this.kisses <= 5) {
this.transformationMode = 'out-in'
return 'princess'
}
if (this.kisses > 5) {
this.kindOfTransformation = 'zoom'
return 'santa'
}
}
第一行是为了避免在缩放过渡开始时出现重叠(有关详细信息,请参阅“在过渡中让元素在进入阶段之前离开”配方)。
第二行是将动画切换到“zoom”。
为了使一切都呈现正确的方式,我们还需要一个 CSS 规则:
p {
margin: 0;
position: absolute;
font-size: 3em;
}
这样会好多了。
现在运行应用程序,看看两种不同的过渡是如何动态使用的:
随着亲吻的数量增加,公主会缩小:
通过这个,圣诞老人会放大:
工作原理...
如果你了解 Vue 中的响应性是如何工作的,就没有什么需要补充的了。我们将过渡的名称绑定到kindOfTransformation变量上,并在代码中从淡入切换到缩放。我们还演示了可以动态更改<transition>标签的其他属性。
第四章:Vue 与互联网通信
本章将涵盖以下内容:
-
使用 Axios 发送基本的 AJAX 请求
-
在发送数据之前验证用户数据
-
创建表单并将数据发送到服务器
-
在请求过程中处理错误
-
创建 REST 客户端(和服务器!)
-
实现无限滚动
-
在发送请求之前处理请求
-
防止 XSS 攻击您的应用程序
介绍
Web 应用程序很少能够独立工作。使它们有趣的实际上是它们能够以前几年不存在的创新方式与世界进行通信。
Vue 本身并不包含任何机制或库来进行 AJAX 请求或打开 Web 套接字。因此,在本章中,我们将探讨 Vue 如何与内置机制和外部库交互以连接到外部服务。
您将首先使用外部库进行基本的 AJAX 请求。然后,您将探索一些在表单中发送和获取数据的常见模式。最后,有一些适用于实际应用程序的示例以及如何构建 RESTful 客户端的方法。
使用 Axios 发送基本的 AJAX 请求
Axios是 Vue 推荐的用于进行 HTTP 请求的库。它是一个非常简单的库,但它具有一些内置功能,可以帮助您执行常见操作。它实现了使用 HTTP 动词进行请求的 REST 模式,并且还可以在函数调用中处理并发(同时生成多个请求)。您可以在github.com/mzabriskie/axios上找到更多信息。
准备工作
对于这个示例,您不需要对 Vue 有任何特殊的了解。我们将使用 Axios,它本身使用JavaScript promises。如果您从未听说过 promises,您可以在developers.google.com/web/fundamentals/getting-started/primers/promises上了解一些基础知识。
操作步骤
您将构建一个简单的应用程序,每次访问网页时都会给您一条智慧的建议。
您首先需要在应用程序中安装 Axios。如果您使用 npm,只需执行以下命令:
npm install axios
如果您正在使用单页应用程序,可以从 CDN 导入以下文件,位于unpkg.com/axios/dist/axios.js。
很不幸,我们将使用的建议单服务无法与 JSFiddle 一起使用,因为该服务运行在 HTTP 上,而 JSFiddle 运行在 HTTPS 上,您的浏览器很可能会出现错误。您可以在本地 HTML 文件上运行此示例。
我们的 HTML 如下所示:
<div id="app">
<h2>Advice of the day</h2>
<p>{{advice}}</p>
</div>
我们的 Vue 实例如下所示:
new Vue({
el: '#app',
data: {
advice: 'loading...'
},
created () {
axios.get('http://api.adviceslip.com/advice')
.then(response => {
this.advice = response.data.slip.advice
})
.catch(error => {
this.advice = 'There was an error: ' + error.message
})
}
})
打开您的应用程序,获取一条令人耳目一新的建议:
工作原理...
当我们的应用程序启动时,将调用 created 钩子并运行带有 Axios 的代码。第一行执行一个 GET 请求到 API 端点:
axios.get('http://api.adviceslip.com/advice')
这将返回一个 promise。我们可以在任何 promise 上使用then方法来处理 promise 成功解析的结果:
.then(response => {
this.advice = response.data.slip.advice
})
响应对象将包含有关我们请求结果的一些数据。可能的响应对象如下所示:
{
"data": {
"slip": {
"advice": "Repeat people's name when you meet them.",
"slip_id": "132"
}
},
"status": 200,
"statusText": "OK",
"headers": {
"content-type": "text/html; charset=UTF-8",
"cache-control": "max-age=0, no-cache"
},
"config": {
"transformRequest": {},
"transformResponse": {},
"timeout": 0,
"xsrfCookieName": "XSRF-TOKEN",
"xsrfHeaderName": "X-XSRF-TOKEN",
"maxContentLength": -1,
"headers": {
"Accept": "application/json, text/plain, */*"
},
"method": "get",
"url": "http://api.adviceslip.com/advice"
},
"request": {}
}
我们导航到我们想要交互的属性;在我们的例子中,我们想要response.data.slip.advice,这是一个字符串。我们将字符串复制到实例状态中的变量 advice 中。
最后一部分是当我们的请求或第一个分支中的代码出现问题时:
.catch(error => {
this.advice = 'There was an error: ' + error.message
})
我们将在“恢复请求期间的错误”中更深入地探讨错误处理。现在,让我们手动触发一个错误,只是为了看看会发生什么。
触发错误的最便宜的方法是在 JSFiddle 上运行应用程序。由于浏览器检测到 JSFiddle 处于安全连接状态,而我们的 API 处于 HTTP 上(不安全),现代浏览器将会报错并阻止连接。您应该会看到以下文本:
There was an error: Network Error
这只是您可以尝试的许多可能错误之一。请注意,您可以将 GET 端点编辑为某个不存在的页面:
axios.get('http://api.adviceslip.com/non-existent-page')
在这种情况下,您将收到 404 错误:
There was an error: Request failed with status code 404
有趣的是,即使请求成功进行,但第一个分支中存在错误,您也将进入错误分支。
将then分支更改为以下内容:
.then(response => {
this.advice = undefined.hello
})
众所周知,JavaScript 无法读取未定义对象的“hello”属性:
There was an error: Cannot read property 'hello' of undefined
就像我告诉过你的那样。
在发送用户数据之前验证用户数据
一般来说,用户讨厌表单。虽然我们无法改变这一点,但我们可以通过提供有关如何填写表单的相关说明来减少用户的不便。在本示例中,我们将创建一个表单,并利用 HTML 标准为用户提供如何填写表单的良好指导。
准备工作
这个食谱不需要先前的知识就可以完成。虽然我们将构建一个表单(使用 Axios 发送基本的 AJAX 请求食谱),但我们将伪造 AJAX 调用并集中在验证上。
操作步骤如下:
我们将构建一个非常简单的表单:一个用于用户名的字段,一个用于用户电子邮件的字段,以及一个提交信息的按钮。
在 HTML 中输入以下内容:
<div id="app">
<form @submit.prevent="vueSubmit">
<div>
<label>Name</label>
<input type="text" required>
</div>
<div>
<label>Email</label>
<input type="email" required>
</div>
<div>
<label>Submit</label>
<button type="submit">Submit</button>
</div>
</form>
</div>
Vue 实例非常简单,如下所示:
new Vue({
el: '#app',
methods: {
vueSubmit() {
console.info('fake AJAX request')
}
}
})
运行此应用程序,并尝试使用空字段或错误的电子邮件提交表单。您应该会看到浏览器本身提供的帮助:
然后,如果您尝试输入无效的电子邮件地址,您将看到以下内容:
工作原理如下:
我们使用了原生的 HTML5 验证 API,该 API 在内部使用模式匹配来检查我们输入的内容是否符合某些规则。
考虑以下行中的 required 属性:
<input type="text" required>
这确保当我们提交表单时,字段实际上是填充的,而在其他输入元素中具有type="email"确保内容类似于电子邮件格式。
此 API 非常丰富,您可以在developer.mozilla.org/en-US/docs/Web/Guide/HTML/Forms/Data_form_validation上阅读更多信息。
很多时候,问题在于要利用此 API,我们需要触发本机验证机制。这意味着我们不允许阻止提交按钮的默认行为:
<button type="submit" @click.prevent="vueSubmit">Submit</button>
这不会触发本机验证,表单将始终被提交。另一方面,如果我们执行以下操作:
<button type="submit" @click="vueSubmit">Submit</button>
表单将得到验证,但由于我们没有阻止提交按钮的默认行为,表单将被发送到另一个页面,这将破坏单页应用程序的体验。
诀窍是在表单级别拦截提交:
<form @submit.prevent="vueSubmit">
这样,我们就可以拥有表单的本机验证和我们真正喜欢的现代浏览体验。
创建一个表单并将数据发送到服务器
HTML 表单是与用户交互的标准方式。您可以收集他们的数据以在网站中注册,让他们登录,甚至进行更高级的交互。在这个食谱中,您将使用 Vue 构建您的第一个表单。
准备工作
这个食谱非常简单,但它假设您已经了解 AJAX,并且希望将您的知识应用于 Vue。
操作步骤如下:
假设我们有一个博客,我们想要写一篇新文章。为此,我们需要一个表单。以下是您布局 HTML 的方式:
<div id="app">
<h3>Write a new post</h3>
<form>
<div>
<label>Title of your post:</label>
<input type="text" v-model="title">
</div>
<div>
<label>Write your thoughts for the day</label>
<textarea v-model="body"></textarea>
</div>
<div>
<button @click.prevent="submit">Submit</button>
</div>
</form>
</div>
我们有一个用于标题的框,一个用于新帖子正文的框,以及一个发送帖子的按钮。
在我们的 Vue 实例中,这三个东西以及用户 ID 将成为应用程序状态的一部分:
new Vue({
el: '#app',
data: {
userId: 1,
title: '',
body: ''
}
})
此时,我们只需要添加一个方法,当我们点击提交按钮时将数据发送到服务器。由于我们没有服务器,我们将使用一个非常有用的Typicode服务。它基本上是一个虚假的 REST 服务器。我们将发送一个请求,服务器将以逼真的方式响应,即使实际上什么都不会发生。
这是我们的方法:
methods: {
submit () {
const xhr = new XMLHttpRequest()
xhr.open('post', 'https://jsonplaceholder.typicode.com/posts')
xhr.setRequestHeader('Content-Type',
'application/json;charset=UTF-8')
xhr.onreadystatechange = () => {
const DONE = 4
const CREATED = 201
if (xhr.readyState === DONE) {
if (xhr.status === CREATED) {
this.response = xhr.response
} else {
this.response = 'Error: ' + xhr.status
}
}
}
xhr.send(JSON.stringify({
title: this.title,
body: this.body,
userId: this.userId
}))
}
}
为了查看服务器的实际响应,我们将将响应变量添加到我们的状态中:
data: {
userId: 1,
title: '',
body: '',
response: '...'
}
在我们的 HTML 表单之后,添加以下内容:
<h3>Response from the server</h3>
<pre>{{response}}</pre>
当您启动页面时,您应该能够与服务器进行交互。当您写一篇帖子时,服务器将回显该帖子并回答帖子 ID:
它是如何工作的...
大部分魔法发生在submit方法中。在第一行中,我们创建了一个XMLHttpRequest对象,这是一种用于进行 AJAX 请求的本机 JavaScript 机制:
const xhr = new XMLHttpRequest()
然后,我们使用open和setRequestHeader方法配置一个新的连接;我们想要发送一个 POST 请求,并且我们将随之发送一些 JSON:
xhr.open('post', 'http://jsonplaceholder.typicode.com/posts')
xhr.setRequestHeader('Content-Type', 'application/json;charset=UTF-8')
由于我们正在与 RESTful 接口交互,POST 方法意味着我们期望我们的请求修改服务器上的数据(特别是创建一个新的帖子),并且多次发出相同的请求将每次获得不同的结果(即我们将创建一个新的、不同的帖子 ID)。
这与更常见的 GET 请求不同,GET 请求不会修改服务器上的数据(除了日志之外),并且始终会产生相同的结果(前提是服务器上的数据在请求之间不会更改)。
有关 REST 的更多详细信息,请参阅*创建 REST 客户端(和服务器!)*配方。
以下行都与响应有关:
xhr.onreadystatechange = () => {
const DONE = 4
const CREATED = 201
if (xhr.readyState === DONE) {
if (xhr.status === CREATED) {
this.response = xhr.response
} else {
this.response = 'Error: ' + xhr.status
}
}
}
这将在我们的对象中安装一个处理程序,每当我们的对象发生某种变化时。如果readyState更改为DONE,这意味着我们从服务器获得了响应。接下来,我们检查状态码,它应该是201,以表示已创建新资源(我们的新帖子)。如果是这样,我们设置我们放在花括号中的变量以获得快速反馈。否则,我们将接收到的错误消息放入同一变量中。
在设置事件处理程序之后,我们需要做的最后一件事是实际发送请求以及我们的新帖子的数据:
xhr.send(JSON.stringify({
title: this.title,
body: this.body,
userId: this.userId
}))
还有更多...
另一种解决相同问题的方法是使用 Axios 发送 AJAX 请求。如果你需要了解 Axios 是什么,请查看“使用 Axios 发送基本的 AJAX 请求”这个教程。
submit方法的代码将变为以下内容(记得将 Axios 添加为依赖项):
submit () {
axios.post('http://jsonplaceholder.typicode.com/posts', {
title: this.title,
body: this.body,
userId: this.userId
}).then(response => {
this.response = JSON.stringify(response,null,' ')
}).catch(error => {
this.response = 'Error: ' + error.response.status
})
}
这段代码与使用原生浏览器对象完全等效,但比原生浏览器对象更具表达力和简洁性。
在请求过程中处理错误
从计算机的角度来看,对外部服务的请求需要很长时间。从人类的角度来看,就像是将卫星发送到木星并等待其返回地球。你无法百分之百确定旅行是否会完成,以及旅行实际需要多长时间。网络经常不稳定,最好做好准备,以防我们的请求无法成功完成。
准备工作
这个教程有点复杂,但不涉及高级概念。然而,你应该熟悉使用 Vue。
我们将在这个教程中使用 Axios。如果你不确定它具体是什么,请完成“使用 Axios 发送基本的 AJAX 请求”这个教程。
如何实现...
你将为在珠穆朗玛峰上订购披萨的网站构建一个网站。该地区的互联网连接非常差,因此在放弃订购披萨之前,我们可能希望重试几次。
这是我们的 HTML 代码:
<div id="app">
<h3>Everest pizza delivery</h3>
<button @click="order"
:disabled="inProgress">Order pizza!</button>
<span class="spinner" v-show="inProgress">
</span>
<h4>Pizza wanted</h4>
<p>{{requests}}</p>
<h4>Pizzas ordered</h4>
<span v-for="pizza in responses">
{{pizza.id}}:{{pizza.req}}
</span>
</div>
我们有一个按钮用于下订单,在订单进行中时将被禁用 - 一个进行中的订单列表(目前只包含一个订单)和一个已经订购的披萨列表。
我们可以添加一个旋转的小披萨来使等待更加愉快。添加以下 CSS 代码使小披萨旋转:
@keyframes spin {
100% {transform:rotate(360deg);}
}
.spinner {
width: 1em;
height: 1em;
padding-bottom: 12px;
display: inline-block;
animation: spin 2s linear infinite;
}
我们的 Vue 实例将跟踪一些事物;编写以下代码来开始构建实例:
new Vue({
el: '#app',
data: {
inProgress: false,
requests: new Object(null),
responses: new Object(null),
counter: 0,
impatientAxios: undefined
}
})
我想使用 JavaScript 的 set 来处理请求和响应;不幸的是,在 Vue 中,set 不是响应式的;我们可以使用最接近的对象,目前为空对象,即我们将请求和响应初始化为空对象。
impatientAxios变量将在创建时填充。通常,Axios 会等待浏览器等待响应的时间。由于我们不耐烦,我们将创建一个 Axios,在 3 秒后断开连接:
created () {
this.impatientAxios = axios.create({
timeout: 3000
})
}
我们需要构建的最后一件事是 order 方法。由于我们没有一个 Web 服务器来进行实际的请求,我们将使用http://httpstat.us/200端点,该端点对我们的所有请求都简单地回答 200 OK。
methods: {
order (event, oldRequest) {
let request = undefined
if (oldRequest) {
request = oldRequest
} else {
request = { req: '
', id: this.counter++}
}
this.inProgress = true
this.requests[request.id] = request
this.impatientAxios.get('http://httpstat.us/200')
.then(response => {
this.inProgress = false
this.responses[request.id] = this.requests[request.id]
delete this.requests[request.id]
})
.catch(e => {
this.inProgress = false
console.error(e.message)
console.error(this.requests.s)
setTimeout(this.order(event, request), 1000)
})
}
为了按照预期运行此程序,请在 Chrome 中打开它,并使用Cmd + Opt + I(在 Windows 上为F12)打开开发者工具:
切换到 Network 选项卡,打开下拉菜单,您会看到 No Throttling:
点击它以显示下拉菜单:
添加一个名为Everest的新自定义限速,下载和上传速度为1kb/s,延迟为1,000毫秒,如下图所示:
然后,您可以选择该类型的限速并尝试订购一些比萨。如果幸运的话,由于 Axios 的持久性,您最终应该能够订购一些比萨。
如果您没有成功或者所有的比萨都被正确订购,请尝试调整参数;这个过程的很大一部分实际上是随机的,并且高度依赖于机器。
工作原理...
处理不稳定连接的方法有很多,有许多库与 Axios 集成,并具有更高级的重试和重新尝试策略。在这里,我们只看到了一种基本策略,但是像Patience JS这样的库有更高级的策略,并且它们并不难使用。
创建一个 REST 客户端(和服务器!)
在这个示例中,我们将学习有关 REST 以及如何构建 REST 客户端。要构建一个 REST 客户端,我们需要一个公开 REST 接口的服务器;我们也将构建它。等一下!在一本关于 Vue 的书的示例中,整个 REST 服务器只是一个附注?跟着做,您不会失望的。
准备工作
从某种意义上说,这个示例相当高级,因为您需要熟悉客户端和服务器的架构,并且至少听说过或阅读过 REST 接口。您还需要熟悉命令行并安装 npm。您可以在选择开发环境示例中了解更多信息。
还需要安装 Axios;在本章的第一个示例中可以了解更多信息。
如何操作...
我记得几年前,构建一个 REST 服务器可能需要几天甚至几周的时间。您可以使用Feather.js,它将快速且(希望是)无痛。打开命令行并使用以下命令通过 npm 安装它:
npm install -g feathers-cli
安装完成后,创建一个目录,在其中运行服务器,进入该目录,并启动 Feathers:
mkdir my-server
cd my-server
feathers generate app
回答所有问题时使用默认值。当进程完成时,输入以下命令创建一个新的资源:
feathers generate service
其中一个问题是资源的名称;将其称为messages,但除此之外,其他问题都使用默认值。
使用exit命令退出 feathers-cli,并使用以下命令启动新的服务器:
npm start
几秒钟后,您的 REST 服务器应该已经启动,并且应该在端口3030上监听。你能诚实地说这很困难吗?
上述命令序列适用于 Feathers 版本 2.0.0。
您可能正在使用其他版本,但使用较新版本仍然可以轻松获得相同的结果;请查看在线安装指南feathersjs.com/。
接下来,您将构建一个与服务器无缝通信的 Vue 应用程序。现在,由于服务器通过 HTTP 在本地环境中运行,您将无法使用 JSFiddle,因为它只支持 HTTPS,并且认为 HTTP 是不安全的。您可以使用之前描述的其他方法,或者使用 HTTP 上的服务,例如codepen.io或其他服务。
您将编写一个管理粘性消息的应用程序。我们希望能够查看、添加、编辑和删除它们。
在 HTML 中键入以下内容:
<div id="app">
<h3>Sticky messages</h3>
<ol>
<li v-for="message in messages">
<button @click="deleteItem(message._id)">Delete</button>
<button @click="edit(message._id, message.text)">
edit
</button>
<input v-model="message.text">
</li>
</ol>
<input v-model="toAdd">
<button @click="add">add</button>
</div>
我们的 Vue 实例状态将包含一个记录消息的列表,以及要添加到列表中的临时消息:
new Vue({
el: '#app',
data: {
messages: [],
toAdd: ''
},
})
我们想要做的第一件事是向服务器请求消息列表。编写用于此的 created 钩子:
created () {
axios.get('http://localhost:3030/messages/')
.then(response => {
this.messages = response.data.data
})
},
为了创建新消息,编写一个方法,该方法绑定到添加按钮的点击事件,并将输入框中的内容发送到服务器:
methods: {
add () {
axios.post('http://localhost:3030/messages/', {
text: this.toAdd
})
.then(response => {
if (response.status === 201) {
this.messages.push(response.data)
this.toAdd = ''
}
})
}
}
类似地,编写一个用于删除消息和编辑消息的方法:
deleteItem (id) {
console.log('delete')
axios.delete('http://localhost:3030/messages/' + id)
.then(response => {
if (response.status < 400) {
this.messages.splice(
this.messages.findIndex(e => e.id === id), 1)
}
})
},
edit (id, text) {
axios.put('http://localhost:3030/messages/' + id, {
text
})
.then(response => {
if (response.status < 400) {
console.info(response.status)
}
})
}
启动应用程序,您将能够管理您的粘性消息板:
为了向自己证明您确实与服务器通信,您可以刷新页面或关闭并重新打开浏览器,您的笔记仍将存在。
工作原理...
REST表示REpresentational State Transfer,意思是您将传输某个资源状态的表示。在实践中,我们使用一组动词来传输我们消息状态的表示。
使用 HTTP 协议,我们可以使用以下动词:
| 动词 | 属性 | 描述 |
|---|---|---|
GET | 幂等,安全 | 用于检索资源的表示 |
POST | 用于上传新资源 | |
PUT | 幂等 | 用于上传现有资源(修改它) |
DELETE | 幂等 | 用于删除资源 |
幂等意味着如果我们使用相同的动词两次,资源不会发生任何变化,而安全则意味着根本不会发生任何变化。
在我们的应用程序中,我们只在创建过程中使用 GET 动词。当我们看到列表因其他操作而改变时,这只是因为我们在前端上镜像了服务器上的操作。
POST 动词用于向列表中添加新消息。请注意,即使在粘性消息中使用相同的文本,它也不是幂等的,因为当按下添加按钮时,我们仍然会创建一个与 ID 不同的新消息。
按下编辑按钮会触发 PUT,而删除按钮,嗯,你可以想象它使用 DELETE 动词。
Axios 通过使用动词本身命名其 API 的方法来使这一点非常清晰。
实现无限滚动
无限滚动是使用 Vue 和 AJAX 可以实现的一个很好的例子。它也非常流行,并且可以改善某些类型内容的交互。您将构建一个与无限滚动一起工作的随机单词生成器。
准备工作
我们将使用 Axios。查看“使用 Axios 发送基本 AJAX 请求”这个示例,了解如何安装它以及它的基本功能。除此之外,您不需要了解太多内容就可以跟随进行。
如何实现...
为了使我们的应用程序工作,我们将从www.setgetgo.com/randomword/get.php端点请求随机单词。每次将浏览器指向此地址时,您都会得到一个随机单词。
整个页面将仅由一个无限列表组成。编写以下 HTML:
<div id="app">
<p v-for="word in words">{{word}}</p>
</div>
随着我们向下滚动,单词列表需要增长。因此我们需要两样东西:了解用户何时到达页面底部,以及获取新单词。
为了知道用户何时到达页面底部,我们在 Vue 实例中添加一个方法:
new Vue({
el: '#app',
methods: {
bottomVisible () {
const visibleHeight = document.documentElement.clientHeight
const pageHeight = document.documentElement.scrollHeight
const scrolled = window.scrollY
const reachedBottom = visibleHeight + scrolled >= pageHeight
return reachedBottom || pageHeight < visibleHeight
}
}
})
如果页面滚动到底部或页面本身小于浏览器,则返回true。
接下来,我们需要添加一个机制,将此函数的结果绑定到状态变量bottom并在用户滚动页面时更新它。我们可以在created钩子中实现这一点:
created () {
window.addEventListener('scroll', () => {
this.bottom = this.bottomVisible()
})
}
状态将由bottom变量和随机单词列表组成:
data: {
bottom: false,
words: []
}
现在我们需要一个方法来将单词添加到数组中。将以下方法添加到现有方法中:
addWord () {
axios.get('http://www.setgetgo.com/randomword/get.php')
.then(response => {
this.words.push(response.data)
if (this.bottomVisible()) {
this.addWord()
}
})
}
该方法将递归调用自身,直到页面有足够的单词填满整个浏览器视图。
由于这种方法需要在到达底部时调用,我们将观察底部变量,并在其为true时触发该方法。在 Vue 实例的data之后添加以下选项:
watch: {
bottom (bottom) {
if (bottom) {
this.addWord()
}
}
}
我们还需要在created钩子中调用addWord方法来启动页面:
created () {
window.addEventListener('scroll', () => {
this.bottom = this.bottomVisible()
})
this.addWord()
}
如果现在启动页面,您将获得一个无限流的随机单词,这在您需要创建新密码时非常有用!
工作原理...
在这个示例中,我们使用了一个名为watch的选项,它使用以下语法:
watch: {
'name of sate variable' (newValue, oldValue) {
...
}
}
这是计算属性的对应物,当我们对一些响应式变量的更改后不感兴趣时使用。实际上,我们只是用它来触发另一个方法。如果我们对一些计算结果感兴趣,我们将使用计算属性。
在发送请求之前处理请求
本示例将教您如何使用拦截器在请求发送到互联网之前编辑请求。在某些情况下,这可能非常有用,例如当您需要在所有请求到服务器的请求中提供授权令牌时,或者当您需要一个单一点来编辑 API 调用的执行方式时。
准备工作
本示例使用了 Axios(使用 Axios 发送基本 AJAX 请求示例);除此之外,完成在发送用户数据之前验证用户数据的方法示例将非常有用,因为我们将构建一个小型表单进行演示。
操作步骤...
在本示例中,您将为一个假设的评论系统构建一个脏话过滤器。假设我们的网站上有一篇文章可能引发争论:
<div id="app">
<h3>Who's better: Socrates or Plato?</h3>
<p>Technically, without Plato we wouldn't have<br>
much to go on when it comes to information about<br>
Socrates. Plato ftw!</p>
在那篇文章之后,我们放置了一个评论框:
<form>
<label>Write your comment:</label>
<textarea v-model="message"></textarea>
<button @click.prevent="submit">Send!</button>
</form>
<p>Server got: {{response}}</p>
</div>
我们还在表单之后添加了一行用于调试从服务器获取的响应。
在我们的 Vue 实例中,我们编写了所有支持代码将评论发送到我们的服务器,这里的服务器将是jsonplaceholder.typicode.com/comments,一个行为类似真实服务器的虚拟 REST 接口。
这是在按下提交按钮时触发的提交方法:
methods: {
submit () {
axios.post('http://jsonplaceholder.typicode.com/comments',
{
body: this.message
}).then(response => {
this.response = response.data
})
}
}
Vue 实例的状态只有两个变量:
data: {
message: '',
response: '...'
}
像往常一样,我们希望将其挂载到<div>应用程序中:
new Vue({
el: '#app',
...
一旦实例被挂载,我们希望在 Axios 中安装单词过滤器;为此,我们利用 Vue 的mounted钩子:
mounted () {
axios.interceptors.request.use(config => {
const body = config.data.body.replace(/punk/i, '***')
config.data.body = body
return config
})
}
现在我们可以启动应用程序并尝试编写我们的脏话评论:
工作原理...
在mounted钩子中,我们正在安装一个所谓的拦截器。特别是,它是一个请求拦截器,这意味着它会在将请求发送到互联网之前对其进行操作:
axios.interceptors.request.use(config => {
const body = config.data.body.replace(/punk/i, '***')
config.data.body = body
return config
})
config对象包含许多我们可以编辑的内容。它包含头部和 URL 参数。它还包含 Axios 配置变量。您可以查看 Axios 文档以获取最新列表。
我们正在获取与 POST 请求一起发送的数据部分,并检查是否找到了punk这个词。如果是这样,它将被星号替换。返回的对象将成为当前请求的新配置。
防止 XSS 攻击您的应用程序
编写没有考虑安全性的应用程序将不可避免地导致漏洞,特别是如果它必须在 Web 服务器上运行。跨站脚本攻击(XSS)是当今最流行的安全问题之一;即使您不是安全专家,也应该了解它的工作原理以及如何在 Vue 应用程序中防止它。
准备工作
除了 Axios 之外,这个示例不需要任何先前的知识。您可以在使用 Axios 发送基本 AJAX 请求的示例中找到有关 Axios 以及如何安装它的更多信息。
操作步骤...
您应该首先了解后端如何提供 CSRF 令牌(在下一段中会详细介绍)。我们假设服务器会在您的浏览器中放置一个名为 XSRF-TOKEN 的 cookie。
您可以模拟您的服务器,在浏览器控制台(开发者工具)中使用document.cookie = 'XSRF-TOKEN=abc123'命令设置一个 cookie。
Axios 会自动读取这样的 cookie,并在下一次请求中传输它。
考虑到我们在代码中调用了一个 Axios 的get请求,如下所示:
methods: {
sendAllMoney () {
axios.get('/sendTo/'+this.accountNo)
}
}
Axios 将获取该 cookie 并添加一个名为 X-XSRF-TOKEN 的新头部到请求中。您可以通过在 Chrome 的开发者工具中点击请求的名称,在网络选项卡中查看这样的头部:
工作原理...
为了防止 XSS 攻击,您必须确保没有用户输入可以出现在您的应用程序中作为代码。这意味着您必须非常小心地使用v-html属性(输出原始 HTML的示例)。
不幸的是,您无法控制页面外发生的事情。如果您的用户收到一封包含与您的应用程序中的操作相对应的链接的虚假电子邮件,点击电子邮件中的链接将触发该操作。
让我们举一个具体的例子;你开发了一个银行应用程序VueBank,你的应用程序的用户收到了以下虚假电子邮件:
Hello user!
Click here to read the latest news.
正如你所看到的,这封邮件甚至与我们的应用程序无关,here超链接隐藏在邮件本身的 HTML 中。实际上,它指向http://vuebank.com?give_all_my_money_to_account=754839534地址。
如果我们已经登录了 VueBank,该链接可能会立即生效。这对我们的财务状况不利。
为了防止这类攻击,我们应该让后端为我们生成一个CSRF(跨站请求伪造)令牌。我们将获取该令牌并将其与请求一起发送,以证明该请求来自用户。前面的链接将变为
http://vuebank.com?give_all_my_money_to_account=754839534&csrf=s83Rnj。
由于令牌每次都是随机生成的,邮件中的链接无法正确伪造,因为攻击者不知道服务器给网页的令牌。
在 Vue 中,我们使用 Axios 发送令牌。通常,我们不会将其作为链接的一部分发送,而是作为请求的头部;实际上,Axios 会为我们执行此操作,并自动将令牌放入下一个请求中。
您可以通过设置axios.defaults.xsrfCookieName变量来更改 Axios 将获取的 cookie 的名称,并且可以通过操作axios.defaults.xsrfHeaderName变量来编辑返回令牌的头部的名称。