@file-viewer/vue2.6 2.1.2 → 2.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +74 -12
- package/README.md +75 -13
- package/package.json +2 -2
package/README.en.md
CHANGED
|
@@ -69,13 +69,21 @@ Every standard component package shares `@file-viewer/core` as the only common f
|
|
|
69
69
|
| Framework | Standard npm package | Entrypoints | GitHub | Gitee | Historical aliases |
|
|
70
70
|
| --- | --- | --- | --- | --- | --- |
|
|
71
71
|
| Vanilla JS / Pure Web | `@file-viewer/web` | ESM, type declarations, script tag IIFE, worker/WASM viewer assets, asset copy CLI | [file-viewer-web](https://github.com/flyfish-dev/file-viewer-web) | [file-viewer-web](https://gitee.com/flyfish-dev/file-viewer-web) | `@flyfish-group/file-viewer-web` |
|
|
72
|
+
| Vanilla JS / Pure Web Full | `@file-viewer/web-full` | ESM, type declarations, script tag IIFE | [file-viewer-web-full](https://github.com/flyfish-dev/file-viewer-web-full) | [file-viewer-web-full](https://gitee.com/flyfish-dev/file-viewer-web-full) | none |
|
|
72
73
|
| Vue 3 | `@file-viewer/vue3` | ESM, type declarations | [file-viewer-vue3](https://github.com/flyfish-dev/file-viewer-vue3) | [file-viewer-vue3](https://gitee.com/flyfish-dev/file-viewer-vue3) | `@flyfish-group/file-viewer3`, `file-viewer3` |
|
|
74
|
+
| Vue 3 Full | `@file-viewer/vue3-full` | ESM, type declarations | [file-viewer-vue3-full](https://github.com/flyfish-dev/file-viewer-vue3-full) | [file-viewer-vue3-full](https://gitee.com/flyfish-dev/file-viewer-vue3-full) | none |
|
|
73
75
|
| Vue 2.7 | `@file-viewer/vue2.7` | ESM, type declarations | [file-viewer-vue2.7](https://github.com/flyfish-dev/file-viewer-vue2.7) | [file-viewer-vue2.7](https://gitee.com/flyfish-dev/file-viewer-vue2.7) | `@flyfish-group/file-viewer` |
|
|
76
|
+
| Vue 2.7 Full | `@file-viewer/vue2.7-full` | ESM, type declarations | [file-viewer-vue2.7-full](https://github.com/flyfish-dev/file-viewer-vue2.7-full) | [file-viewer-vue2.7-full](https://gitee.com/flyfish-dev/file-viewer-vue2.7-full) | none |
|
|
74
77
|
| Vue 2.6 | `@file-viewer/vue2.6` | ESM, type declarations | [file-viewer-vue2.6](https://github.com/flyfish-dev/file-viewer-vue2.6) | [file-viewer-vue2.6](https://gitee.com/flyfish-dev/file-viewer-vue2.6) | none |
|
|
78
|
+
| Vue 2.6 Full | `@file-viewer/vue2.6-full` | ESM, type declarations | [file-viewer-vue2.6-full](https://github.com/flyfish-dev/file-viewer-vue2.6-full) | [file-viewer-vue2.6-full](https://gitee.com/flyfish-dev/file-viewer-vue2.6-full) | none |
|
|
75
79
|
| React 18/19 | `@file-viewer/react` | ESM, type declarations | [file-viewer-react](https://github.com/flyfish-dev/file-viewer-react) | [file-viewer-react](https://gitee.com/flyfish-dev/file-viewer-react) | `@flyfish-group/file-viewer-react` |
|
|
80
|
+
| React 18/19 Full | `@file-viewer/react-full` | ESM, type declarations | [file-viewer-react-full](https://github.com/flyfish-dev/file-viewer-react-full) | [file-viewer-react-full](https://gitee.com/flyfish-dev/file-viewer-react-full) | none |
|
|
76
81
|
| React 16.8/17 | `@file-viewer/react-legacy` | ESM, type declarations | [file-viewer-react-legacy](https://github.com/flyfish-dev/file-viewer-react-legacy) | [file-viewer-react-legacy](https://gitee.com/flyfish-dev/file-viewer-react-legacy) | none |
|
|
82
|
+
| React 16.8/17 Full | `@file-viewer/react-legacy-full` | ESM, type declarations | [file-viewer-react-legacy-full](https://github.com/flyfish-dev/file-viewer-react-legacy-full) | [file-viewer-react-legacy-full](https://gitee.com/flyfish-dev/file-viewer-react-legacy-full) | none |
|
|
77
83
|
| jQuery | `@file-viewer/jquery` | ESM, type declarations | [file-viewer-jquery](https://github.com/flyfish-dev/file-viewer-jquery) | [file-viewer-jquery](https://gitee.com/flyfish-dev/file-viewer-jquery) | none |
|
|
84
|
+
| jQuery Full | `@file-viewer/jquery-full` | ESM, type declarations | [file-viewer-jquery-full](https://github.com/flyfish-dev/file-viewer-jquery-full) | [file-viewer-jquery-full](https://gitee.com/flyfish-dev/file-viewer-jquery-full) | none |
|
|
78
85
|
| Svelte | `@file-viewer/svelte` | Svelte component, ESM, type declarations | [file-viewer-svelte](https://github.com/flyfish-dev/file-viewer-svelte) | [file-viewer-svelte](https://gitee.com/flyfish-dev/file-viewer-svelte) | none |
|
|
86
|
+
| Svelte Full | `@file-viewer/svelte-full` | Svelte component, ESM, type declarations | [file-viewer-svelte-full](https://github.com/flyfish-dev/file-viewer-svelte-full) | [file-viewer-svelte-full](https://gitee.com/flyfish-dev/file-viewer-svelte-full) | none |
|
|
79
87
|
|
|
80
88
|
## Format Support Matrix
|
|
81
89
|
|
|
@@ -110,10 +118,48 @@ The shared format matrix currently covers 24 preview pipelines and 206 file exte
|
|
|
110
118
|
|
|
111
119
|
## Engineering-Grade On-Demand Renderer Assembly
|
|
112
120
|
|
|
113
|
-
One component, one line of code, fast integration; renderer assembly is what controls install size and first-screen bundle weight.
|
|
121
|
+
One component, one line of code, fast integration; renderer assembly is what controls install size and first-screen bundle weight. Install the component package for the current ecosystem, then choose `@file-viewer/preset-lite`, `@file-viewer/preset-office`, `@file-viewer/preset-engineering`, or `@file-viewer/preset-all`. For Webpack, Rspack, Rollup, Umi, classic multi-page apps, and other non-Vite stacks, pass capability explicitly through `options.preset` or `options.renderers`. The Vite plugin is an optional convenience layer that removes manual imports and copies offline assets.
|
|
114
122
|
|
|
115
123
|
```bash
|
|
116
|
-
npm i @file-viewer/
|
|
124
|
+
npm i @file-viewer/vue2.6 @file-viewer/preset-office
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
```ts
|
|
128
|
+
import officePreset from '@file-viewer/preset-office'
|
|
129
|
+
|
|
130
|
+
const options = {
|
|
131
|
+
preset: officePreset,
|
|
132
|
+
rendererMode: 'replace'
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
When a product combines Office documents with engineering drawings, keep the same `preset` field and pass an array:
|
|
137
|
+
|
|
138
|
+
```ts
|
|
139
|
+
import officePreset from '@file-viewer/preset-office'
|
|
140
|
+
import engineeringPreset from '@file-viewer/preset-engineering'
|
|
141
|
+
|
|
142
|
+
const options = {
|
|
143
|
+
preset: [officePreset, engineeringPreset],
|
|
144
|
+
rendererMode: 'replace'
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
For exact small cuts, install one renderer and pass it through `options.renderers`:
|
|
149
|
+
|
|
150
|
+
```ts
|
|
151
|
+
import { pdfRenderer } from '@file-viewer/renderer-pdf'
|
|
152
|
+
|
|
153
|
+
const options = {
|
|
154
|
+
renderers: [pdfRenderer],
|
|
155
|
+
rendererMode: 'replace'
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Vite projects can add the plugin. It auto-discovers installed presets, injects the virtual module, and copies matching Worker / WASM / font / vendor assets:
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
npm i -D @file-viewer/vite-plugin
|
|
117
163
|
```
|
|
118
164
|
|
|
119
165
|
```ts
|
|
@@ -122,29 +168,43 @@ import { fileViewerRenderers } from '@file-viewer/vite-plugin'
|
|
|
122
168
|
export default {
|
|
123
169
|
plugins: [
|
|
124
170
|
fileViewerRenderers({
|
|
125
|
-
preset: 'office',
|
|
126
|
-
scan: true,
|
|
127
171
|
copyAssets: true
|
|
128
|
-
//
|
|
172
|
+
// No preset option required: the plugin discovers installed @file-viewer/preset-office.
|
|
129
173
|
})
|
|
130
174
|
]
|
|
131
175
|
}
|
|
132
176
|
```
|
|
133
177
|
|
|
178
|
+
Heavy users that want the complete official demo capability can switch to the full preset. Non-Vite projects keep `options.preset`; the Vite config stays the same:
|
|
179
|
+
|
|
180
|
+
```bash
|
|
181
|
+
npm i @file-viewer/vue2.6 @file-viewer/preset-all
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
Use explicit plugin options only when you need customization:
|
|
185
|
+
|
|
134
186
|
```ts
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
187
|
+
fileViewerRenderers({
|
|
188
|
+
preset: 'auto', // keep installed preset auto-discovery while scanning source hints
|
|
189
|
+
scan: true, // detects fileViewerFormats, data-file-viewer-formats, and accept
|
|
190
|
+
formats: ['pdf'], // adds exact renderers outside the installed preset
|
|
191
|
+
copyAssets: true,
|
|
192
|
+
chunkStrategy: 'renderer'
|
|
193
|
+
})
|
|
139
194
|
```
|
|
140
195
|
|
|
141
196
|
For strict custom cuts or component-library tests, disable injection and pass the virtual module explicitly:
|
|
142
197
|
|
|
143
198
|
```ts
|
|
199
|
+
// vite.config.ts
|
|
200
|
+
fileViewerRenderers({ formats: ['pdf'], inject: false, copyAssets: true })
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
```ts
|
|
204
|
+
// Application viewer entry
|
|
144
205
|
import { configuredFileViewerRenderers } from 'virtual:file-viewer-renderers'
|
|
145
206
|
|
|
146
207
|
const options = {
|
|
147
|
-
builtinRenderers: 'none',
|
|
148
208
|
renderers: configuredFileViewerRenderers,
|
|
149
209
|
rendererMode: 'replace'
|
|
150
210
|
}
|
|
@@ -152,11 +212,13 @@ const options = {
|
|
|
152
212
|
|
|
153
213
|
- Vue, React, Svelte, jQuery, and Vanilla JavaScript / Pure Web all receive the same `options`; each package maps them to native props, hooks, actions, plugins, or `mountViewer(...)` parameters.
|
|
154
214
|
- `preset-lite` covers text, Markdown, code, images, audio, and video; `preset-office` covers PDF / Word / Excel / PowerPoint / OFD; `preset-engineering` covers CAD / 3D / drawing / XMind / Geo / Typst / EDA / Data.
|
|
155
|
-
- For the smallest custom bundle, skip presets, install individual renderers such as `@file-viewer/renderer-pdf` or `@file-viewer/renderer-word`, and
|
|
215
|
+
- For the smallest custom bundle, skip presets, install individual renderers such as `@file-viewer/renderer-pdf` or `@file-viewer/renderer-word`, and pass them through `options.renderers`.
|
|
216
|
+
- `fileViewerRenderers()` or `fileViewerRenderers({ copyAssets:true })` auto-discovers installed presets without explicit configuration. When `scan:true` is also enabled, use `preset:'auto'` or `autoPresets:true` to keep preset auto-discovery.
|
|
156
217
|
- `scan:true` detects `fileViewerFormats`, `data-file-viewer-formats`, and upload `accept` hints so development and production builds select matching renderers automatically.
|
|
157
218
|
- `copyAssets:true` copies PDF/CAD/Typst/Archive/Data workers, WASM, and vendor assets for offline and enterprise intranet deployment.
|
|
219
|
+
- `builtinRenderers` remains available for advanced baseline control or historical compatibility. Normal quick starts only need `preset` / `renderers` plus `rendererMode`.
|
|
158
220
|
- If a file is in the supported matrix but its renderer is not assembled, the viewer shows the recommended preset / renderer package. Truly unknown extensions still show an unsupported-format state.
|
|
159
|
-
-
|
|
221
|
+
- `@file-viewer/preset-all` is the full one-step capability path for demos, admin tools, and enterprise all-format workbenches. Normal product surfaces should still prefer narrower presets.
|
|
160
222
|
|
|
161
223
|
## Shared Options And Events
|
|
162
224
|
|
package/README.md
CHANGED
|
@@ -69,13 +69,21 @@ English README: [README.en.md](./README.en.md)。
|
|
|
69
69
|
| 框架 | 标准 npm 包 | 入口格式 | GitHub | Gitee | 兼容历史包 |
|
|
70
70
|
| --- | --- | --- | --- | --- | --- |
|
|
71
71
|
| Vanilla JS / Pure Web | `@file-viewer/web` | ESM, 类型声明, script 标签 IIFE, Worker/WASM viewer 资源, 复制静态资源 CLI | [file-viewer-web](https://github.com/flyfish-dev/file-viewer-web) | [file-viewer-web](https://gitee.com/flyfish-dev/file-viewer-web) | `@flyfish-group/file-viewer-web` |
|
|
72
|
+
| Vanilla JS / Pure Web Full | `@file-viewer/web-full` | ESM, 类型声明, script 标签 IIFE | [file-viewer-web-full](https://github.com/flyfish-dev/file-viewer-web-full) | [file-viewer-web-full](https://gitee.com/flyfish-dev/file-viewer-web-full) | 无 |
|
|
72
73
|
| Vue 3 | `@file-viewer/vue3` | ESM, 类型声明 | [file-viewer-vue3](https://github.com/flyfish-dev/file-viewer-vue3) | [file-viewer-vue3](https://gitee.com/flyfish-dev/file-viewer-vue3) | `@flyfish-group/file-viewer3`, `file-viewer3` |
|
|
74
|
+
| Vue 3 Full | `@file-viewer/vue3-full` | ESM, 类型声明 | [file-viewer-vue3-full](https://github.com/flyfish-dev/file-viewer-vue3-full) | [file-viewer-vue3-full](https://gitee.com/flyfish-dev/file-viewer-vue3-full) | 无 |
|
|
73
75
|
| Vue 2.7 | `@file-viewer/vue2.7` | ESM, 类型声明 | [file-viewer-vue2.7](https://github.com/flyfish-dev/file-viewer-vue2.7) | [file-viewer-vue2.7](https://gitee.com/flyfish-dev/file-viewer-vue2.7) | `@flyfish-group/file-viewer` |
|
|
76
|
+
| Vue 2.7 Full | `@file-viewer/vue2.7-full` | ESM, 类型声明 | [file-viewer-vue2.7-full](https://github.com/flyfish-dev/file-viewer-vue2.7-full) | [file-viewer-vue2.7-full](https://gitee.com/flyfish-dev/file-viewer-vue2.7-full) | 无 |
|
|
74
77
|
| Vue 2.6 | `@file-viewer/vue2.6` | ESM, 类型声明 | [file-viewer-vue2.6](https://github.com/flyfish-dev/file-viewer-vue2.6) | [file-viewer-vue2.6](https://gitee.com/flyfish-dev/file-viewer-vue2.6) | 无 |
|
|
78
|
+
| Vue 2.6 Full | `@file-viewer/vue2.6-full` | ESM, 类型声明 | [file-viewer-vue2.6-full](https://github.com/flyfish-dev/file-viewer-vue2.6-full) | [file-viewer-vue2.6-full](https://gitee.com/flyfish-dev/file-viewer-vue2.6-full) | 无 |
|
|
75
79
|
| React 18/19 | `@file-viewer/react` | ESM, 类型声明 | [file-viewer-react](https://github.com/flyfish-dev/file-viewer-react) | [file-viewer-react](https://gitee.com/flyfish-dev/file-viewer-react) | `@flyfish-group/file-viewer-react` |
|
|
80
|
+
| React 18/19 Full | `@file-viewer/react-full` | ESM, 类型声明 | [file-viewer-react-full](https://github.com/flyfish-dev/file-viewer-react-full) | [file-viewer-react-full](https://gitee.com/flyfish-dev/file-viewer-react-full) | 无 |
|
|
76
81
|
| React 16.8/17 | `@file-viewer/react-legacy` | ESM, 类型声明 | [file-viewer-react-legacy](https://github.com/flyfish-dev/file-viewer-react-legacy) | [file-viewer-react-legacy](https://gitee.com/flyfish-dev/file-viewer-react-legacy) | 无 |
|
|
82
|
+
| React 16.8/17 Full | `@file-viewer/react-legacy-full` | ESM, 类型声明 | [file-viewer-react-legacy-full](https://github.com/flyfish-dev/file-viewer-react-legacy-full) | [file-viewer-react-legacy-full](https://gitee.com/flyfish-dev/file-viewer-react-legacy-full) | 无 |
|
|
77
83
|
| jQuery | `@file-viewer/jquery` | ESM, 类型声明 | [file-viewer-jquery](https://github.com/flyfish-dev/file-viewer-jquery) | [file-viewer-jquery](https://gitee.com/flyfish-dev/file-viewer-jquery) | 无 |
|
|
84
|
+
| jQuery Full | `@file-viewer/jquery-full` | ESM, 类型声明 | [file-viewer-jquery-full](https://github.com/flyfish-dev/file-viewer-jquery-full) | [file-viewer-jquery-full](https://gitee.com/flyfish-dev/file-viewer-jquery-full) | 无 |
|
|
78
85
|
| Svelte | `@file-viewer/svelte` | Svelte 组件, ESM, 类型声明 | [file-viewer-svelte](https://github.com/flyfish-dev/file-viewer-svelte) | [file-viewer-svelte](https://gitee.com/flyfish-dev/file-viewer-svelte) | 无 |
|
|
86
|
+
| Svelte Full | `@file-viewer/svelte-full` | Svelte 组件, ESM, 类型声明 | [file-viewer-svelte-full](https://github.com/flyfish-dev/file-viewer-svelte-full) | [file-viewer-svelte-full](https://gitee.com/flyfish-dev/file-viewer-svelte-full) | 无 |
|
|
79
87
|
|
|
80
88
|
## 格式支持矩阵
|
|
81
89
|
|
|
@@ -110,10 +118,48 @@ English README: [README.en.md](./README.en.md)。
|
|
|
110
118
|
|
|
111
119
|
## 工程级按需 renderer 装配
|
|
112
120
|
|
|
113
|
-
一个组件,一行代码,快速集成;真正影响安装体积和首屏包体的是 renderer
|
|
121
|
+
一个组件,一行代码,快速集成;真正影响安装体积和首屏包体的是 renderer 装配。推荐先安装当前生态组件包,再按产品形态选择 `@file-viewer/preset-lite`、`@file-viewer/preset-office`、`@file-viewer/preset-engineering` 或 `@file-viewer/preset-all`。Webpack、Rspack、Rollup、Umi、传统多页应用等非 Vite 项目,优先通过 `options.preset` 或 `options.renderers` 显式注入能力;Vite 插件只是进一步省掉手动 import 并复制离线资产。
|
|
114
122
|
|
|
115
123
|
```bash
|
|
116
|
-
npm i @file-viewer/
|
|
124
|
+
npm i @file-viewer/vue2.6 @file-viewer/preset-office
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
```ts
|
|
128
|
+
import officePreset from '@file-viewer/preset-office'
|
|
129
|
+
|
|
130
|
+
const options = {
|
|
131
|
+
preset: officePreset,
|
|
132
|
+
rendererMode: 'replace'
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
需要组合办公文档与工程图纸等能力时,继续使用同一个 `preset` 字段传数组即可:
|
|
137
|
+
|
|
138
|
+
```ts
|
|
139
|
+
import officePreset from '@file-viewer/preset-office'
|
|
140
|
+
import engineeringPreset from '@file-viewer/preset-engineering'
|
|
141
|
+
|
|
142
|
+
const options = {
|
|
143
|
+
preset: [officePreset, engineeringPreset],
|
|
144
|
+
rendererMode: 'replace'
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
如果只需要少数格式,也可以安装单 renderer 并传给 `options.renderers`:
|
|
149
|
+
|
|
150
|
+
```ts
|
|
151
|
+
import { pdfRenderer } from '@file-viewer/renderer-pdf'
|
|
152
|
+
|
|
153
|
+
const options = {
|
|
154
|
+
renderers: [pdfRenderer],
|
|
155
|
+
rendererMode: 'replace'
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Vite 项目可以再加插件,插件会免配置发现已安装 preset、注入 virtual module,并按命中格式复制 Worker / WASM / 字体 / vendor 资源:
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
npm i -D @file-viewer/vite-plugin
|
|
117
163
|
```
|
|
118
164
|
|
|
119
165
|
```ts
|
|
@@ -122,29 +168,43 @@ import { fileViewerRenderers } from '@file-viewer/vite-plugin'
|
|
|
122
168
|
export default {
|
|
123
169
|
plugins: [
|
|
124
170
|
fileViewerRenderers({
|
|
125
|
-
preset: 'office',
|
|
126
|
-
scan: true,
|
|
127
171
|
copyAssets: true
|
|
128
|
-
//
|
|
172
|
+
// 无需 preset 配置:插件会自动发现已安装的 @file-viewer/preset-office。
|
|
129
173
|
})
|
|
130
174
|
]
|
|
131
175
|
}
|
|
132
176
|
```
|
|
133
177
|
|
|
178
|
+
重度用户需要一次拥有官方 Demo 的完整能力时,直接把 preset 换成全量包;非 Vite 项目继续传 `options.preset`,Vite 配置也保持不变:
|
|
179
|
+
|
|
180
|
+
```bash
|
|
181
|
+
npm i @file-viewer/vue2.6 @file-viewer/preset-all
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
需要自定义装配时,再显式配置插件:
|
|
185
|
+
|
|
134
186
|
```ts
|
|
135
|
-
|
|
136
|
-
//
|
|
137
|
-
|
|
138
|
-
|
|
187
|
+
fileViewerRenderers({
|
|
188
|
+
preset: 'auto', // 同时开启源码扫描时,仍自动发现已安装 preset
|
|
189
|
+
scan: true, // 识别 fileViewerFormats、data-file-viewer-formats、accept
|
|
190
|
+
formats: ['pdf'], // 在已安装 preset 之外额外补充精确 renderer
|
|
191
|
+
copyAssets: true,
|
|
192
|
+
chunkStrategy: 'renderer'
|
|
193
|
+
})
|
|
139
194
|
```
|
|
140
195
|
|
|
141
|
-
|
|
196
|
+
严格裁剪或组件库内部测试时,可以关闭自动注入并显式传入 virtual module:
|
|
197
|
+
|
|
198
|
+
```ts
|
|
199
|
+
// vite.config.ts
|
|
200
|
+
fileViewerRenderers({ formats: ['pdf'], inject: false, copyAssets: true })
|
|
201
|
+
```
|
|
142
202
|
|
|
143
203
|
```ts
|
|
204
|
+
// 业务组件入口
|
|
144
205
|
import { configuredFileViewerRenderers } from 'virtual:file-viewer-renderers'
|
|
145
206
|
|
|
146
207
|
const options = {
|
|
147
|
-
builtinRenderers: 'none',
|
|
148
208
|
renderers: configuredFileViewerRenderers,
|
|
149
209
|
rendererMode: 'replace'
|
|
150
210
|
}
|
|
@@ -152,11 +212,13 @@ const options = {
|
|
|
152
212
|
|
|
153
213
|
- Vue、React、Svelte、jQuery、Vanilla JS / Pure Web 都传同一份 `options`,只是在各自生态中映射为 props、hook、action、plugin 或 `mountViewer(...)` 参数。
|
|
154
214
|
- `preset-lite` 面向文本、Markdown、代码、图片和音视频;`preset-office` 面向 PDF / Word / Excel / PowerPoint / OFD;`preset-engineering` 面向 CAD / 3D / 绘图 / XMind / Geo / Typst / EDA / Data。
|
|
155
|
-
- 想要最小包体时,可以不用 preset,直接安装 `@file-viewer/renderer-pdf`、`@file-viewer/renderer-word` 等单个 renderer
|
|
215
|
+
- 想要最小包体时,可以不用 preset,直接安装 `@file-viewer/renderer-pdf`、`@file-viewer/renderer-word` 等单个 renderer,并通过 `options.renderers` 手动注入。
|
|
216
|
+
- `fileViewerRenderers()` 或 `fileViewerRenderers({ copyAssets:true })` 会免配置自动发现已安装 preset;如果同时开启 `scan:true`,请使用 `preset:'auto'` 或 `autoPresets:true` 保留 preset 自动发现。
|
|
156
217
|
- `scan:true` 会识别 `fileViewerFormats`、`data-file-viewer-formats` 和上传控件 `accept`,调试与打包时自动选择 renderer。
|
|
157
218
|
- `copyAssets:true` 会复制 PDF/CAD/Typst/Archive/Data 等 worker、WASM 和 vendor 资源,满足离线和企业内网部署。
|
|
219
|
+
- `builtinRenderers` 仍可用于高级基线控制或历史兼容;普通快速接入只需要 `preset` / `renderers` 与 `rendererMode`。
|
|
158
220
|
- 如果打开的是支持矩阵内但未装配的格式,预览器会提示应安装的 preset / renderer;只有真正不在矩阵中的扩展名才提示不支持。
|
|
159
|
-
-
|
|
221
|
+
- `@file-viewer/preset-all` 是全量一键方案,适合 demo、后台运维工具和企业全格式附件中心;普通业务仍建议优先选择更窄的 preset。
|
|
160
222
|
|
|
161
223
|
## 统一参数与事件
|
|
162
224
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@file-viewer/vue2.6",
|
|
3
|
-
"version": "2.1.
|
|
3
|
+
"version": "2.1.3",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Standard Vue 2.6 component package for Flyfish File Viewer",
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
"vue": ">=2.6 <2.7"
|
|
57
57
|
},
|
|
58
58
|
"dependencies": {
|
|
59
|
-
"@file-viewer/core": "^2.1.
|
|
59
|
+
"@file-viewer/core": "^2.1.3"
|
|
60
60
|
},
|
|
61
61
|
"devDependencies": {
|
|
62
62
|
"typescript": "^6.0.3",
|