进阶 sli.dev 2026-11-21 18:58:32 · 7 阅读
第17章 Slidev 内置布局详解
Layouts
本页列出 Slidev 提供的所有内置布局。这些布局可以通过幻灯片 frontmatter 中的 layout 选项来使用。
注意,📖 主题与插件可能提供额外的布局,或覆盖现有布局。要添加自定义布局,请参阅 📖 编写布局。
center
将内容显示在屏幕中央。
cover
用于显示演示文稿的封面页,可包含演示标题、背景说明等。
default
最基础的布局,用于显示任意类型的内容。
end
演示文稿的最后一页。
fact
用于在屏幕上非常醒目地展示某个事实或数据。
full
利用屏幕的全部空间来显示内容。
image-left
在屏幕左侧显示一张图片,内容放在右侧。
用法
yaml
---
layout: image-left
# 图片路径
image: /path/to/the/image
# 内容的自定义 class 名
class: my-cool-content-on-the-right
---image-right
在屏幕右侧显示一张图片,内容放在左侧。
用法
yaml
---
layout: image-right
# 图片路径
image: /path/to/the/image
# 内容的自定义 class 名
class: my-cool-content-on-the-left
---image
将一张图片作为页面主体内容显示。
用法
yaml
---
layout: image
# 图片路径
image: /path/to/the/image
---可以通过添加 backgroundSize 属性来修改默认的背景尺寸(cover):
yaml
---
layout: image
image: /path/to/the/image
backgroundSize: contain
---yaml
---
layout: image-left
image: /path/to/the/image
backgroundSize: 20em 70%
---iframe-left
在屏幕左侧显示一个网页,内容放在右侧。
用法
yaml
---
layout: iframe-left
# 网页地址
url: https://github.com/slidevjs/slidev
# 内容的自定义 class 名
class: my-cool-content-on-the-right
---iframe-right
在屏幕右侧显示一个网页,内容放在左侧。
用法
yaml
---
layout: iframe-right
# 网页地址
url: https://github.com/slidevjs/slidev
# 内容的自定义 class 名
class: my-cool-content-on-the-left
---iframe
将一个网页作为页面主体内容显示。
用法
yaml
---
layout: iframe
# 网页地址
url: https://github.com/slidevjs/slidev
---intro
用于介绍演示文稿,通常包含演示标题、简要说明、作者等。
none
不带任何预设样式的布局。
quote
用于醒目地展示一段引言。
section
用于标记演示文稿新章节的开始。
statement
将一段声明/陈述作为页面主要内容。
two-cols
将页面内容分成两栏。
用法
md
---
layout: two-cols
---
# 左栏
这部分显示在左侧
<slot name="right"/>
# 右栏
这部分显示在右侧md
---
layout: two-cols
---
# 左栏
这部分显示在左侧
::right::
# 右栏
这部分显示在右侧two-cols-header
将页面内容分为上下两行,第二行再分为左右两栏。
用法
md
---
layout: two-cols-header
---
这部分横跨两栏
::left::
# 左栏
这部分显示在左侧
::right::
# 右栏
这部分显示在右侧
<style>
.two-cols-header {
column-gap: 20px; /* 根据需要调整间距大小 */
}
</style>