w

高级功能

自动类型识别

提供 URL 或上传文件后,工具会根据扩展名自动切换预览组件:

  • .docx → Word 预览
  • .xlsx / .xls → Excel 预览
  • .pdf → PDF 预览

MIME 类型也会参与识别,减少选错格式的概率。

按需加载组件

Word、Excel、PDF 三类预览组件分别懒加载(@vue-office/docx@vue-office/excel@vue-office/pdf)。只有当前选中的类型会下载对应脚本,首屏加载更快。

大文件处理

vue-office 对大文档做了虚拟滚动与解析优化。处理超大文件时建议:

  • 优先使用本地上传,避免网络超时
  • 首次渲染多等待片刻,关注加载指示器
  • Excel 列数较多时,可配合宽屏/全屏获得更好视野

URL 预览与 CORS

URL 模式要求远程服务器返回正确的 CORS 头。若 URL 失败但本地上传正常,通常是跨域被拦截。

可选方案:

  1. 改为本地上传
  2. 将文件放到支持 CORS 的 CDN
  3. 自行搭建代理(本工具不提供服务端代理)

视图模式详解

宽屏模式

隐藏左侧文档类型、输入方式等控制区,预览区占据整行,适合表格类文档横向阅读。

影院模式

通过 Teleport 渲染全页遮罩,顶部显示文件名/URL,预览区最大化。适合演示或长时间阅读。

全屏

对预览容器调用浏览器 Fullscreen API。Excel 等组件会在容器尺寸变化后自动同步布局,尽量铺满可视区域。

快捷键

按键作用
EnterURL 输入框聚焦时触发预览
Esc退出影院模式或宽屏模式(非浏览器全屏时)

历史记录管理

  • 最多保存 50 条本地历史
  • URL 记录可一键重载
  • 本地上传记录仅保存元数据,需重新选择文件
  • 点击 清空全部清空历史 可清除对应数据

浏览器兼容性

建议使用支持 ES Module 的现代浏览器:

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+
这个页面对您有帮助吗?