动画 动画是幻灯片演示的重要组成部分。Slidev 提供了多种动画实现方式,从简单到复杂应有尽有。本指南将教你如何有效使用它们。
点击动画 在幻灯片中,"点击"可以看作动画步骤的基本单位。一张幻灯片可以包含一次或多次点击,每次点击可以触发一个或多个动画,比如显示或隐藏元素。
注意
自 v0.48.0 起,我们重写了点击动画系统,行为更加一致。在某些边界情况下,这可能会改变你现有幻灯片的表现。本页面展示的是新的点击系统,关于这次重构的更多细节可参考 #1279。
v-click 要对元素应用显示/隐藏的"点击动画",可以使用
组件或 v-click 指令。
md
Hello World!
Hey!
v-after v-after 会让元素在上一个 v-click 触发时变为可见。
md Hello
World
按下"下一步"时,Hello 和 World 会同时显示。
点击后隐藏 给 v-click 或 v-after 指令添加 .hide 修饰符,可以让元素在点击后变为不可见,而不是显示出来。
md 1 次点击后显示
2 次点击后隐藏
2 次点击后隐藏
对于组件,你可以使用 `hide` 属性实现相同效果:md 点击 1 次后显示
点击 2 次后隐藏
点击 2 次后也隐藏
v-clicks
v-clicks 仅提供为组件形式。它是将 `v-click` 指令应用于所有子元素的简写方式。在处理列表和表格时尤为有用。md
- 项目 1
- 项目 2
- 项目 3
每次点击“下一页”按钮时,都会显示一个新项目。它接受一个 `depth` 属性用于嵌套列表:md
- 项目 1
- 项目 1.1
- 项目 1.2
- 项目 2
- 项目 2.1
- 项目 2.2
此外,你还可以使用 `every` 属性来指定每次点击后显示的项目数量:md
- 项目 1.1
- 项目 1.2
- 项目 2.1
- 项目 2.2
定位
默认情况下,点击动画是逐个触发的。你可以使用 `at` 属性或带有值的 `v-click` 指令来自定义元素的动画“位置”。
就像 CSS 布局系统一样,点击动画元素可以是“相对”或“绝对”定位:
相对定位
相对元素的实际位置是根据之前的相对元素计算得出的:md 点击 1 次后显示
点击 3 次后显示
点击 2 次后隐藏
```js {none|1|2}{at:'+5'}
1 // 点击 7 次后高亮
2 // 点击 8 次后高亮
```
注意:当你未指定时,`v-click` 的默认值为 '+1'。
实际上,`v-after` 只是带有 `at` 属性的 `v-click` 的简写:md
at 属性值的格式
只有以 '+' 或 '-' 开头的字符串值(如 '+1')才被视为相对位置:
值 | 类型
'-1', '+1' | 相对
+1 === 1 | 绝对
'1' | 绝对
所以别忘了相对值要加单引号。
绝对定位
给定的值是触发此动画的确切点击次数:md 点击 3 次后显示
点击 2 次后显示
点击 1 次后隐藏
```js {none|1|2}{at:3}
1 // 点击 3 次后高亮
2 // 点击 4 次后高亮
```
混合使用
你可以混合使用绝对定位和相对定位:md 点击 1 次后显示
点击 3 次后显示
点击 2 次后显示
点击 1 次后显示
点击 4 次后显示
下面的例子让两个代码块的高亮同步进行:md```js {1|2}{at:1}
1 + 1
'a' + 'b'
```
```js {1|2}{at:1}
= 2
= 'ab'
```进入与离开(Enter & Leave) 你可以通过给 v-click 指令传入数组来指定进入和退出的点击序号,其中结束序号不包含在内。md
在第 2 次和第 3 次点击时隐藏(其他时候显示)。
仅在第 2 次点击时显示(其他时候隐藏)。
也可以用 v-switch 实现同样的效果:md
第 1 次点击显示,第 2 次点击隐藏。
第 2 次点击显示,第 5 次点击隐藏。
第 5 次点击显示,第 7 次点击隐藏。
更多细节请参阅 VSwitch Component。
自定义总点击次数 默认情况下,Slidev 会自动计算进入下一张幻灯片前所需的点击次数。你可以通过 frontmatter 中的 clicks 选项来覆盖它:yaml---
# 这张幻灯片需要点击 10 次才能进入下一张
clicks: 10
---点击动画预设 你可以在 headmatter/frontmatter 中定义默认的点击动画预设:yaml---
clickAnimation: up
---也可以通过指令修饰符为单个元素指定:md使用 frontmatter 中定义的默认动画预设
显示时放大,隐藏时缩小
组合多个动画:fade 和 right
该元素不使用动画
内置了一些可以直接使用的预设:
fade:透明度从 0.5 渐入到 1
fade-in:透明度从 0 渐入到 1
up:向上平移 20px
down:向下平移 20px
left:向左平移 20px
right:向右平移 20px
scale:缩放至 0.9
none:该元素禁用动画
你也可以通过自定义 CSS 规则 .slidev-vclick-anim-{presetName} 来定义自己的预设:css.slidev-vclick-anim-pop.slidev-vclick-hidden {
transform: scale(0.96) translateY(8px);
}元素过渡 当你给元素应用 v-click 指令时,元素会自动获得 slidev-vclick-target 类名。元素被隐藏时,还会附加 slidev-vclick-hidden 类名。例如:htmlText
点击后,元素可能变为:
```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` 指令来应用动效。示例如下:
```html
Slidev
```
文本 “Slidev” 在进入幻灯片时将从 -80px 移动至原始位置。离开时,它将移动到 80px 处。
在 v0.48.9 之前,你需要在幻灯片的 frontmatter 中添加 `preload: false` 才能启用 motion 功能。
点击触发的 Motion
(自 v0.48.9 起可用)
你也可以通过点击触发动效:
```html
Slidev
```
或者将 `v-click` 与 `v-motion` 结合使用:
```html
在第 2 次点击时显示,在第 4 次点击时隐藏。
```
各变体的含义:
initial:当 currentPage < thisPage 时,或者因 $clicks 太小导致 v-click 隐藏当前元素时。enter:当 currentPage === thisPage 且 v-click 显示该元素时。优先级:最低。click-x:x 是一个数字,表示绝对点击次数。当 $clicks >= x 时该变体生效。优先级:x。click-x-y:当 x <= $clicks < y 时该变体生效。优先级:x。leave:currentPage > thisPage 时,或者因 $clicks 太大导致 v-click 隐藏当前元素时。
这些变体会按照上述定义的优先级进行组合。
WARNING
由于 Vue 的一个内部 bug,目前只有应用在与 v-motion 相同元素上的 v-click 才能控制运动动画。作为替代方案,你可以使用类似 v-if="3 < $clicks" 的写法来实现同样的效果。
了解更多:Demo | @vueuse/motion | v-motion | Presets
幻灯片切换动画
Slidev 开箱即支持幻灯片切换动画。只需设置 transition frontmatter 选项即可启用:
---
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 属性为视图过渡命名,从而在不同页面的元素之间建立关联,在切换幻灯片时实现平滑过渡。
你还可以启用 Comark 语法支持,以便更方便地为视图过渡命名:
---
transition: view-transition
comark: true
---
# View Transition {.inline-block.view-transition-title}
---
# View Transition {.inline-block.view-transition-title}
自定义切换效果
Slidev 的幻灯片切换效果基于 Vue Transition 实现。你可以按以下方式提供自定义切换效果:
---
transition: my-transition
---
然后在自定义样式表中编写:
.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。
前进与后退切换效果
你可以在切换效果名称中使用 | 作为分隔符,为前进和后退导航指定不同的切换效果:
---
transition: go-forward | go-backward
---
这样,从第 1 页前进到第 2 页时会应用 go-forward 切换效果,从第 2 页返回第 1 页时会应用 go-backward 切换效果。
高级用法
transition 字段还接受一个选项对象,它会被传递给 <TransitionGroup> 组件。例如:
---
transition:
name: my-transition
enterFromClass: custom-enter-from
enterActiveClass: custom-enter-active
---