进阶 sli.dev 2026-11-21 18:58:32 · 1 阅读
第12章 全局上下文
全局上下文
Slidev 注入了若干全局上下文,用于实现高级的导航控制。
直接使用
你可以在幻灯片或组件中直接访问它们:
slides.md```md
# Page 1
Current page is: {{ $nav.currentPage }}
```
Foo.vue```vue
组件。
$slidev.configs
$slidev.configs 是一个响应式对象,存储幻灯片项目的配置。例如:
md
---
title: My First Slidev!
---
# Page 1
---
# Any Page
{{ $slidev.configs.title }} // 'My First Slidev!'
$slidev.themeConfigs
$slidev.themeConfigs 是一个响应式对象,存储解析后的主题配置:
yaml
---
title: My First Slidev!
themeConfig:
primary: '#213435'
---
然后主题可以这样访问 primary 颜色:
md
{{ $slidev.themeConfigs.primary }} // '#213435'
类型
如果希望以编程方式获取类型,可以从 @slidev/types 导入类型,例如 TocItem:
vue
Title: {{ $slidev.configs.title }}
```
使用 Composable
自 v0.48.0 起可用
如果你想在代码中以编程方式获取上下文(同时获得类型安全),可以从 @slidev/client 导入 composable:
```vue
```
注意
过去你可能会见到从嵌套模块导入的写法,例如 import { isDark } from '@slidev/client/logic/dark.ts',但这不被推荐,因为它们属于内部实现细节,未来可能会变更。请尽量使用 @slidev/client 的公开 API。
警告
当某个文件中使用了 useSlideContext composable 时,$slidev 的自动注入会被禁用,你需要手动把 $slidev 对象传给 useSlideContext 函数。另见:✨ Slide Hooks
属性
$slidev
全局上下文对象。
$frontmatter
当前幻灯片的 frontmatter 对象。注意,对于幻灯片之外的组件(如 ✨ Global Layers),它为空。
$clicks
$clicks 表示当前幻灯片上的点击次数,可用于按条件在不同点击阶段显示不同内容:
```html
Content
```
参考 📖 动画指南以了解更多信息。
$nav 是一个响应式对象,用于存储幻灯片导航的相关属性与控制方法。示例如下:
js
$nav.next() // 进入下一步
$nav.nextSlide() // 进入下一张幻灯片(跳过点击步骤)
$nav.go(10) // 跳转到第 10 张幻灯片
$nav.currentPage // 当前幻灯片序号
$nav.currentLayout // 当前布局名称
$nav.currentFrontmatter // 当前幻灯片的 frontmatter,包含自定义字段
如需了解其他可用属性,请查阅 SlidevContextNav 接口。
$page
$page 存储当前页码,从 1 开始计数。
md
Page: {{ $page }}
判断当前页是否处于激活状态:{{ $page === $nav.currentPage }}
`$nav.clicks` 是全局状态,而 `$clicks` 是每张幻灯片本地的点击次数。
$renderContext
$renderContext 存储当前的渲染上下文,可能是 slide、overview、presenter 或 preview。
md
此内容仅在主幻灯片视图下渲染
你也可以使用