File Viewer: پیشنمایش ۲۷۵ فرمت فایل مستقیم توی مرورگر
خلاصهٔ کاملتر
File Viewer یه پروژه متنبازه که فایلها رو مستقیم توی مرورگر پیشنمایش میده، بدون اینکه به سرور تبدیل (conversion server، یعنی سروری که مثلاً Word رو به PDF یا تصویر تبدیل کنه) نیاز داشته باشه. طبق README پروژه، ۲۷۵ پسوند ثبت شده (۲۲۵ پایدار و ۵۰ آزمایشی) که توی ۴۷ مسیر رندر مختلف پخش شدن: Word، Excel، PowerPoint، PDF، OFD، DWG/DXF، مدلهای STEP/IFC، آرشیوها، ایمیل، DICOM و کلی فرمت دیگه.
نکته مهمش اینه که موتورهای سنگین مثل PDF، CAD، آفیس و سهبعدی بهصورت lazy-load (یعنی فقط وقتی اون فرمت لازم شد دانلود میشن) بارگذاری میشن. Workerها، فایلهای WASM و فونتها رو هم میشه روی سرور خودت میزبانی کنی، پس توی شبکههای آفلاین هم کار میکنه. یه API مشترک برای Web Component، Vue 3، Vue 2.7/2.6، React از 16.8 تا 19، Svelte و jQuery هست.
سادهترین راه استفاده، Web Component بدون فریمورکه:
import { mountViewer } from '@file-viewer/web-full'
mountViewer(document.querySelector('#viewer'), {
url: '/documents/handbook.pdf',
filename: 'handbook.pdf'
})فقط باید به #viewer ارتفاع بدی و اگه فایل از یه origin دیگه میاد، هدرهای CORS درست باشه. بهجای URL میشه یه File هم پاس داد. هر فریمورک یه پکیج سبک (مثل @file-viewer/react) و یه پکیج کامل با پسوند -full داره. برای پکیجهای سبک میتونی presetهایی مثل @file-viewer/preset-office یا preset-engineering رو اضافه کنی تا فقط فرمتهای لازم نصب بشن.
پکیجهای Full همون خط پایه نسخه v2.4 رو نگه میدارن، یعنی ۲۲۱ پسوند در ۳۲ مسیر. رندرهای تخصصی جدید مثل فایلهای Adobe، DICOM و بازرسی باینری باید جدا نصب بشن. یه نکته مهم دیگه: فایلهای Worker و WASM باید کنار اپ سرو بشن (مسیر پیشفرض file-viewer/ هست). برای Vite یه پلاگین هست و برای Webpack و بقیه یه دستور کپی. اگه یکی از این فایلها جا بمونه، اون فرمت کار نمیکنه.
تیم پروژه تأکید میکنه که این ابزار فقط viewer هست، نه ویرایشگر. فونتها، قابلیتهای خاص یه سازنده، فایلهای رمزدار و فایلهای خیلی بزرگ میتونن روی دقت نمایش یا مصرف حافظه اثر بذارن. یه SDK برای Flutter هم بهصورت پیشنمایش توسعه (0.1.0-dev.2) روی pub.dev منتشر شده. مجوز خود پروژه Apache-2.0 هست، ولی بخش DWG/DWF مجوز AGPL-3.0-only داره.
نکات کلیدی:
- ۲۷۵ پسوند ثبتشده (۲۲۵ پایدار، ۵۰ آزمایشی) در ۴۷ مسیر رندر
- بدون سرور تبدیل؛ پردازش کامل سمت مرورگر
- پشتیبانی از React 16.8 تا 19، Vue 2 و 3، Svelte، jQuery و Web Component
- فایلهای Worker و WASM باید کنار اپ سرو بشن، وگرنه فرمت مربوطه کار نمیکنه
- مجوز Apache-2.0، ولی رانتایم CAD (DWG/DWF) تحت AGPL-3.0-only هست




