@file-viewer/react - npm Package Compare versions

Comparing version

2.1.25

2.1.26

+2

-2

package.json

		{
		"name": "@file-viewer/react",
		"version": "2.1.25",
		"version": "2.1.26",
		"private": false,
		@@ -58,3 +58,3 @@ "type": "module",
		"dependencies": {
		"@file-viewer/core": "2.1.25"
		"@file-viewer/core": "2.1.26"
		},
		@@ -61,0 +61,0 @@ "devDependencies": {

+7

-4

README.en.md

		@@ -215,3 +215,3 @@ # @file-viewer/react
		\| Vanilla JS / Pure Web `@file-viewer/web` \| `<flyfish-file-viewer>` attributes: `src/url`, `filename/name`, `type`, `size`, `theme`, `toolbar`, `toolbar-position`, `watermark`, `search`, `options`; also supports `mountViewer(...)` \| `viewer-ready`, `viewer-event`, `viewer-state-change`, `viewer-error`, `onEvent`, `onStateChange`, `controller.subscribe()` \| The Custom Element instance exposes the full controller handle; the IIFE script auto-registers it while keeping imperative `mountViewer` and the asset copy CLI. \|
		\| Vue 3 `@file-viewer/vue3` \| `url`, `file`, `options` \| `load-start`, `load-complete`, `unload-start`, `unload-complete`, `operation-before`, `operation-cancel`, `operation-availability-change`, `search-change`, `location-change`, `zoom-change`, `view-state-change` \| Template refs expose `FileViewerExpose`. For `Blob` / `ArrayBuffer`, prefer wrapping it as a named `File` so extension detection stays deterministic. \|
		\| Vue 3 `@file-viewer/vue3` \| `url`, `file`, `options` \| `load-start`, `load-complete`, `unload-start`, `unload-complete`, `operation-before`, `operation-cancel`, `operation-availability-change`, `search-change`, `location-change`, `zoom-change`, `view-state-change`, `theme-change` \| Template refs expose `FileViewerExpose`. For `Blob` / `ArrayBuffer`, prefer wrapping it as a named `File` so extension detection stays deterministic. \|
		\| Vue 2.7 `@file-viewer/vue2.7` \| `url`, `file`, `buffer`, `name`, `filename`, `type`, `size`, `options`, `containerClass`, `containerStyle` \| `viewer-event` / `viewerEvent` \| The component instance exposes the full controller handle. This is the Vue 2.7 line behind the historical `@flyfish-group/file-viewer` package. \|
		@@ -229,3 +229,3 @@ \| Vue 2.6 `@file-viewer/vue2.6` \| Same as Vue 2.7 \| `viewer-event` / `viewerEvent` \| Separate Vue 2.6 build for long-lived applications that cannot move to Vue 2.7. \|
		\| `watermark` \| Text or image watermark with opacity, rotation, gap, size, font, and color controls. \|
		\| `toolbar` \| Controls download, print, HTML export, zoom, toolbar position, and operation-level preflight checks. \|
		\| `toolbar` \| Controls the theme toggle, download, print, HTML export, zoom, item order, toolbar position, and operation-level preflight checks. \|
		\| `search` \| Document search, highlight class names, case sensitivity, whole-word matching, max matches, and debounce. \|
		@@ -285,4 +285,6 @@ \| `ai` \| Text collection, chunk size, and max text length for provenance, location, vectorization, and external AI workflows. \|
		\| `toolbar: false` \| Hides the built-in toolbar without disabling controller APIs such as download, print, export, and zoom. Use this for a fully custom business toolbar. \|
		\| `toolbar: true` \| Uses the default built-in toolbar. Download, print, HTML export, and zoom buttons are still shown only when the active renderer supports them. \|
		\| `toolbar: true` \| Uses the default built-in toolbar. The theme toggle is visible by default; download, print, HTML export, and zoom remain capability-aware. \|
		\| `download` / `print` / `exportHtml` / `zoom` \| Expresses whether the host allows a button. Final availability is still computed from file type, render readiness, export adapter, and zoom provider state. \|
		\| `theme` \| Controls the light/dark toggle and defaults to `true`. A change emits `theme-change`; set it to `false` to hide the button. \|
		\| `order` \| Orders built-in groups with `search`, `zoom`, `download`, `print`, `exportHtml`, and `theme`. Omitted items keep their default relative order. \|
		\| `position` \| `auto`, `top`, `top-center`, or `bottom-right`. The default `auto` floats PDF actions at bottom right and keeps other formats top-right; use `top-center` for a centered top toolbar. \|
		@@ -317,2 +319,3 @@ \| `beforeOperation` \| Toolbar-level preflight that runs after `options.beforeOperation`. Returning `false` or throwing cancels the operation. \|
		\| `operation-availability-change` \| Fires when download, print, HTML export, or zoom support changes for the active format. \|
		\| `theme-change` \| Fires when the built-in control selects light or dark mode. The payload is `light` or `dark`. \|
		\| `search-change` / `location-change` / `zoom-change` / `view-state-change` \| Fires when search matches, document anchors, zoom state, or full view-state snapshots change so host UIs, display screens, and reading-position restore flows can stay in sync. \|
		@@ -341,3 +344,3 @@
		\| CAD / DWG / DXF / DWF \| Configure `options.cad.wasmPath`, `workerUrl`, `dwfWasmUrl`, and `dxfEncoding` for self-hosted or intranet deployment. \|
		\| PDF / DOCX / Excel / PPTX \| Configure `options.pdf.workerUrl`, `options.pdf.cMapUrl`, `options.pdf.wasmUrl`, `options.pdf.standardFontDataUrl`, `options.docx.workerUrl`, `options.docx.workerJsZipUrl`, `options.spreadsheet.workerUrl`, and `options.presentation.workerUrl` / `options.presentation.workerType`; PDF probes the real static worker first and lazy-loads the packaged handler when unavailable; DOCX chooses worker or main-thread parsing automatically, Electron `file://` and other unsafe local protocols fall back without user configuration; Excel defaults to `worker: auto`, enabling Worker automatically for files at or above `workerAutoThreshold`, and header drag column resizing is controlled by `options.spreadsheet.resizableColumns`; PPTX creates a module Worker on demand and can pin the worker URL/type for strict CSP, legacy WebViews, or self-hosted CDNs. \|
		\| PDF / DOCX / Excel / PPTX \| Configure `options.pdf.workerUrl`, `options.pdf.cMapUrl`, `options.pdf.wasmUrl`, `options.pdf.standardFontDataUrl`, `options.pdf.cjkFontFallbackPath`, `options.pdf.identityFontRepair`, `options.docx.workerUrl`, `options.docx.workerJsZipUrl`, `options.spreadsheet.workerUrl`, and `options.presentation.workerUrl` / `options.presentation.workerType`; PDF probes the real static worker first and lazy-loads the packaged handler when unavailable, unembedded CJK fonts fall back to self-hosted Noto Sans SC shards loaded per page, and malformed Identity CJK fonts without ToUnicode are repaired in memory after corrupted text is detected; DOCX chooses worker or main-thread parsing automatically, Electron `file://` and other unsafe local protocols fall back without user configuration; Excel defaults to `worker: auto`, enabling Worker automatically for files at or above `workerAutoThreshold`, and header drag column resizing is controlled by `options.spreadsheet.resizableColumns`; PPTX creates a module Worker on demand and can pin the worker URL/type for strict CSP, legacy WebViews, or self-hosted CDNs. \|
		\| Typst / SQLite / Archive \| Configure Typst compiler/renderer WASM, `data.sqlWasmUrl`, and `archive.workerUrl` / `archive.wasmUrl` as needed; Typst renders through local WASM only and never falls back to a public CDN; Archive decodes legacy GBK/GB18030 ZIP entry names, while RAR, 7z, and encrypted archives still require the libarchive Worker/WASM assets. \|
		@@ -344,0 +347,0 @@ \| Drawing \| Draw.io uses the official diagrams.net offline viewer shipped with viewer assets by default; override `options.drawing.viewerScriptUrl` for custom paths, or set `preferOfficial:false` for the built-in SVG fallback. \|

+7

-4

README.md

		@@ -215,3 +215,3 @@ # @file-viewer/react
		\| Vanilla JS / Pure Web `@file-viewer/web` \| `<flyfish-file-viewer>` 属性 `src/url`、`filename/name`、`type`、`size`、`theme`、`toolbar`、`toolbar-position`、`watermark`、`search`、`options`；也支持 `mountViewer(...)` \| `viewer-ready`、`viewer-event`、`viewer-state-change`、`viewer-error`、`onEvent`、`onStateChange`、`controller.subscribe()` \| Custom Element 实例暴露完整 controller handle；IIFE script 标签会自动注册元素，同时保留 `mountViewer` 命令式挂载和资源复制 CLI。 \|
		\| Vue 3 `@file-viewer/vue3` \| `url`、`file`、`options` \| `load-start`、`load-complete`、`unload-start`、`unload-complete`、`operation-before`、`operation-cancel`、`operation-availability-change`、`search-change`、`location-change`、`zoom-change`、`view-state-change` \| 模板 `ref` 暴露 `FileViewerExpose`；适合声明式接入。`Blob` / `ArrayBuffer` 建议包装成带扩展名的 `File` 后传给 `file`。 \|
		\| Vue 3 `@file-viewer/vue3` \| `url`、`file`、`options` \| `load-start`、`load-complete`、`unload-start`、`unload-complete`、`operation-before`、`operation-cancel`、`operation-availability-change`、`search-change`、`location-change`、`zoom-change`、`view-state-change`、`theme-change` \| 模板 `ref` 暴露 `FileViewerExpose`；适合声明式接入。`Blob` / `ArrayBuffer` 建议包装成带扩展名的 `File` 后传给 `file`。 \|
		\| Vue 2.7 `@file-viewer/vue2.7` \| `url`、`file`、`buffer`、`name`、`filename`、`type`、`size`、`options`、`containerClass`、`containerStyle` \| `viewer-event` / `viewerEvent` \| 组件实例暴露 controller handle 全量方法；适合 Vue 2.7 项目和历史 `@flyfish-group/file-viewer` 平滑升级。 \|
		@@ -229,3 +229,3 @@ \| Vue 2.6 `@file-viewer/vue2.6` \| 同 Vue 2.7 \| `viewer-event` / `viewerEvent` \| 独立 Vue 2.6 构建，不要求业务升级到 Vue 2.7。 \|
		\| `watermark` \| 开启文字或图片水印，可设置透明度、旋转、间距、尺寸、字体和颜色。 \|
		\| `toolbar` \| 控制下载、打印、HTML 导出、缩放和工具栏位置，并支持操作级前置校验。 \|
		\| `toolbar` \| 控制主题切换、下载、打印、HTML 导出、缩放、按钮顺序和工具栏位置，并支持操作级前置校验。 \|
		\| `search` \| 配置文档搜索、高亮 class、大小写、整词匹配、最大命中数和 debounce。 \|
		@@ -285,4 +285,6 @@ \| `ai` \| 控制文本结构采集、分块大小和最大文本长度，为溯源、定位、向量化和外部 AI 流程提供基础。 \|
		\| `toolbar: false` \| 隐藏内置工具栏，但不关闭下载、打印、导出、缩放等 controller API，适合完全自定义业务工具栏。 \|
		\| `toolbar: true` \| 使用默认内置工具栏，下载、打印、HTML 导出和缩放按钮都会按能力动态显隐。 \|
		\| `toolbar: true` \| 使用默认内置工具栏；主题切换默认显示，下载、打印、HTML 导出和缩放按钮按能力动态显隐。 \|
		\| `download` / `print` / `exportHtml` / `zoom` \| 表达业务是否允许展示对应按钮；最终仍会结合文件类型、渲染完成状态、导出适配器和缩放 provider 计算真实可用性。 \|
		\| `theme` \| 控制浅色/深色切换按钮，默认 `true`；切换后触发 `theme-change`，传 `false` 可隐藏。 \|
		\| `order` \| 设置内置分组顺序，可使用 `search`、`zoom`、`download`、`print`、`exportHtml`、`theme`；遗漏项保持默认相对顺序。 \|
		\| `position` \| `auto`、`top`、`top-center`、`bottom-right`。默认 `auto`，PDF 自动悬浮右下角，其他格式保持顶部靠右；需要顶部水平居中时传 `top-center`。 \|
		@@ -317,2 +319,3 @@ \| `beforeOperation` \| 工具栏层统一前置校验，会在 `options.beforeOperation` 后执行。返回 `false` 或抛错都会取消本次操作。 \|
		\| `operation-availability-change` \| 当前格式是否可下载、可打印、可导出 HTML、可缩放发生变化时触发。 \|
		\| `theme-change` \| 用户通过内置按钮切换浅色或深色模式时触发，payload 为 `light` 或 `dark`。 \|
		\| `search-change` / `location-change` / `zoom-change` / `view-state-change` \| 搜索命中、定位锚点、缩放状态和完整视图快照变化时触发，用于外层同步 UI、投屏或恢复阅读进度。 \|
		@@ -341,3 +344,3 @@
		\| CAD / DWG / DXF / DWF \| 按需配置 `options.cad.wasmPath`、`workerUrl`、`dwfWasmUrl`、`dxfEncoding`，支持自托管和内网部署。 \|
		\| PDF / DOCX / Excel / PPTX \| 按需配置 `options.pdf.workerUrl`、`options.pdf.cMapUrl`、`options.pdf.wasmUrl`、`options.pdf.standardFontDataUrl`、`options.docx.workerUrl`、`options.docx.workerJsZipUrl`、`options.spreadsheet.workerUrl`、`options.presentation.workerUrl` / `options.presentation.workerType`；PDF 默认探测真实静态 Worker，不可用时懒加载包内 handler 兜底；DOCX 默认自动选择 Worker 或主线程解析，Electron `file://` 等本地不安全协议会自动回退；Excel 默认 `worker: auto`，大文件达到 `workerAutoThreshold` 自动启用 Worker，列宽拖拽可通过 `options.spreadsheet.resizableColumns` 显式开启；PPTX 默认按需创建模块 Worker，严格 CSP、旧 WebView 或自托管 CDN 场景可固定 Worker 地址。 \|
		\| PDF / DOCX / Excel / PPTX \| 按需配置 `options.pdf.workerUrl`、`options.pdf.cMapUrl`、`options.pdf.wasmUrl`、`options.pdf.standardFontDataUrl`、`options.pdf.cjkFontFallbackPath`、`options.pdf.identityFontRepair`、`options.docx.workerUrl`、`options.docx.workerJsZipUrl`、`options.spreadsheet.workerUrl`、`options.presentation.workerUrl` / `options.presentation.workerType`；PDF 默认探测真实静态 Worker，不可用时懒加载包内 handler 兜底，未嵌入的中文字体默认按页加载本地 Noto Sans SC 分片回退，缺失 ToUnicode 的异常 Identity CJK 字体会在检测到乱码后尝试内存修复；DOCX 默认自动选择 Worker 或主线程解析，Electron `file://` 等本地不安全协议会自动回退；Excel 默认 `worker: auto`，大文件达到 `workerAutoThreshold` 自动启用 Worker，列宽拖拽可通过 `options.spreadsheet.resizableColumns` 显式开启；PPTX 默认按需创建模块 Worker，严格 CSP、旧 WebView 或自托管 CDN 场景可固定 Worker 地址。 \|
		\| Typst / SQLite / Archive \| 按需配置 Typst compiler/renderer WASM、`data.sqlWasmUrl`、`archive.workerUrl` / `archive.wasmUrl`；Typst 仅使用本地 WASM 真实渲染，不访问公共 CDN；Archive 兼容 GBK/GB18030 旧 ZIP 中文文件名，RAR、7z 和加密压缩包仍需要 libarchive Worker/WASM。 \|
		@@ -344,0 +347,0 @@ \| Drawing \| Draw.io 默认使用随 viewer assets 分发的官方 diagrams.net 离线 viewer；路径特殊时可通过 `options.drawing.viewerScriptUrl` 覆盖，`preferOfficial:false` 才切到内置 SVG 兜底。 \|

		@@ -215,3 +215,3 @@ # @file-viewer/react
		\| Vanilla JS / Pure Web `@file-viewer/web` \| `<flyfish-file-viewer>` attributes: `src/url`, `filename/name`, `type`, `size`, `theme`, `toolbar`, `toolbar-position`, `watermark`, `search`, `options`; also supports `mountViewer(...)` \| `viewer-ready`, `viewer-event`, `viewer-state-change`, `viewer-error`, `onEvent`, `onStateChange`, `controller.subscribe()` \| The Custom Element instance exposes the full controller handle; the IIFE script auto-registers it while keeping imperative `mountViewer` and the asset copy CLI. \|
		\| Vue 3 `@file-viewer/vue3` \| `url`, `file`, `options` \| `load-start`, `load-complete`, `unload-start`, `unload-complete`, `operation-before`, `operation-cancel`, `operation-availability-change`, `search-change`, `location-change`, `zoom-change`, `view-state-change` \| Template refs expose `FileViewerExpose`. For `Blob` / `ArrayBuffer`, prefer wrapping it as a named `File` so extension detection stays deterministic. \|
		\| Vue 3 `@file-viewer/vue3` \| `url`, `file`, `options` \| `load-start`, `load-complete`, `unload-start`, `unload-complete`, `operation-before`, `operation-cancel`, `operation-availability-change`, `search-change`, `location-change`, `zoom-change`, `view-state-change`, `theme-change` \| Template refs expose `FileViewerExpose`. For `Blob` / `ArrayBuffer`, prefer wrapping it as a named `File` so extension detection stays deterministic. \|
		\| Vue 2.7 `@file-viewer/vue2.7` \| `url`, `file`, `buffer`, `name`, `filename`, `type`, `size`, `options`, `containerClass`, `containerStyle` \| `viewer-event` / `viewerEvent` \| The component instance exposes the full controller handle. This is the Vue 2.7 line behind the historical `@flyfish-group/file-viewer` package. \|
		@@ -229,3 +229,3 @@ \| Vue 2.6 `@file-viewer/vue2.6` \| Same as Vue 2.7 \| `viewer-event` / `viewerEvent` \| Separate Vue 2.6 build for long-lived applications that cannot move to Vue 2.7. \|
		\| `watermark` \| Text or image watermark with opacity, rotation, gap, size, font, and color controls. \|
		\| `toolbar` \| Controls download, print, HTML export, zoom, toolbar position, and operation-level preflight checks. \|
		\| `toolbar` \| Controls the theme toggle, download, print, HTML export, zoom, item order, toolbar position, and operation-level preflight checks. \|
		\| `search` \| Document search, highlight class names, case sensitivity, whole-word matching, max matches, and debounce. \|
		@@ -285,4 +285,6 @@ \| `ai` \| Text collection, chunk size, and max text length for provenance, location, vectorization, and external AI workflows. \|
		\| `toolbar: false` \| Hides the built-in toolbar without disabling controller APIs such as download, print, export, and zoom. Use this for a fully custom business toolbar. \|
		\| `toolbar: true` \| Uses the default built-in toolbar. Download, print, HTML export, and zoom buttons are still shown only when the active renderer supports them. \|
		\| `toolbar: true` \| Uses the default built-in toolbar. The theme toggle is visible by default; download, print, HTML export, and zoom remain capability-aware. \|
		\| `download` / `print` / `exportHtml` / `zoom` \| Expresses whether the host allows a button. Final availability is still computed from file type, render readiness, export adapter, and zoom provider state. \|
		\| `theme` \| Controls the light/dark toggle and defaults to `true`. A change emits `theme-change`; set it to `false` to hide the button. \|
		\| `order` \| Orders built-in groups with `search`, `zoom`, `download`, `print`, `exportHtml`, and `theme`. Omitted items keep their default relative order. \|
		\| `position` \| `auto`, `top`, `top-center`, or `bottom-right`. The default `auto` floats PDF actions at bottom right and keeps other formats top-right; use `top-center` for a centered top toolbar. \|
		@@ -317,2 +319,3 @@ \| `beforeOperation` \| Toolbar-level preflight that runs after `options.beforeOperation`. Returning `false` or throwing cancels the operation. \|
		\| `operation-availability-change` \| Fires when download, print, HTML export, or zoom support changes for the active format. \|
		\| `theme-change` \| Fires when the built-in control selects light or dark mode. The payload is `light` or `dark`. \|
		\| `search-change` / `location-change` / `zoom-change` / `view-state-change` \| Fires when search matches, document anchors, zoom state, or full view-state snapshots change so host UIs, display screens, and reading-position restore flows can stay in sync. \|
		@@ -341,3 +344,3 @@
		\| CAD / DWG / DXF / DWF \| Configure `options.cad.wasmPath`, `workerUrl`, `dwfWasmUrl`, and `dxfEncoding` for self-hosted or intranet deployment. \|
		\| PDF / DOCX / Excel / PPTX \| Configure `options.pdf.workerUrl`, `options.pdf.cMapUrl`, `options.pdf.wasmUrl`, `options.pdf.standardFontDataUrl`, `options.docx.workerUrl`, `options.docx.workerJsZipUrl`, `options.spreadsheet.workerUrl`, and `options.presentation.workerUrl` / `options.presentation.workerType`; PDF probes the real static worker first and lazy-loads the packaged handler when unavailable; DOCX chooses worker or main-thread parsing automatically, Electron `file://` and other unsafe local protocols fall back without user configuration; Excel defaults to `worker: auto`, enabling Worker automatically for files at or above `workerAutoThreshold`, and header drag column resizing is controlled by `options.spreadsheet.resizableColumns`; PPTX creates a module Worker on demand and can pin the worker URL/type for strict CSP, legacy WebViews, or self-hosted CDNs. \|
		\| PDF / DOCX / Excel / PPTX \| Configure `options.pdf.workerUrl`, `options.pdf.cMapUrl`, `options.pdf.wasmUrl`, `options.pdf.standardFontDataUrl`, `options.pdf.cjkFontFallbackPath`, `options.pdf.identityFontRepair`, `options.docx.workerUrl`, `options.docx.workerJsZipUrl`, `options.spreadsheet.workerUrl`, and `options.presentation.workerUrl` / `options.presentation.workerType`; PDF probes the real static worker first and lazy-loads the packaged handler when unavailable, unembedded CJK fonts fall back to self-hosted Noto Sans SC shards loaded per page, and malformed Identity CJK fonts without ToUnicode are repaired in memory after corrupted text is detected; DOCX chooses worker or main-thread parsing automatically, Electron `file://` and other unsafe local protocols fall back without user configuration; Excel defaults to `worker: auto`, enabling Worker automatically for files at or above `workerAutoThreshold`, and header drag column resizing is controlled by `options.spreadsheet.resizableColumns`; PPTX creates a module Worker on demand and can pin the worker URL/type for strict CSP, legacy WebViews, or self-hosted CDNs. \|
		\| Typst / SQLite / Archive \| Configure Typst compiler/renderer WASM, `data.sqlWasmUrl`, and `archive.workerUrl` / `archive.wasmUrl` as needed; Typst renders through local WASM only and never falls back to a public CDN; Archive decodes legacy GBK/GB18030 ZIP entry names, while RAR, 7z, and encrypted archives still require the libarchive Worker/WASM assets. \|
		@@ -344,0 +347,0 @@ \| Drawing \| Draw.io uses the official diagrams.net offline viewer shipped with viewer assets by default; override `options.drawing.viewerScriptUrl` for custom paths, or set `preferOfficial:false` for the built-in SVG fallback. \|

		@@ -215,3 +215,3 @@ # @file-viewer/react
		\| Vanilla JS / Pure Web `@file-viewer/web` \| `<flyfish-file-viewer>` 属性 `src/url`、`filename/name`、`type`、`size`、`theme`、`toolbar`、`toolbar-position`、`watermark`、`search`、`options`；也支持 `mountViewer(...)` \| `viewer-ready`、`viewer-event`、`viewer-state-change`、`viewer-error`、`onEvent`、`onStateChange`、`controller.subscribe()` \| Custom Element 实例暴露完整 controller handle；IIFE script 标签会自动注册元素，同时保留 `mountViewer` 命令式挂载和资源复制 CLI。 \|
		\| Vue 3 `@file-viewer/vue3` \| `url`、`file`、`options` \| `load-start`、`load-complete`、`unload-start`、`unload-complete`、`operation-before`、`operation-cancel`、`operation-availability-change`、`search-change`、`location-change`、`zoom-change`、`view-state-change` \| 模板 `ref` 暴露 `FileViewerExpose`；适合声明式接入。`Blob` / `ArrayBuffer` 建议包装成带扩展名的 `File` 后传给 `file`。 \|
		\| Vue 3 `@file-viewer/vue3` \| `url`、`file`、`options` \| `load-start`、`load-complete`、`unload-start`、`unload-complete`、`operation-before`、`operation-cancel`、`operation-availability-change`、`search-change`、`location-change`、`zoom-change`、`view-state-change`、`theme-change` \| 模板 `ref` 暴露 `FileViewerExpose`；适合声明式接入。`Blob` / `ArrayBuffer` 建议包装成带扩展名的 `File` 后传给 `file`。 \|
		\| Vue 2.7 `@file-viewer/vue2.7` \| `url`、`file`、`buffer`、`name`、`filename`、`type`、`size`、`options`、`containerClass`、`containerStyle` \| `viewer-event` / `viewerEvent` \| 组件实例暴露 controller handle 全量方法；适合 Vue 2.7 项目和历史 `@flyfish-group/file-viewer` 平滑升级。 \|
		@@ -229,3 +229,3 @@ \| Vue 2.6 `@file-viewer/vue2.6` \| 同 Vue 2.7 \| `viewer-event` / `viewerEvent` \| 独立 Vue 2.6 构建，不要求业务升级到 Vue 2.7。 \|
		\| `watermark` \| 开启文字或图片水印，可设置透明度、旋转、间距、尺寸、字体和颜色。 \|
		\| `toolbar` \| 控制下载、打印、HTML 导出、缩放和工具栏位置，并支持操作级前置校验。 \|
		\| `toolbar` \| 控制主题切换、下载、打印、HTML 导出、缩放、按钮顺序和工具栏位置，并支持操作级前置校验。 \|
		\| `search` \| 配置文档搜索、高亮 class、大小写、整词匹配、最大命中数和 debounce。 \|
		@@ -285,4 +285,6 @@ \| `ai` \| 控制文本结构采集、分块大小和最大文本长度，为溯源、定位、向量化和外部 AI 流程提供基础。 \|
		\| `toolbar: false` \| 隐藏内置工具栏，但不关闭下载、打印、导出、缩放等 controller API，适合完全自定义业务工具栏。 \|
		\| `toolbar: true` \| 使用默认内置工具栏，下载、打印、HTML 导出和缩放按钮都会按能力动态显隐。 \|
		\| `toolbar: true` \| 使用默认内置工具栏；主题切换默认显示，下载、打印、HTML 导出和缩放按钮按能力动态显隐。 \|
		\| `download` / `print` / `exportHtml` / `zoom` \| 表达业务是否允许展示对应按钮；最终仍会结合文件类型、渲染完成状态、导出适配器和缩放 provider 计算真实可用性。 \|
		\| `theme` \| 控制浅色/深色切换按钮，默认 `true`；切换后触发 `theme-change`，传 `false` 可隐藏。 \|
		\| `order` \| 设置内置分组顺序，可使用 `search`、`zoom`、`download`、`print`、`exportHtml`、`theme`；遗漏项保持默认相对顺序。 \|
		\| `position` \| `auto`、`top`、`top-center`、`bottom-right`。默认 `auto`，PDF 自动悬浮右下角，其他格式保持顶部靠右；需要顶部水平居中时传 `top-center`。 \|
		@@ -317,2 +319,3 @@ \| `beforeOperation` \| 工具栏层统一前置校验，会在 `options.beforeOperation` 后执行。返回 `false` 或抛错都会取消本次操作。 \|
		\| `operation-availability-change` \| 当前格式是否可下载、可打印、可导出 HTML、可缩放发生变化时触发。 \|
		\| `theme-change` \| 用户通过内置按钮切换浅色或深色模式时触发，payload 为 `light` 或 `dark`。 \|
		\| `search-change` / `location-change` / `zoom-change` / `view-state-change` \| 搜索命中、定位锚点、缩放状态和完整视图快照变化时触发，用于外层同步 UI、投屏或恢复阅读进度。 \|
		@@ -341,3 +344,3 @@
		\| CAD / DWG / DXF / DWF \| 按需配置 `options.cad.wasmPath`、`workerUrl`、`dwfWasmUrl`、`dxfEncoding`，支持自托管和内网部署。 \|
		\| PDF / DOCX / Excel / PPTX \| 按需配置 `options.pdf.workerUrl`、`options.pdf.cMapUrl`、`options.pdf.wasmUrl`、`options.pdf.standardFontDataUrl`、`options.docx.workerUrl`、`options.docx.workerJsZipUrl`、`options.spreadsheet.workerUrl`、`options.presentation.workerUrl` / `options.presentation.workerType`；PDF 默认探测真实静态 Worker，不可用时懒加载包内 handler 兜底；DOCX 默认自动选择 Worker 或主线程解析，Electron `file://` 等本地不安全协议会自动回退；Excel 默认 `worker: auto`，大文件达到 `workerAutoThreshold` 自动启用 Worker，列宽拖拽可通过 `options.spreadsheet.resizableColumns` 显式开启；PPTX 默认按需创建模块 Worker，严格 CSP、旧 WebView 或自托管 CDN 场景可固定 Worker 地址。 \|
		\| PDF / DOCX / Excel / PPTX \| 按需配置 `options.pdf.workerUrl`、`options.pdf.cMapUrl`、`options.pdf.wasmUrl`、`options.pdf.standardFontDataUrl`、`options.pdf.cjkFontFallbackPath`、`options.pdf.identityFontRepair`、`options.docx.workerUrl`、`options.docx.workerJsZipUrl`、`options.spreadsheet.workerUrl`、`options.presentation.workerUrl` / `options.presentation.workerType`；PDF 默认探测真实静态 Worker，不可用时懒加载包内 handler 兜底，未嵌入的中文字体默认按页加载本地 Noto Sans SC 分片回退，缺失 ToUnicode 的异常 Identity CJK 字体会在检测到乱码后尝试内存修复；DOCX 默认自动选择 Worker 或主线程解析，Electron `file://` 等本地不安全协议会自动回退；Excel 默认 `worker: auto`，大文件达到 `workerAutoThreshold` 自动启用 Worker，列宽拖拽可通过 `options.spreadsheet.resizableColumns` 显式开启；PPTX 默认按需创建模块 Worker，严格 CSP、旧 WebView 或自托管 CDN 场景可固定 Worker 地址。 \|
		\| Typst / SQLite / Archive \| 按需配置 Typst compiler/renderer WASM、`data.sqlWasmUrl`、`archive.workerUrl` / `archive.wasmUrl`；Typst 仅使用本地 WASM 真实渲染，不访问公共 CDN；Archive 兼容 GBK/GB18030 旧 ZIP 中文文件名，RAR、7z 和加密压缩包仍需要 libarchive Worker/WASM。 \|
		@@ -344,0 +347,0 @@ \| Drawing \| Draw.io 默认使用随 viewer assets 分发的官方 diagrams.net 离线 viewer；路径特殊时可通过 `options.drawing.viewerScriptUrl` 覆盖，`preferOfficial:false` 才切到内置 SVG 兜底。 \|

@file-viewer/react - npm Package Compare versions

Improved metrics

Dependency changes