Расширенные возможности
Автоопределение типа
При указании URL или загрузке файла инструмент проверяет расширение и автоматически переключает компонент предпросмотра:
.docx→ просмотр Word.xlsx/.xls→ просмотр Excel.pdf→ просмотр PDF
Ленивая загрузка компонентов
Каждый просмотрщик (@vue-office/docx, @vue-office/excel, @vue-office/pdf) загружается по требованию. Скачивается только компонент выбранного типа — быстрая начальная загрузка страницы.
Работа с большими файлами
vue-office использует виртуальную прокрутку и оптимизированный разбор для больших документов. Для очень больших файлов:
- Предпочитайте локальную загрузку удалённым URL
- Заложите больше времени на первый рендеринг
- Дождитесь индикатора загрузки перед взаимодействием
Требования CORS для предпросмотра по URL
Предпросмотр по URL требует корректных CORS-заголовков от удалённого сервера. Если URL не работает, а загрузка файла работает — сервер, вероятно, блокирует cross-origin доступ.
Обходные пути:
- Загрузите файл локально
- Разместите файл на CDN с поддержкой CORS
- Используйте серверный прокси (этот инструмент его не предоставляет)
Режимы отображения
Широкий экран
Скрывает левые элементы управления — предпросмотр занимает всю ширину строки. Полезно для широких таблиц Excel.
Кинорежим
Полностраничное наложение с тёмным фоном. Взаимоисключающий с широким экраном.
Полный экран
Использует Fullscreen API браузера для контейнера предпросмотра. Excel и другие просмотрщики синхронизируют вёрстку при входе и выходе.
Горячие клавиши
| Клавиша | Действие |
|---|---|
| Enter | Загрузить предпросмотр (фокус в поле URL) |
| Esc | Выйти из кинорежима или широкого экрана (если не полный экран браузера) |
Управление историей
- До 50 записей хранятся локально
- Записи URL перезагружаются одним кликом
- Записи загрузки хранят только метаданные (нужна повторная загрузка)
Совместимость с браузерами
Лучше всего работает в современных браузерах с полной поддержкой ES-модулей:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+