进阶 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>

评论 (0)