How xushanpei/open-file-viewer works
Open File Viewer is a browser-based file-preview SDK. A host application supplies a file or file queue, a container, and ordered format plugins; the viewer manages navigation, toolbar and preview state while plugins render supported formats or provide fallback behavior. The core also exposes support detection and framework adapters for React, Vue, and Svelte. The README documents broad format coverage, but several plugin implementations were not sampled; their nodes and viewer dispatch links reflect documented capabilities rather than inspected internals.
Main entry points: viewer.ts Viewer and queue · office.ts Office preview · pdf.ts PDF preview · index.tsx React adapter
Components 27
Host integrations
- React adapter
packages/react/src/index.tsx - Vue adapter
packages/vue/src/index.ts - Svelte adapter
packages/svelte/src/OpenFileViewer.svelte
Viewer runtime
- Viewer and queue
packages/core/src/viewer.ts - Support check
packages/core/src/support.ts
Format plugins
- Image preview
packages/core/src/plugins/image.ts - PDF preview
packages/core/src/plugins/pdf.ts - Data and assets
packages/core/src/plugins/asset.ts - Audio and video
packages/core/src/plugins/audio.ts - Text and code
packages/core/src/plugins/text.ts - Archive preview
packages/core/src/plugins/archive.ts - Email preview
packages/core/src/plugins/email.ts - Drawing preview
packages/core/src/plugins/drawing.ts - GIS preview
packages/core/src/plugins/gis.ts - 3D preview
packages/core/src/plugins/model3d.ts - Download fallback
packages/core/src/plugins/fallback.ts
Office and CAD
- Office preview
packages/core/src/plugins/office.ts - Legacy Word parser
packages/core/src/plugins/msdoc.ts - Legacy PowerPoint parser
packages/core/src/plugins/msppt.ts - WordML parser
packages/core/src/plugins/wordml.ts - CAD preview
packages/core/src/plugins/cad.ts - DWG and OASIS parsers
packages/core/src/plugins/cad-dwg.ts
Shared services
- File normalization
packages/core/src/detect.ts - DOM utilities
packages/core/src/dom.ts - Messages and locale
packages/core/src/messages.ts - Plugin utilities
packages/core/src/plugins/utils.ts
Other components
- Web application
Connections 32
- Web application → Viewer and queue: configures
- Web application → React adapter: uses
- Web application → Vue adapter: uses
- Web application → Svelte adapter: uses
- React adapter → Viewer and queue: wraps
packages/react/src/index.tsx - Vue adapter → Viewer and queue: wraps
packages/vue/src/index.ts - Svelte adapter → Viewer and queue: creates
packages/svelte/src/OpenFileViewer.svelte - Viewer and queue → File normalization: normalizes files
packages/core/src/viewer.ts - Support check → File normalization: normalizes source
packages/core/src/support.ts - Viewer and queue → DOM utilities: resolves container
packages/core/src/viewer.ts - Viewer and queue → Messages and locale: resolves locale
packages/core/src/viewer.ts - Viewer and queue → Image preview: dispatches plugin
- Viewer and queue → PDF preview: dispatches plugin
- Viewer and queue → Data and assets: dispatches plugin
- Viewer and queue → Audio and video: dispatches plugins
- Viewer and queue → Text and code: dispatches plugin
- Viewer and queue → Archive preview: dispatches plugin
- Viewer and queue → Email preview: dispatches plugin
- Viewer and queue → Drawing preview: dispatches plugin
- Viewer and queue → GIS preview: dispatches plugin
- Viewer and queue → 3D preview: dispatches plugin
- Viewer and queue → Office preview: dispatches plugin
- Viewer and queue → CAD preview: dispatches plugin
- Viewer and queue → Download fallback: dispatches fallback
packages/core/src/viewer.ts - Office preview → Legacy Word parser: parses legacy Word
packages/core/src/plugins/office.ts - Office preview → Legacy PowerPoint parser: parses legacy slides
packages/core/src/plugins/office.ts - Office preview → WordML parser: parses WordML
packages/core/src/plugins/office.ts - CAD preview → DWG and OASIS parsers: uses parsers
packages/core/src/plugins/cad.ts - Image preview → DOM utilities: uses utilities
packages/core/src/plugins/image.ts - Archive preview → Plugin utilities: reads file data
packages/core/src/plugins/archive.ts - PDF preview → Plugin utilities: uses zoom helper
packages/core/src/plugins/pdf.ts - Data and assets → PDF preview: renders PDF asset
packages/core/src/plugins/asset.ts