# 501351981/vue-office architecture

> Architecture diagram of the GitHub repository 501351981/vue-office, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/501351981/vue-office
- Repository: https://github.com/501351981/vue-office

## Overview

vue-office provides document preview for DOCX, Excel, PDF, and PPTX through Vue components and framework-independent JavaScript APIs. The principal workflow accepts a URL or file data, loads and transforms the document, then renders it in the browser; previews expose completion or error events. Excel additionally uses a spreadsheet model and image rendering, while PDF uses PDF.js with virtualized page rendering. The README documents all four formats and Vue 2/3 support. Some implementation details, especially PPTX and unsampled modules, are not shown; links without direct source evidence are omitted or marked unverified.

Main entry points: [`core/packages/vue-excel/src/main.vue`](https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/main.vue) (Vue Excel preview), [`core/packages/js-excel/src/main.js`](https://github.com/501351981/vue-office/blob/master/core/packages/js-excel/src/main.js) (JavaScript Excel preview), [`core/packages/vue-pdf/src/main.vue`](https://github.com/501351981/vue-office/blob/master/core/packages/vue-pdf/src/main.vue) (Vue PDF preview), [`core/packages/js-pdf/src/main.js`](https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/main.js) (JavaScript PDF preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Preview interfaces"]
  node_vue_docx["Vue DOCX preview<br/>[main.vue]"]
  node_js_docx["JavaScript DOCX preview<br/>[main.js]"]
  node_vue_excel["Vue Excel preview<br/>[main.vue]"]
  node_js_excel["JavaScript Excel preview<br/>[main.js]"]
  node_vue_pdf["Vue PDF preview<br/>[main.vue]"]
  node_js_pdf["JavaScript PDF preview<br/>[main.js]"]
  node_vue_pptx["Vue PPTX preview<br/>[main.vue]"]
  node_demo_app["Preview demo app<br/>[App.vue]"]
end

subgraph group_document["Document renderers"]
  node_docx_renderer["DOCX renderer<br/>[docx.js]"]
  node_pdf_engine["PDF.js engine<br/>[pdf.js]"]
  node_pdf_worker["PDF.js worker<br/>[worker.js]"]
  node_pptx_library["PPTX preview library"]
end

subgraph group_excel["Excel rendering"]
  node_excel_loader["Workbook loading<br/>[excel.js]"]
  node_spreadsheet["Sheet model and UI"]
  node_excel_media["Excel image rendering<br/>[media.js]"]
end

subgraph group_runtime["Shared runtime"]
  node_url_utils["Source and download utilities<br/>[url.js]"]
end

node_user(("Application developer"))
node_document_input["Document source"]

node_user -->|"provides source"| node_document_input
node_document_input -->|"supplies src"| node_vue_docx
node_document_input -->|"supplies src"| node_vue_excel
node_document_input -->|"supplies src"| node_vue_pdf
node_document_input -->|"supplies src"| node_vue_pptx
node_document_input -->|"supplies source"| node_js_docx
node_document_input -->|"supplies source"| node_js_excel
node_document_input -->|"supplies source"| node_js_pdf
node_vue_docx -->|"renders with"| node_docx_renderer
node_js_docx -->|"uses renderer"| node_docx_renderer
node_vue_excel -->|"loads workbook"| node_excel_loader
node_vue_excel -->|"loads sheet data"| node_spreadsheet
node_vue_excel -->|"renders images"| node_excel_media
node_js_excel -->|"loads workbook"| node_excel_loader
node_js_excel -->|"loads sheet data"| node_spreadsheet
node_js_excel -->|"renders images"| node_excel_media
node_vue_pdf -->|"resolves source"| node_url_utils
node_vue_pdf -.->|"loads PDF.js"| node_pdf_engine
node_vue_pdf -.->|"configures worker"| node_pdf_worker
node_js_pdf -->|"loads and resolves"| node_url_utils
node_js_pdf -->|"loads PDF.js"| node_pdf_engine
node_js_pdf -->|"configures worker"| node_pdf_worker
node_vue_pptx -.->|"uses preview library"| node_pptx_library
node_user -->|"selects preview"| node_demo_app

click node_vue_docx "https://github.com/501351981/vue-office/blob/master/core/packages/vue-docx/src/main.vue"
click node_js_docx "https://github.com/501351981/vue-office/blob/master/core/packages/js-docx/src/main.js"
click node_docx_renderer "https://github.com/501351981/vue-office/blob/master/core/packages/vue-docx/src/docx.js"
click node_vue_excel "https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/main.vue"
click node_js_excel "https://github.com/501351981/vue-office/blob/master/core/packages/js-excel/src/main.js"
click node_excel_loader "https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/excel.js"
click node_spreadsheet "https://github.com/501351981/vue-office/tree/master/core/packages/vue-excel/src/x-spreadsheet"
click node_excel_media "https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/media.js"
click node_vue_pdf "https://github.com/501351981/vue-office/blob/master/core/packages/vue-pdf/src/main.vue"
click node_js_pdf "https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/main.js"
click node_pdf_engine "https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/pdf.js"
click node_pdf_worker "https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/worker.js"
click node_vue_pptx "https://github.com/501351981/vue-office/blob/master/core/packages/vue-pptx/src/main.vue"
click node_url_utils "https://github.com/501351981/vue-office/blob/master/core/utils/url.js"
click node_demo_app "https://github.com/501351981/vue-office/blob/master/core/src/App.vue"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vue_docx,node_js_docx,node_vue_excel,node_js_excel,node_vue_pdf,node_js_pdf,node_vue_pptx,node_demo_app toneBlue
class node_docx_renderer,node_pdf_engine,node_pdf_worker,node_pptx_library toneAmber
class node_excel_loader,node_spreadsheet,node_excel_media toneMint
class node_url_utils toneRose
class node_user,node_document_input toneIndigo
```

## Components

### Preview interfaces

- [Vue DOCX preview](https://github.com/501351981/vue-office/blob/master/core/packages/vue-docx/src/main.vue): `core/packages/vue-docx/src/main.vue`
- [JavaScript DOCX preview](https://github.com/501351981/vue-office/blob/master/core/packages/js-docx/src/main.js): `core/packages/js-docx/src/main.js`
- [Vue Excel preview](https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/main.vue): `core/packages/vue-excel/src/main.vue`
- [JavaScript Excel preview](https://github.com/501351981/vue-office/blob/master/core/packages/js-excel/src/main.js): `core/packages/js-excel/src/main.js`
- [Vue PDF preview](https://github.com/501351981/vue-office/blob/master/core/packages/vue-pdf/src/main.vue): `core/packages/vue-pdf/src/main.vue`
- [JavaScript PDF preview](https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/main.js): `core/packages/js-pdf/src/main.js`
- [Vue PPTX preview](https://github.com/501351981/vue-office/blob/master/core/packages/vue-pptx/src/main.vue): `core/packages/vue-pptx/src/main.vue`
- [Preview demo app](https://github.com/501351981/vue-office/blob/master/core/src/App.vue): `core/src/App.vue`

### Document renderers

- [DOCX renderer](https://github.com/501351981/vue-office/blob/master/core/packages/vue-docx/src/docx.js): `core/packages/vue-docx/src/docx.js`
- [PDF.js engine](https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/pdf.js): `core/packages/js-pdf/src/pdf.js`
- [PDF.js worker](https://github.com/501351981/vue-office/blob/master/core/packages/js-pdf/src/worker.js): `core/packages/js-pdf/src/worker.js`
- **PPTX preview library**

### Excel rendering

- [Workbook loading](https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/excel.js): `core/packages/vue-excel/src/excel.js`
- [Sheet model and UI](https://github.com/501351981/vue-office/tree/master/core/packages/vue-excel/src/x-spreadsheet): `core/packages/vue-excel/src/x-spreadsheet`
- [Excel image rendering](https://github.com/501351981/vue-office/blob/master/core/packages/vue-excel/src/media.js): `core/packages/vue-excel/src/media.js`

### Shared runtime

- [Source and download utilities](https://github.com/501351981/vue-office/blob/master/core/utils/url.js): `core/utils/url.js`

### Other components

- **Application developer**
- **Document source**

## Connections

- Application developer → Document source: provides source (evidence: `README.md`)
- Document source → Vue DOCX preview: supplies src (evidence: `README.md`)
- Document source → Vue Excel preview: supplies src (evidence: `README.md`)
- Document source → Vue PDF preview: supplies src (evidence: `README.md`)
- Document source → Vue PPTX preview: supplies src (evidence: `README.md`)
- Document source → JavaScript DOCX preview: supplies source (evidence: `README.md`)
- Document source → JavaScript Excel preview: supplies source (evidence: `README.md`)
- Document source → JavaScript PDF preview: supplies source (evidence: `README.md`)
- Vue DOCX preview → DOCX renderer: renders with (evidence: `core/packages/vue-docx/src/main.vue`)
- JavaScript DOCX preview → DOCX renderer: uses renderer (evidence: `core/packages/js-docx/src/main.js`)
- Vue Excel preview → Workbook loading: loads workbook (evidence: `core/packages/vue-excel/src/main.vue`)
- Vue Excel preview → Sheet model and UI: loads sheet data (evidence: `core/packages/vue-excel/src/main.vue`)
- Vue Excel preview → Excel image rendering: renders images (evidence: `core/packages/vue-excel/src/main.vue`)
- JavaScript Excel preview → Workbook loading: loads workbook (evidence: `core/packages/js-excel/src/main.js`)
- JavaScript Excel preview → Sheet model and UI: loads sheet data (evidence: `core/packages/js-excel/src/main.js`)
- JavaScript Excel preview → Excel image rendering: renders images (evidence: `core/packages/js-excel/src/main.js`)
- Vue PDF preview → Source and download utilities: resolves source (evidence: `core/packages/vue-pdf/src/main.vue`)
- Vue PDF preview → PDF.js engine: loads PDF.js
- Vue PDF preview → PDF.js worker: configures worker
- JavaScript PDF preview → Source and download utilities: loads and resolves (evidence: `core/packages/js-pdf/src/main.js`)
- JavaScript PDF preview → PDF.js engine: loads PDF.js (evidence: `core/packages/js-pdf/src/main.js`)
- JavaScript PDF preview → PDF.js worker: configures worker (evidence: `core/packages/js-pdf/src/main.js`)
- Vue PPTX preview → PPTX preview library: uses preview library (evidence: `README.md`)
- Application developer → Preview demo app: selects preview (evidence: `core/src/App.vue`)
