
Research
/Security News
Popular Rust Crates Compromised in Build-Time Supply Chain Attack
Three compromised Rust crates pulled in a malicious dependency that downloaded and executed cross-platform malware during Cargo builds.
@file-viewer/react
Advanced tools
标准 React native 组件包。组件渲染一个 React 容器,并通过本包本地 controller 调用 @file-viewer/core 与 core browser engine 挂载完整预览器;同时提供 ref API、受控参数、生命周期事件和完整预览 options。
npm install @file-viewer/react
import FileViewer from '@file-viewer/react'
export function Preview() {
return (
<div style={{ height: '100vh' }}>
<FileViewer
url="/example/demo.docx"
options={{
theme: 'light',
toolbar: { position: 'bottom-right' }
}}
/>
</div>
)
}
历史包名 @flyfish-group/file-viewer-react 会继续同步维护;新项目建议优先使用自包含的标准包 @file-viewer/react。English README: README.en.md。
@file-viewer/react 与其他标准组件包共享同一套 core 接口和 renderer/preset 装配模型;完整能力可通过按需 renderer 或 @file-viewer/preset-all 覆盖 PDF、Word、Excel、PPT、OFD、CAD/DWG/DXF/DWF、EPUB/UMD、压缩包、邮件、Markdown、代码高亮、图片、音频、视频、3D 模型、地理数据和结构化数据资产等预览链路。完整格式矩阵和参数说明见官方文档: https://doc.file-viewer.app/guide/formats
所有标准组件包都只共享 @file-viewer/core 这个总底座,不依赖其他框架组件实现。core 负责格式矩阵、资源解析、renderer 协议、事件、操作 API、搜索、缩放、打印和导出;PDF、Word、PPTX、CAD、Typst 等重型链路通过独立 renderer 或 preset 显式装配;各框架组件包自己维护本地 controller、组件生命周期、类型出口和生态交互。
| 框架 | 标准 npm 包 | 入口格式 | GitHub | Gitee | 兼容历史包 |
|---|---|---|---|---|---|
| Vanilla JS / Pure Web | @file-viewer/web | ESM, 类型声明, script 标签 IIFE, Worker/WASM viewer 资源, 复制静态资源 CLI | file-viewer-web | file-viewer-web | @flyfish-group/file-viewer-web |
| Vanilla JS / Pure Web Full | @file-viewer/web-full | ESM, 类型声明, script 标签 IIFE | file-viewer-web-full | file-viewer-web-full | 无 |
| Vue 3 | @file-viewer/vue3 | ESM, 类型声明 | file-viewer-vue3 | file-viewer-vue3 | @flyfish-group/file-viewer3, file-viewer3 |
| Vue 3 Full | @file-viewer/vue3-full | ESM, 类型声明 | file-viewer-vue3-full | file-viewer-vue3-full | 无 |
| Vue 2.7 | @file-viewer/vue2.7 | ESM, 类型声明 | file-viewer-vue2.7 | file-viewer-vue2.7 | @flyfish-group/file-viewer |
| Vue 2.7 Full | @file-viewer/vue2.7-full | ESM, 类型声明 | file-viewer-vue2.7-full | file-viewer-vue2.7-full | 无 |
| Vue 2.6 | @file-viewer/vue2.6 | ESM, 类型声明 | file-viewer-vue2.6 | file-viewer-vue2.6 | 无 |
| Vue 2.6 Full | @file-viewer/vue2.6-full | ESM, 类型声明 | file-viewer-vue2.6-full | file-viewer-vue2.6-full | 无 |
| React 18/19 | @file-viewer/react | ESM, 类型声明 | file-viewer-react | file-viewer-react | @flyfish-group/file-viewer-react |
| React 18/19 Full | @file-viewer/react-full | ESM, 类型声明 | file-viewer-react-full | file-viewer-react-full | 无 |
| React 16.8/17 | @file-viewer/react-legacy | ESM, 类型声明 | file-viewer-react-legacy | file-viewer-react-legacy | 无 |
| React 16.8/17 Full | @file-viewer/react-legacy-full | ESM, 类型声明 | file-viewer-react-legacy-full | file-viewer-react-legacy-full | 无 |
| jQuery | @file-viewer/jquery | ESM, 类型声明 | file-viewer-jquery | file-viewer-jquery | 无 |
| jQuery Full | @file-viewer/jquery-full | ESM, 类型声明 | file-viewer-jquery-full | file-viewer-jquery-full | 无 |
| Svelte | @file-viewer/svelte | Svelte 组件, ESM, 类型声明 | file-viewer-svelte | file-viewer-svelte | 无 |
| Svelte Full | @file-viewer/svelte-full | Svelte 组件, ESM, 类型声明 | file-viewer-svelte-full | file-viewer-svelte-full | 无 |
共享格式矩阵当前覆盖 24 条预览链路、206 个扩展名。完整能力通过 renderer / preset 按需装配,组件层只做生态适配,不互相嵌套。
| 预览链路 | 分类 | 扩展名 | 能力 | 加载 |
|---|---|---|---|---|
| Word OpenXML | office | .docx, .docm, .dotx, .dotm | 下载, 打印(适配器), HTML(适配器), 缩放(Provider), 搜索 | 按需异步 |
| Word Binary | office | .doc, .dot | 下载, 打印(适配器), HTML(适配器), 缩放(Provider), 搜索 | 按需异步 |
| PowerPoint | office | .pptx, .pptm, .potx, .potm, .ppsx, .ppsm | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Open Document | office | .rtf, .odt, .odp | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Spreadsheet | office | .xlsx, .xltx, .xlsm, .xlsb, .xls, .xlt, .xltm, .csv, .ods, .fods, .numbers | 下载, 缩放(Provider), 搜索 | 按需异步 |
| document | .pdf | 下载, 打印(适配器), HTML(适配器), 缩放(Provider), 搜索(Provider) | 按需异步 | |
| OFD | document | .ofd | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Typst | document | .typ, .typst | 下载, 打印(适配器), HTML(适配器), 缩放(Provider), 搜索 | 按需异步 |
| Archive | archive | .zip, .zipx, .7z, .rar, .tar, .gz, .gzip, .tgz, .bz2, .bzip2, .tbz, .tbz2, .xz, .txz, .lzma, .zst, .tzst, .cab, .ar, .cpio, .iso, .xar, .lha, .lzh, .jar, .war, .ear, .apk, .cbz, .cbr | 下载, 搜索 | 按需异步 |
.eml, .msg, .mbox | 下载, HTML, 搜索 | 按需异步 | ||
| EDA | eda | .olb, .dra, .gds, .oas, .oasis | 下载, 打印, HTML, 搜索 | 按需异步 |
| CAD | cad | .dxf, .dwg, .dwf, .dwfx, .xps | 下载, 打印, HTML, 缩放(Provider) | 按需异步 |
| 3D Model | model | .glb, .gltf, .obj, .stl, .ply, .fbx, .dae, .3ds, .3mf, .amf, .usd, .usda, .usdc, .usdz, .kmz, .step, .stp, .iges, .igs, .ifc, .3dm, .brep, .pcd, .wrl, .vrml, .xyz, .vtk, .vtp | 下载, 缩放(Provider) | 按需异步 |
| Geospatial | geo | .geojson, .kml, .gpx, .shp | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Drawing | drawing | .excalidraw, .drawio, .dio, .mermaid, .mmd, .plantuml, .puml | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Mind Map | mindmap | .xmind | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| EPUB | ebook | .epub | 下载, HTML, 搜索(Provider) | 按需异步 |
| UMD | ebook | .umd | 下载, 打印, HTML, 缩放(Provider), 搜索 | 按需异步 |
| Image | image | .gif, .jpg, .jpeg, .bmp, .tiff, .tif, .png, .svg, .webp, .avif, .ico, .heic, .heif, .jxl | 下载, 打印, HTML, 缩放(Provider) | 按需异步 |
| Markdown | markdown | .md, .markdown | 下载, 打印, HTML, 搜索 | 按需异步 |
| Code and Text | code | .txt, .json, .js, .mjs, .cjs, .css, .java, .py, .html, .htm, .jsx, .ts, .tsx, .xml, .log, .vue, .yaml, .yml, .ini, .sh, .bash, .sql, .go, .rs, .php, .c, .cpp, .cc, .h, .hpp, .cs, .diff, .patch, .bundle, .bdl, .jsonc, .json5, .ipynb, .toml, .proto, .hcl, .tex, .gv, .http, .react, .rb, .swift, .kt | 下载, 打印, HTML, 搜索 | 按需异步 |
| Video | media | .mp4, .webm, .m3u8 | 下载 | 按需异步 |
| Audio | media | .mp3, .mpeg, .wav, .ogg, .oga, .opus, .m4a, .aac, .flac, .weba, .midi, .mid | 下载 | 按需异步 |
| Data Asset | asset | .ttf, .otf, .woff, .woff2, .psd, .ai, .eps, .sqlite, .wasm, .parquet, .avro, .webarchive | 下载, HTML, 搜索 | 按需异步 |
快速开始的核心是先跑通组件,再明确格式能力边界。推荐先安装当前生态组件包,再按产品形态选择 @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 并复制离线资产。
npm i @file-viewer/react @file-viewer/preset-office
import officePreset from '@file-viewer/preset-office'
const options = {
preset: officePreset,
rendererMode: 'replace'
}
需要组合办公文档与工程图纸等能力时,继续使用同一个 preset 字段传数组即可:
import officePreset from '@file-viewer/preset-office'
import engineeringPreset from '@file-viewer/preset-engineering'
const options = {
preset: [officePreset, engineeringPreset],
rendererMode: 'replace'
}
如果只需要少数格式,也可以安装单 renderer 并传给 options.renderers:
import { pdfRenderer } from '@file-viewer/renderer-pdf'
const options = {
renderers: [pdfRenderer],
rendererMode: 'replace'
}
Vite 项目可以再加插件,插件会免配置发现已安装 preset、注入 virtual module,并按命中格式复制 Worker / WASM / 字体 / vendor 资源:
npm i -D @file-viewer/vite-plugin
import { fileViewerRenderers } from '@file-viewer/vite-plugin'
export default {
plugins: [
fileViewerRenderers({
copyAssets: true
// 无需 preset 配置:插件会自动发现已安装的 @file-viewer/preset-office。
})
]
}
重度用户需要一次拥有官方 Demo 的完整能力时,直接把 preset 换成全量包;非 Vite 项目继续传 options.preset,Vite 配置也保持不变:
npm i @file-viewer/react @file-viewer/preset-all
需要自定义装配时,再显式配置插件:
fileViewerRenderers({
preset: 'auto', // 同时开启源码扫描时,仍自动发现已安装 preset
scan: true, // 识别 fileViewerFormats、data-file-viewer-formats、accept
formats: ['pdf'], // 在已安装 preset 之外额外补充精确 renderer
copyAssets: true,
chunkStrategy: 'renderer'
})
严格裁剪或组件库内部测试时,可以关闭自动注入并显式传入 virtual module:
// vite.config.ts
fileViewerRenderers({ formats: ['pdf'], inject: false, copyAssets: true })
// 业务组件入口
import { configuredFileViewerRenderers } from 'virtual:file-viewer-renderers'
const options = {
renderers: configuredFileViewerRenderers,
rendererMode: 'replace'
}
options,只是在各自生态中映射为 props、hook、action、plugin 或 mountViewer(...) 参数。preset-lite 面向文本、Markdown、代码、图片和音视频;preset-office 面向 PDF / Word / Excel / PowerPoint / OFD;preset-engineering 面向 CAD / 3D / 绘图 / XMind / Geo / Typst / EDA / Data。@file-viewer/renderer-pdf、@file-viewer/renderer-word 等单个 renderer,并通过 options.renderers 手动注入。fileViewerRenderers() 或 fileViewerRenderers({ copyAssets:true }) 会免配置自动发现已安装 preset;如果同时开启 scan:true,请使用 preset:'auto' 或 autoPresets:true 保留 preset 自动发现。scan:true 会识别 fileViewerFormats、data-file-viewer-formats 和上传控件 accept,调试与打包时自动选择 renderer。copyAssets:true 会复制 PDF/CAD/Typst/Archive/Data 等 worker、WASM 和 vendor 资源,满足离线和企业内网部署。builtinRenderers 仍可用于高级基线控制或历史兼容;普通快速接入只需要 preset / renderers 与 rendererMode。@file-viewer/preset-all 是全量一键方案,适合 demo、后台运维工具和企业全格式附件中心;普通业务仍建议优先选择更窄的 preset。所有生态组件都围绕同一套 ViewerMountOptions 与 FileViewerOptions 工作,只是映射到各自框架的 props、事件、ref、action 或插件 API。
| 参数 | 说明 |
|---|---|
url | 远程文件地址,适合对象存储、业务接口或内网文件服务返回的文件链接。 |
file | File、Blob 或 ArrayBuffer,适合上传、本地选择和业务接口已取回的二进制。 |
buffer | 直接传入 ArrayBuffer,适合解密、鉴权或自定义下载后再预览。 |
name / filename | 显示文件名并辅助推断扩展名;当 URL 不含扩展名时建议显式传入。 |
type | 显式指定扩展名或 MIME 线索,覆盖自动识别结果。 |
size | 文件大小提示,用于生命周期上下文、加载状态和安全限制展示。 |
options | 完整 FileViewerOptions,所有框架包保持同一套参数语义。 |
onEvent / onStateChange | Vanilla JS / Pure Web、React、Svelte 等命令式包装层的统一事件和状态订阅;Vue 组件会映射为原生 emit。 |
下面列的是每个标准组件包当前真实暴露的属性、事件和控制入口。需要 buffer、name、type、size 这类命令式挂载参数时,优先选择 Vanilla JS / Pure Web、React、Svelte、jQuery 或 Vue2 组件;Vue3 声明式组件保持 url / file / options 的简洁入口,复杂二进制来源请包装成带文件名的 File。
| 组件 | 实际属性 / 入口 | 事件入口 | 定制入口 |
|---|---|---|---|
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 | 模板 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 平滑升级。 |
Vue 2.6 @file-viewer/vue2.6 | 同 Vue 2.7 | viewer-event / viewerEvent | 独立 Vue 2.6 构建,不要求业务升级到 Vue 2.7。 |
React @file-viewer/react | ViewerMountOptions + div 原生属性,如 className、style、data-*、aria-* | onEvent、onStateChange | ref 暴露 FileViewerHandle;useFileViewer() 会返回 ref、props、state、handle,便于自定义工具栏。 |
React Legacy @file-viewer/react-legacy | 同 React 标准包 | onEvent、onStateChange | 面向 React 16.8 / 17;组件名和默认导出保持 legacy 生态友好。 |
jQuery @file-viewer/jquery | $(el).fileViewer(ViewerMountOptions & { replace?: boolean }) | onEvent、onStateChange 或 getFileViewerController(el).subscribe() | 插件方法支持 zoomIn、printRenderedHtml、searchDocument 等;replace:false 可在同一节点上原地更新。 |
Svelte @file-viewer/svelte | ViewerMountOptions + className、containerStyle | on:viewerEvent、onEvent、onStateChange | bind:this 暴露 controller handle;也提供 use:fileViewer action,action 额外支持 replace。 |
| Options 字段 | 说明 |
|---|---|
theme | light、dark 或 system,优先级高于浏览器 prefers-color-scheme。 |
watermark | 开启文字或图片水印,可设置透明度、旋转、间距、尺寸、字体和颜色。 |
toolbar | 控制下载、打印、HTML 导出、缩放和工具栏位置,并支持操作级前置校验。 |
search | 配置文档搜索、高亮 class、大小写、整词匹配、最大命中数和 debounce。 |
ai | 控制文本结构采集、分块大小和最大文本长度,为溯源、定位、向量化和外部 AI 流程提供基础。 |
archive | 配置压缩包 Worker/WASM、超时、缓存、包体限制和压缩包内单文件预览大小。 |
pdf | 配置 PDF.js Worker、导航栏、目录、缩略图、旋转、流式读取、Range chunk 和凭据。 |
docx / spreadsheet | DOCX 由 @file-viewer/renderer-word 承接并使用自研 @file-viewer/docx,默认自动选择 Worker 或主线程解析,连续流式阅读和异步分批渲染,可按需显式开启视觉分页;表格由 @file-viewer/renderer-spreadsheet 承接,默认保真主线程渲染,Worker 和表头拖拽调列宽均可按需显式开启。 |
typst / data / cad | 配置 Typst、SQLite、CAD/DWG/DXF/DWF 等 WASM、Worker、编码和渲染策略。 |
hooks / beforeOperation | 统一生命周期 hooks 和操作前置校验,可用于审计、权限、埋点和安全控制。 |
| 配置 | 说明 |
|---|---|
toolbar: false | 隐藏内置工具栏,但不关闭下载、打印、导出、缩放等 controller API,适合完全自定义业务工具栏。 |
toolbar: true | 使用默认内置工具栏,下载、打印、HTML 导出和缩放按钮都会按能力动态显隐。 |
download / print / exportHtml / zoom | 表达业务是否允许展示对应按钮;最终仍会结合文件类型、渲染完成状态、导出适配器和缩放 provider 计算真实可用性。 |
position | auto、top、bottom-right。默认 auto,PDF 自动悬浮右下角,减少和 PDF 自身页码 / 目录工具栏冲突。 |
beforeOperation | 工具栏层统一前置校验,会在 options.beforeOperation 后执行。返回 false 或抛错都会取消本次操作。 |
beforeDownload / beforePrint / beforeExportHtml | 单按钮前置校验;适合下载权限、打印审计、导出水印确认等细粒度业务规则。 |
完全自定义工具栏时,推荐关闭内置工具栏并使用组件 ref / controller 暴露的标准 API。不要在预览器外层用 CSS transform: scale() 做缩放;PDF、Excel、CAD、canvas 和文本层格式都应通过内部缩放 provider 保持坐标正确。
| 生态 | 推荐方式 |
|---|---|
| Vanilla JS / Pure Web | <flyfish-file-viewer toolbar="false"> 或 mountViewer(container, { options:{ toolbar:false }, onStateChange });外部 DOM 按钮可直接调用元素实例 / controller 的 zoomIn()、printRenderedHtml()、searchDocument() 等方法,复杂场景用 viewer-state-change 或 controller.subscribe() 同步状态。 |
| Vue 3 | 传 :options="{ toolbar: false }" 隐藏内置工具栏,通过模板 ref 调用 downloadOriginalFile()、printRenderedHtml()、exportRenderedHtml()、zoomIn()、zoomOut()、resetZoom();用 @operation-availability-change 和 @zoom-change 同步按钮显隐与比例。 |
| Vue 2.7 / 2.6 | 同样设置 toolbar:false,通过 $refs.viewer 调用实例方法;监听 @viewer-event,在 event.type === "operation-availability-change" 或 event.type === "zoom-change" 时更新外部工具栏。 |
| React / React Legacy | 推荐 useFileViewer({ options:{ toolbar:false } }),把 viewer.props 传给组件,把按钮绑定到 viewer.handle,并读取 viewer.state.availability / viewer.state.zoom 控制禁用状态。 |
| jQuery | $("#viewer").fileViewer({ options:{ toolbar:false } });按钮调用 $("#viewer").fileViewer("zoomIn") 或通过 getFileViewerController($("#viewer")).subscribe() 获取能力状态。 |
| Svelte | <FileViewer bind:this={viewer} options={{ toolbar:false }} />;按钮直接调用 viewer.zoomIn()、viewer.printRenderedHtml(),并用 on:viewerEvent / onStateChange 同步状态。 |
| 事件 / hook | 说明 |
|---|---|
load-start / hooks.onLoadStart | 开始解析或下载文档时触发,包含文件名、类型、来源、版本、URL、File 和 size。 |
load-complete / hooks.onLoadComplete | 当前文档完成渲染时触发,包含耗时、来源上下文和版本号。 |
unload-start / hooks.onUnloadStart | 替换、重置或组件卸载前触发,可用于保存状态或释放外部资源。 |
unload-complete / hooks.onUnloadComplete | 旧文档释放完成后触发,reason 会标识 replace、reset 或 component-unmount。 |
operation-before / operation-cancel | 下载、打印、HTML 导出和缩放前后触发;beforeOperation 返回 false 可取消操作。 |
operation-availability-change | 当前格式是否可下载、可打印、可导出 HTML、可缩放发生变化时触发。 |
search-change / location-change / zoom-change | 搜索命中、定位锚点和缩放状态变化时触发,用于外层同步 UI。 |
| API | 说明 |
|---|---|
load / update / reload / destroy | 命令式控制文档加载、参数更新、重新加载和销毁。 |
downloadOriginalFile() | 下载原始文件,遵循 toolbar 与 beforeOperation 权限校验。 |
printRenderedHtml() | 打印当前完整渲染内容,优先使用各格式的高保真打印适配器。 |
exportRenderedHtml() | 导出当前渲染后的 HTML,用于归档、审计和离线查看。 |
zoomIn() / zoomOut() / resetZoom() | 调用当前格式自己的缩放 provider,避免外层 CSS 缩放导致坐标偏移。 |
searchDocument() / nextSearchResult() / previousSearchResult() | 打开文档级搜索并在命中之间导航,保持高亮状态。 |
collectDocumentAnchors() / scrollToAnchor() / scrollToLine() | 采集页面、目录、标题或代码行锚点,并执行定位跳转。 |
getDocumentTextChunks() | 获取结构化文本块,便于搜索、AI 溯源、向量化和外部索引。 |
getOperationAvailability() / getZoomState() / getSearchState() | 读取当前能力、缩放和搜索状态,便于自定义工具栏。 |
| 资源 | 说明 |
|---|---|
| 通用 viewer assets | Pure Web 包提供 file-viewer-copy-assets,可把 Worker、WASM、vendor 和示例资源复制到业务静态目录。 |
| CAD / DWG / DXF / DWF | 按需配置 options.cad.wasmPath、workerUrl、dwfWasmUrl、dxfEncoding,支持自托管和内网部署。 |
| PDF / DOCX / Excel | 按需配置 options.pdf.workerUrl、options.pdf.cMapUrl、options.pdf.wasmUrl、options.pdf.standardFontDataUrl、options.docx.workerUrl、options.docx.workerJsZipUrl、options.spreadsheet.workerUrl;PDF 默认探测真实静态 Worker,不可用时懒加载包内 handler 兜底;DOCX 默认自动选择 Worker 或主线程解析,Electron file:// 等本地不安全协议会自动回退,Excel Worker 需显式开启,列宽拖拽可通过 options.spreadsheet.resizableColumns 显式开启。 |
| Typst / SQLite / Archive | 按需配置 Typst compiler/renderer WASM、data.sqlWasmUrl、archive.workerUrl / archive.wasmUrl;Typst 仅使用本地 WASM 真实渲染,不访问公共 CDN。 |
| Drawing | Draw.io 默认使用随 viewer assets 分发的官方 diagrams.net 离线 viewer;路径特殊时可通过 options.drawing.viewerScriptUrl 覆盖,preferOfficial:false 才切到内置 SVG 兜底。 |
| 离线部署 | 运行时不依赖公共 CDN 或第三方在线资源;file-viewer-copy-assets 会复制 PDF、CAD、Typst、SQLite、压缩包、Draw.io、DOCX worker/JSZip 和 Office worker/vendor 资产。 |
| 部署原则 | 默认只在命中特定格式时异步加载对应依赖;没有命中的格式不会拉取重型 Worker、WASM 或解析库。 |
@file-viewer/core 和自身生态依赖,不嵌套引用其他框架组件包。完整参数、生命周期 hooks、beforeOperation、主题、水印、搜索、缩放、打印和导出说明见官方文档: https://doc.file-viewer.app/
在线 Demo: https://demo.file-viewer.app/ 。License: Apache-2.0。二开或商用请保留 Flyfish Viewer 来源说明;如果修复了通用兼容问题,也欢迎贡献回对应组件仓库。
FAQs
Standard React component package for File Viewer
The npm package @file-viewer/react receives a total of 7,289 weekly downloads. As such, @file-viewer/react popularity was classified as popular.
We found that @file-viewer/react demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Research
/Security News
Three compromised Rust crates pulled in a malicious dependency that downloaded and executed cross-platform malware during Cargo builds.

Research
/Security News
Socket uncovered 77 linked Firefox extensions, including 40 that steal wallet secrets or credentials and 37 deceptive sports-score shells.

Security News
NIST disclosed an unreleased AI tool called V-etalon and opened a broad inquiry into NVD modernization after years of automation plans produced no public enrichment system.