Skip to content

自定义预览工具栏

从 v1.1.1 版本开始,VuePrintNext 支持自定义预览工具栏中显示的功能按钮,让用户可以根据需要控制预览界面的交互元素。

配置选项

通过 previewTools 选项,你可以控制预览工具栏中显示的功能按钮:

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  previewTools: {
    zoom: true,      // 是否显示缩放控制
    theme: true,     // 是否显示主题切换按钮
    fullscreen: true // 是否显示全屏切换按钮
  }
});

你也可以通过设置 previewTools: false 来一次性关闭所有工具按钮:

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  previewTools: false // 关闭所有工具按钮
});

可配置的工具按钮

选项类型默认值说明
zoombooleantrue控制是否显示缩放控制(缩小、放大、重置按钮)
themebooleantrue控制是否显示主题切换按钮(深色/浅色模式)
fullscreenbooleantrue控制是否显示全屏切换按钮(全屏/窗口模式)

使用场景

简化界面

如果你希望为用户提供一个简化的预览界面,可以隐藏部分或全部工具按钮。

方式一:单独设置各个工具按钮

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  previewTools: {
    zoom: false,
    theme: false,
    fullscreen: false
  }
});

方式二:一次性关闭所有工具按钮

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  previewTools: false
});

限制用户交互

在某些场景下,你可能希望限制用户对预览内容的操作,例如禁止缩放但允许切换主题:

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  previewTools: {
    zoom: false,    // 禁用缩放
    theme: true,    // 允许切换主题
    fullscreen: true // 允许全屏切换
  }
});

固定预览模式

如果你希望预览始终以窗口模式显示,可以禁用全屏切换按钮并设置 windowMode: true

js
useVuePrintNext({
  el: '#print-content',
  preview: true,
  windowMode: true,  // 默认使用窗口模式
  previewTools: {
    zoom: true,
    theme: true,
    fullscreen: false // 禁用全屏切换
  }
});

注意事项

  • 即使隐藏了所有工具按钮,关闭按钮仍然会显示,以便用户可以关闭预览窗口。
  • 如果你禁用了某个功能按钮,用户将无法通过界面切换相应的功能,但你仍然可以通过其他配置选项设置初始状态(如 darkModewindowModedefaultScale 等)。

基于 MIT 许可发布