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

第12章 全局上下文

全局上下文 Slidev 注入了若干全局上下文,用于实现高级的导航控制。 直接使用 你可以在幻灯片或组件中直接访问它们: slides.md```md # Page 1 Current page is: {{ $nav.currentPage }} ``` Foo.vue```vue ``` 使用 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
此内容仅在主幻灯片视图下渲染
你也可以使用 组件。 $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

评论 (0)