고급 기능
자동 유형 인식
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+