进阶 sli.dev 2026-11-21 18:58:32 · 1 阅读

第5章 Slidev 动画系统详解:v-click 指令与点击交互指南

动画 ​动画是幻灯片演示的重要组成部分。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 更多细节请参阅 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 类名。例如:html
Text
点击后,元素可能变为: ```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
---

评论 (0)