动画指南 动画是幻灯片演示的重要组成部分。Slidev 提供了从简单到复杂的各种幻灯片动画制作方法。本指南将告诉你如何有效地使用它们。
点击动画 此处我们用 “点击” 一词来代表幻灯片中的一步动画。一张幻灯片可以有一个或多个点击,每个点击可以触发一个或多个动画 - 例如,显示或隐藏元素。可以通过按下 space 键或 → 键来触发一步点击动画。
NOTE
自 v0.48.0 版起,我们重写了点击动画系统,使其行为更加一致。在一些情况下,它可能会改变现有幻灯片的行为。本页展示的是新的点击系统,您可以在 #1279 中找到有关该重写的更多细节。
v-click 可以使用
md
md
md
md
md
- Item 1
- Item 2
- Item 3
每一步动画会依次显示列表中的元素。它还接受 depth prop 用于嵌套列表:
md
- Item 1
- Item 1.1
- Item 1.2
- Item 2
- Item 2.1
- Item 2.2
另外,你可以使用 every prop 来指定每次点击后显示的项目数:
md
- Item 1.1
- Item 1.2
- Item 2.1
- Item 2.2
动画时机 默认情况下,点击动画是依次触发的。你可以通过使用 at prop 或带有值的 v-click 指令来自定义的动画发生时机。
就像 CSS 布局系统一样,点击动画发生时机可以是 “相对的” (relative) 或 “绝对的” (absolute):
相对的时机 动画发生时机基于相对于前一个也是相对的时机的动画计算。若该动画是第一个相对时机的动画,则从 0 开始计算:
md
```js {none|1|2}{at:'+5'}
1 // 第 7 步时高亮
2 // 第 8 步时高亮
```NOTE
当没有给 v-click 传入参数时,将使用默认值 '+1',即动画发生在上一个动画的后一步。
事实上,v-after 只是带有 at="+0" 的 v-click 的简写:
md
at prop 的格式
只有以 '+' 或 '-' 开头的字符串值,如 '+1',才会被视为相对位置:
ValueKind'-1', '+1'相对时机+1 === 1绝对时机'1'绝对时机故不要忘记为相对值添加单引号。
绝对时机 传入的值就是触发动画所需的点击次数:
md
```js {none|1|2}{at:3}
1 // 3 步动画后高亮
2 // 4 步动画后高亮
```混合情况 你可以混合地使用绝对和相对时机:
md
md```js {1|2}{at:1}
1 + 1
'a' + 'b'
```
```js {1|2}{at:1}
= 2
= 'ab'
```显示后隐藏 你还可以通过传递一个数组来为 v-click 指令指定显示的时机和隐藏的时机:
md
在第 2 和 3 步时动画将隐藏。
这将在第 3 步动画后显示,之后在第 4 步动画后隐藏。
md
在第 1 步动画显示
在第 2,3,4 步动画显示
在第 5,6 步动画显示
更多细节请查阅 VSwitch 组件。
自定义步骤总数 默认地,Slidev 会自动计算在下一张幻灯片之前需要多少次动画。你可以通过 frontmatter 中的 clicks 选项来覆盖这个值:
yaml---
# 10 步动画后进入下一张幻灯片
clicks: 10
---过渡效果 当 v-click 指令应用于元素时,元素会拥有 slidev-vclick-target 类名。当元素被隐藏时,还会附加类名 slidev-vclick-hidden。例如:
html
点击一次后,它可能会变成:html
默认地,以下样式会应用于这些类:css.slidev-vclick-target {
transition: opacity 100ms ease;
}
.slidev-vclick-hidden {
opacity: 0;
pointer-events: none;
}你可以在自定义样式表中覆盖它们,以自定义过渡效果。例如,你可以通过以下方式实现缩放效果:
css/* styles.css */
.slidev-vclick-target {
transition: all 500ms ease;
}
.slidev-vclick-hidden {
transform: scale(0);
}若要针对某几张幻灯片或布局指定动画:
scss.slidev-page-7,
.slidev-layout.my-custom-layout {
.slidev-vclick-target {
transition: all 500ms ease;
}
.slidev-vclick-hidden {
transform: scale(0);
}
}参阅 自定义样式 以了解更多。
Motion 动画 Slidev 内置了 @vueuse/motion。你可以使用 v-motion 指令来赋予元素 Motion 动画:
html
v-motion
:initial="{ x: -80 }"
:enter="{ x: 0 }"
:leave="{ x: 80 }"
>
Slidev
在 v0.48.9 之前,你需要在幻灯片的 frontmatter 中添加 preload: false 来启用 motion。
基于点击动画的 Motion 自 v0.48.9 后可用
也可以通过点击动画来触发 Motion。例如:
html
v-motion
:initial="{ x: -80 }"
:enter="{ x: 0, y: 0 }"
:click-1="{ x: 0, y: 30 }"
:click-2="{ y: 60 }"
:click-2-4="{ x: 40 }"
:leave="{ y: 0, x: 80 }"
>
Slidev
html
:initial="{ x: -50 }"
:enter="{ x: 0 }"
:leave="{ x: 50 }"
>
在第 2 步动画后显示,在第 4 步动画后隐藏。
initial: 当 currentPage < thisPage 或 v-click 因为 $clicks 太小而隐藏了该元素。enter: 当 currentPage === thisPage 且 v-click 显示元素时。优先级:最低click-x: x 是一个表示 绝对 点击数的数字。如果 $clicks >= x,则变体将生效。优先级:xclick-x-y: 如果 x <= $clicks < y,则变体将生效。优先级:xleave: currentPage > thisPage,或 v-click 隐藏当前元素,因为 $clicks 太大。字段的值将根据上述定义的优先级进行合并。
WARNING
由于 Vue 内部的 bug,目前 只有 v-click 被作用于和 v-motion 相同的元素才能控制 Motion 动画。作为变通方案,你可以使用 v-if="3 < $clicks" 来实现类似的效果。
了解更多:Demo | @vueuse/motion | v-motion | Presets
Slide Transitions Slidev 内置了幻灯片过渡效果。你可以在 frontmatter 中设置 transition 来启用它:
md---
transition: slide-left
---这将提供一个幻灯片切换时的滑动效果。在 headmatter 中设置将应用于所有幻灯片。你也可以在 frontmatter 中为每张幻灯片设置不同的过渡效果。
内置的过渡效果 fade - 淡入淡出fade-out - 淡出再淡入slide-left - 向左滑动(向右滑动时后退)slide-right - 向右滑动(向左滑动时后退)slide-up - 向上滑动(向下滑动时后退)slide-down - 向下滑动(向上滑动时后退)view-transition - 使用 View Transitions API 过渡使用 View Transition API View Transitions API 提供了一种在不同 DOM 状态之间轻松创建动画过渡的机制。可以在 View Transitions API - MDN Web Docs 中了解更多。
WARNING
实验性:并非所有浏览器都支持。在使用前请查看 浏览器兼容性表。
可以使用 view-transition-name CSS 属性来命名 view transitions,它会在切换幻灯片时创建不同页面元素之间的连接,并实现平滑的过渡效果。
同时,你还可以启用 MDC (Markdown Component) 语法 来更加方便的方便地设置 view-transition-name:
md---
transition: view-transition
mdc: true
---
# View Transition {.inline-block.view-transition-title}
---
# View Transition {.inline-block.view-transition-title}自定义过渡效果 Slidev 的幻灯片过渡效果由 Vue Transition 提供。你可以通过以下方式提供自定义过渡效果:
md---
transition: my-transition
---并在你的自定义样式表中添加以下内容:
css.my-transition-enter-active,
.my-transition-leave-active {
transition: opacity 0.5s ease;
}
.my-transition-enter-from,
.my-transition-leave-to {
opacity: 0;
}参阅 Vue Transition 以了解更多。
前进后退过渡 你可以为前进和后退导航指定不同的过渡效果,使用 | 作为过渡名称的分隔符:
md---
transition: go-forward | go-backward
---在上例中,当你从幻灯片 1 切换到幻灯片 2 时,将应用 go-forward 过渡效果。当你从幻灯片 2 切换到幻灯片 1 时,将应用 go-backward 过渡效果。
高级过渡选项 transition 字段接受一个选项对象,该选项对象将传递给
md---
transition:
name: my-transition
enterFromClass: custom-enter-from
enterActiveClass: custom-enter-active
---