基本用法
1. 打开工具
从首页进入 /vue-office,或搜索「vue office」「文档预览」。
2. 选择文档类型
根据文件格式选择对应类型:
| 类型 | 扩展名 |
|---|---|
| Word | .docx |
| Excel | .xlsx、.xls |
.pdf |
工具会根据 URL 或文件名自动识别类型,必要时可手动切换。
3. 通过 URL 预览
- 点击 URL 地址 输入模式
- 粘贴可公开访问的文档 URL
- 点击 预览(或在输入框按 Enter)
示例(需确保远程服务器允许跨域访问):
- Word:
http://static.shanhuxueyuan.com/test6.docx - Excel:公开可访问的
.xlsx/.xls链接 - PDF:公开可访问的
.pdf链接
4. 通过本地上传预览
- 点击 上传文件 模式
- 点击虚线框区域选择本地文档
- 文件读取完成后自动开始渲染预览
支持 .docx、.xlsx、.xls、.pdf,选错类型时也会根据扩展名自动切换组件。
5. 查看预览状态
预览状态 面板显示:
- 当前状态(空闲、加载中、渲染中、渲染完成、错误)
- 已选文件名(本地上传时)
6. 调整预览视图
文档加载成功后,预览区右上角提供:
| 按钮 | 说明 |
|---|---|
| 宽屏模式 | 隐藏左侧控制栏,预览占满一行 |
| 影院模式 | 深色全屏 overlay,专注阅读 |
| 全屏 | 预览容器进入浏览器全屏 |
- 宽屏与影院模式互斥
- 按
Esc可退出影院或宽屏(全屏时Esc由浏览器处理)
7. 使用历史记录
URL 预览会写入 历史记录。点击眼睛图标可重新加载该 URL。
说明: 本地上传的历史仅保存文件名与类型等元数据,再次预览需重新上传文件。
故障排除
| 问题 | 处理方式 |
|---|---|
| 预览空白 | 确认 URL 可公开访问且格式正确 |
| CORS 错误 | 远程服务器需允许跨域,或改本地上传 |
| 格式不对 | 手动选择正确的文档类型 |
| Excel 宽度异常 | 切换宽屏或全屏后稍等布局同步 |