在主题中，图片默认支持点击后放大预览。通过查找 文档内容中的图片，形成图片预览列表。

该功能由 @vuepress/plugin-photo-swipe 插件提供支持。

配置

图片预览默认启用，也可以通过以下配置修改行为：

.vuepress/config.ts

export default defineUserConfig({
  theme: plumeTheme({
    plugins: {
      photoSwipe: {
        // 图片选择器
        selector: '.vp-doc :not(a) > img:not([no-view],.no-view,.ignore)',
        download: true, // 是否显示下载按钮
        fullscreen: true, // 是否显示全屏按钮
        scrollToClose: true, // 是否在滚动时关闭当前图片
      }
    }
  })
})

更多配置请参考 @vuepress/plugin-photo-swipe

忽略图片预览

可以通过 no-view 或 ignore 类名，或者 no-view 属性来忽略图片预览。

![](path/to/image){.no-view}
![](path/to/image){.ignore}
![](path/to/image){no-view}

<img src="path/to/image" class="no-view">
<img src="path/to/image" class="ignore">
<img src="path/to/image" no-view>

贡献者

pengzhanbo

更新日志

2025/10/7 15:13

查看所有更新日志

• 4d236-feat(theme)!: add collections support (#704)于 2025/10/7
• b8ce0-fix(theme): incorrect image preview selector于 2025/7/20
• 45907-feat(theme): add image-preview configuration (#637)于 2025/7/5