高级功能
自动类型识别
提供 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 失败但本地上传正常,通常是跨域被拦截。
可选方案:
- 改为本地上传
- 将文件放到支持 CORS 的 CDN
- 自行搭建代理(本工具不提供服务端代理)
视图模式详解
宽屏模式
隐藏左侧文档类型、输入方式等控制区,预览区占据整行,适合表格类文档横向阅读。
影院模式
通过 Teleport 渲染全页遮罩,顶部显示文件名/URL,预览区最大化。适合演示或长时间阅读。
全屏
对预览容器调用浏览器 Fullscreen API。Excel 等组件会在容器尺寸变化后自动同步布局,尽量铺满可视区域。
快捷键
| 按键 | 作用 |
|---|---|
| Enter | URL 输入框聚焦时触发预览 |
| Esc | 退出影院模式或宽屏模式(非浏览器全屏时) |
历史记录管理
- 最多保存 50 条本地历史
- URL 记录可一键重载
- 本地上传记录仅保存元数据,需重新选择文件
- 点击 清空全部 或 清空历史 可清除对应数据
浏览器兼容性
建议使用支持 ES Module 的现代浏览器:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+