@file-viewer/react 2.1.1 → 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 +80 -7
- package/README.md +80 -7
- package/package.json +2 -2
package/README.en.md
CHANGED
|
@@ -38,13 +38,21 @@ Every standard component package shares `@file-viewer/core` as the only common f
|
|
|
38
38
|
| Framework | Standard npm package | Entrypoints | GitHub | Gitee | Historical aliases |
|
|
39
39
|
| --- | --- | --- | --- | --- | --- |
|
|
40
40
|
| 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` |
|
|
41
|
+
| 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 |
|
|
41
42
|
| 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` |
|
|
43
|
+
| 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 |
|
|
42
44
|
| 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` |
|
|
45
|
+
| 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 |
|
|
43
46
|
| 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 |
|
|
47
|
+
| 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 |
|
|
44
48
|
| 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` |
|
|
49
|
+
| 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 |
|
|
45
50
|
| 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 |
|
|
51
|
+
| 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 |
|
|
46
52
|
| 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 |
|
|
53
|
+
| 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 |
|
|
47
54
|
| 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 |
|
|
55
|
+
| 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 |
|
|
48
56
|
|
|
49
57
|
## Format Support Matrix
|
|
50
58
|
|
|
@@ -79,10 +87,48 @@ The shared format matrix currently covers 24 preview pipelines and 206 file exte
|
|
|
79
87
|
|
|
80
88
|
## Engineering-Grade On-Demand Renderer Assembly
|
|
81
89
|
|
|
82
|
-
One component, one line of code, fast integration; renderer assembly is what controls install size and first-screen bundle weight.
|
|
90
|
+
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.
|
|
83
91
|
|
|
84
92
|
```bash
|
|
85
|
-
npm i @file-viewer/
|
|
93
|
+
npm i @file-viewer/react @file-viewer/preset-office
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
```ts
|
|
97
|
+
import officePreset from '@file-viewer/preset-office'
|
|
98
|
+
|
|
99
|
+
const options = {
|
|
100
|
+
preset: officePreset,
|
|
101
|
+
rendererMode: 'replace'
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
When a product combines Office documents with engineering drawings, keep the same `preset` field and pass an array:
|
|
106
|
+
|
|
107
|
+
```ts
|
|
108
|
+
import officePreset from '@file-viewer/preset-office'
|
|
109
|
+
import engineeringPreset from '@file-viewer/preset-engineering'
|
|
110
|
+
|
|
111
|
+
const options = {
|
|
112
|
+
preset: [officePreset, engineeringPreset],
|
|
113
|
+
rendererMode: 'replace'
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
For exact small cuts, install one renderer and pass it through `options.renderers`:
|
|
118
|
+
|
|
119
|
+
```ts
|
|
120
|
+
import { pdfRenderer } from '@file-viewer/renderer-pdf'
|
|
121
|
+
|
|
122
|
+
const options = {
|
|
123
|
+
renderers: [pdfRenderer],
|
|
124
|
+
rendererMode: 'replace'
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
Vite projects can add the plugin. It auto-discovers installed presets, injects the virtual module, and copies matching Worker / WASM / font / vendor assets:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
npm i -D @file-viewer/vite-plugin
|
|
86
132
|
```
|
|
87
133
|
|
|
88
134
|
```ts
|
|
@@ -91,19 +137,43 @@ import { fileViewerRenderers } from '@file-viewer/vite-plugin'
|
|
|
91
137
|
export default {
|
|
92
138
|
plugins: [
|
|
93
139
|
fileViewerRenderers({
|
|
94
|
-
preset: 'office',
|
|
95
|
-
scan: true,
|
|
96
140
|
copyAssets: true
|
|
141
|
+
// No preset option required: the plugin discovers installed @file-viewer/preset-office.
|
|
97
142
|
})
|
|
98
143
|
]
|
|
99
144
|
}
|
|
100
145
|
```
|
|
101
146
|
|
|
147
|
+
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:
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
npm i @file-viewer/react @file-viewer/preset-all
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Use explicit plugin options only when you need customization:
|
|
154
|
+
|
|
155
|
+
```ts
|
|
156
|
+
fileViewerRenderers({
|
|
157
|
+
preset: 'auto', // keep installed preset auto-discovery while scanning source hints
|
|
158
|
+
scan: true, // detects fileViewerFormats, data-file-viewer-formats, and accept
|
|
159
|
+
formats: ['pdf'], // adds exact renderers outside the installed preset
|
|
160
|
+
copyAssets: true,
|
|
161
|
+
chunkStrategy: 'renderer'
|
|
162
|
+
})
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
For strict custom cuts or component-library tests, disable injection and pass the virtual module explicitly:
|
|
166
|
+
|
|
167
|
+
```ts
|
|
168
|
+
// vite.config.ts
|
|
169
|
+
fileViewerRenderers({ formats: ['pdf'], inject: false, copyAssets: true })
|
|
170
|
+
```
|
|
171
|
+
|
|
102
172
|
```ts
|
|
173
|
+
// Application viewer entry
|
|
103
174
|
import { configuredFileViewerRenderers } from 'virtual:file-viewer-renderers'
|
|
104
175
|
|
|
105
176
|
const options = {
|
|
106
|
-
builtinRenderers: 'none',
|
|
107
177
|
renderers: configuredFileViewerRenderers,
|
|
108
178
|
rendererMode: 'replace'
|
|
109
179
|
}
|
|
@@ -111,10 +181,13 @@ const options = {
|
|
|
111
181
|
|
|
112
182
|
- 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.
|
|
113
183
|
- `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.
|
|
114
|
-
- For the smallest custom bundle, skip presets, install individual renderers such as `@file-viewer/renderer-pdf` or `@file-viewer/renderer-word`, and
|
|
184
|
+
- 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`.
|
|
185
|
+
- `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.
|
|
115
186
|
- `scan:true` detects `fileViewerFormats`, `data-file-viewer-formats`, and upload `accept` hints so development and production builds select matching renderers automatically.
|
|
116
187
|
- `copyAssets:true` copies PDF/CAD/Typst/Archive/Data workers, WASM, and vendor assets for offline and enterprise intranet deployment.
|
|
117
|
-
-
|
|
188
|
+
- `builtinRenderers` remains available for advanced baseline control or historical compatibility. Normal quick starts only need `preset` / `renderers` plus `rendererMode`.
|
|
189
|
+
- 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.
|
|
190
|
+
- `@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.
|
|
118
191
|
|
|
119
192
|
## Shared Options And Events
|
|
120
193
|
|
package/README.md
CHANGED
|
@@ -38,13 +38,21 @@ export function Preview() {
|
|
|
38
38
|
| 框架 | 标准 npm 包 | 入口格式 | GitHub | Gitee | 兼容历史包 |
|
|
39
39
|
| --- | --- | --- | --- | --- | --- |
|
|
40
40
|
| 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` |
|
|
41
|
+
| 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) | 无 |
|
|
41
42
|
| 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` |
|
|
43
|
+
| 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) | 无 |
|
|
42
44
|
| 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` |
|
|
45
|
+
| 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) | 无 |
|
|
43
46
|
| 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) | 无 |
|
|
47
|
+
| 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) | 无 |
|
|
44
48
|
| 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` |
|
|
49
|
+
| 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) | 无 |
|
|
45
50
|
| 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) | 无 |
|
|
51
|
+
| 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) | 无 |
|
|
46
52
|
| 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) | 无 |
|
|
53
|
+
| 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) | 无 |
|
|
47
54
|
| 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) | 无 |
|
|
55
|
+
| 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) | 无 |
|
|
48
56
|
|
|
49
57
|
## 格式支持矩阵
|
|
50
58
|
|
|
@@ -79,10 +87,48 @@ export function Preview() {
|
|
|
79
87
|
|
|
80
88
|
## 工程级按需 renderer 装配
|
|
81
89
|
|
|
82
|
-
一个组件,一行代码,快速集成;真正影响安装体积和首屏包体的是 renderer
|
|
90
|
+
一个组件,一行代码,快速集成;真正影响安装体积和首屏包体的是 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 并复制离线资产。
|
|
83
91
|
|
|
84
92
|
```bash
|
|
85
|
-
npm i @file-viewer/
|
|
93
|
+
npm i @file-viewer/react @file-viewer/preset-office
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
```ts
|
|
97
|
+
import officePreset from '@file-viewer/preset-office'
|
|
98
|
+
|
|
99
|
+
const options = {
|
|
100
|
+
preset: officePreset,
|
|
101
|
+
rendererMode: 'replace'
|
|
102
|
+
}
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
需要组合办公文档与工程图纸等能力时,继续使用同一个 `preset` 字段传数组即可:
|
|
106
|
+
|
|
107
|
+
```ts
|
|
108
|
+
import officePreset from '@file-viewer/preset-office'
|
|
109
|
+
import engineeringPreset from '@file-viewer/preset-engineering'
|
|
110
|
+
|
|
111
|
+
const options = {
|
|
112
|
+
preset: [officePreset, engineeringPreset],
|
|
113
|
+
rendererMode: 'replace'
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
如果只需要少数格式,也可以安装单 renderer 并传给 `options.renderers`:
|
|
118
|
+
|
|
119
|
+
```ts
|
|
120
|
+
import { pdfRenderer } from '@file-viewer/renderer-pdf'
|
|
121
|
+
|
|
122
|
+
const options = {
|
|
123
|
+
renderers: [pdfRenderer],
|
|
124
|
+
rendererMode: 'replace'
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
Vite 项目可以再加插件,插件会免配置发现已安装 preset、注入 virtual module,并按命中格式复制 Worker / WASM / 字体 / vendor 资源:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
npm i -D @file-viewer/vite-plugin
|
|
86
132
|
```
|
|
87
133
|
|
|
88
134
|
```ts
|
|
@@ -91,19 +137,43 @@ import { fileViewerRenderers } from '@file-viewer/vite-plugin'
|
|
|
91
137
|
export default {
|
|
92
138
|
plugins: [
|
|
93
139
|
fileViewerRenderers({
|
|
94
|
-
preset: 'office',
|
|
95
|
-
scan: true,
|
|
96
140
|
copyAssets: true
|
|
141
|
+
// 无需 preset 配置:插件会自动发现已安装的 @file-viewer/preset-office。
|
|
97
142
|
})
|
|
98
143
|
]
|
|
99
144
|
}
|
|
100
145
|
```
|
|
101
146
|
|
|
147
|
+
重度用户需要一次拥有官方 Demo 的完整能力时,直接把 preset 换成全量包;非 Vite 项目继续传 `options.preset`,Vite 配置也保持不变:
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
npm i @file-viewer/react @file-viewer/preset-all
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
需要自定义装配时,再显式配置插件:
|
|
154
|
+
|
|
155
|
+
```ts
|
|
156
|
+
fileViewerRenderers({
|
|
157
|
+
preset: 'auto', // 同时开启源码扫描时,仍自动发现已安装 preset
|
|
158
|
+
scan: true, // 识别 fileViewerFormats、data-file-viewer-formats、accept
|
|
159
|
+
formats: ['pdf'], // 在已安装 preset 之外额外补充精确 renderer
|
|
160
|
+
copyAssets: true,
|
|
161
|
+
chunkStrategy: 'renderer'
|
|
162
|
+
})
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
严格裁剪或组件库内部测试时,可以关闭自动注入并显式传入 virtual module:
|
|
166
|
+
|
|
167
|
+
```ts
|
|
168
|
+
// vite.config.ts
|
|
169
|
+
fileViewerRenderers({ formats: ['pdf'], inject: false, copyAssets: true })
|
|
170
|
+
```
|
|
171
|
+
|
|
102
172
|
```ts
|
|
173
|
+
// 业务组件入口
|
|
103
174
|
import { configuredFileViewerRenderers } from 'virtual:file-viewer-renderers'
|
|
104
175
|
|
|
105
176
|
const options = {
|
|
106
|
-
builtinRenderers: 'none',
|
|
107
177
|
renderers: configuredFileViewerRenderers,
|
|
108
178
|
rendererMode: 'replace'
|
|
109
179
|
}
|
|
@@ -111,10 +181,13 @@ const options = {
|
|
|
111
181
|
|
|
112
182
|
- Vue、React、Svelte、jQuery、Vanilla JS / Pure Web 都传同一份 `options`,只是在各自生态中映射为 props、hook、action、plugin 或 `mountViewer(...)` 参数。
|
|
113
183
|
- `preset-lite` 面向文本、Markdown、代码、图片和音视频;`preset-office` 面向 PDF / Word / Excel / PowerPoint / OFD;`preset-engineering` 面向 CAD / 3D / 绘图 / XMind / Geo / Typst / EDA / Data。
|
|
114
|
-
- 想要最小包体时,可以不用 preset,直接安装 `@file-viewer/renderer-pdf`、`@file-viewer/renderer-word` 等单个 renderer
|
|
184
|
+
- 想要最小包体时,可以不用 preset,直接安装 `@file-viewer/renderer-pdf`、`@file-viewer/renderer-word` 等单个 renderer,并通过 `options.renderers` 手动注入。
|
|
185
|
+
- `fileViewerRenderers()` 或 `fileViewerRenderers({ copyAssets:true })` 会免配置自动发现已安装 preset;如果同时开启 `scan:true`,请使用 `preset:'auto'` 或 `autoPresets:true` 保留 preset 自动发现。
|
|
115
186
|
- `scan:true` 会识别 `fileViewerFormats`、`data-file-viewer-formats` 和上传控件 `accept`,调试与打包时自动选择 renderer。
|
|
116
187
|
- `copyAssets:true` 会复制 PDF/CAD/Typst/Archive/Data 等 worker、WASM 和 vendor 资源,满足离线和企业内网部署。
|
|
117
|
-
-
|
|
188
|
+
- `builtinRenderers` 仍可用于高级基线控制或历史兼容;普通快速接入只需要 `preset` / `renderers` 与 `rendererMode`。
|
|
189
|
+
- 如果打开的是支持矩阵内但未装配的格式,预览器会提示应安装的 preset / renderer;只有真正不在矩阵中的扩展名才提示不支持。
|
|
190
|
+
- `@file-viewer/preset-all` 是全量一键方案,适合 demo、后台运维工具和企业全格式附件中心;普通业务仍建议优先选择更窄的 preset。
|
|
118
191
|
|
|
119
192
|
## 统一参数与事件
|
|
120
193
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@file-viewer/react",
|
|
3
|
-
"version": "2.1.
|
|
3
|
+
"version": "2.1.3",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Standard React component package for Flyfish File Viewer",
|
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
"react": ">=17 <20"
|
|
56
56
|
},
|
|
57
57
|
"dependencies": {
|
|
58
|
-
"@file-viewer/core": "^2.1.
|
|
58
|
+
"@file-viewer/core": "^2.1.3"
|
|
59
59
|
},
|
|
60
60
|
"devDependencies": {
|
|
61
61
|
"@types/react": "^19.2.17",
|