کتابخانه
pdfjs-dist نسخه آماده و استاندارد بسته npm کتابخانه PDF.js موزیلاست. با این کتابخانه می تونی فایل PDF رو مستقیم توی مرورگر باز کنی و صفحه هاش رو روی canvas نشون بدی، بدون افزونه جانبی و بدون فرستادن فایل به سرویس خارجی. برای ساختن نمایشگر PDF توی سایت و پنل های وردپرسی به کار می ره.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۱۴٫۲ مگابایت· ۲۰۱ فایل· انتشار
SHA-256: 57456c8e0c81e46be31174b499ef77f2b9f5ee46d04412ba627320a36755d4c2
اگه تا حالا خواسته باشی یه PDF رو دقیقاً همون جایی که می خوای توی صفحه نشون بدی، می دونی که iframe و تگ embed همه جا یکسان رفتار نمی کنن. بعضی مرورگرهای موبایل فقط یه دکمه دانلود نشون می دن و ظاهر نمایشگر هم دست خودت نیست. pdfjs-dist برای همین مشکل به درد می خوره. فایل PDF رو توی جاوااسکریپت می خونه و صفحه ها رو روی canvas می کشه. نتیجه اینه که نمایش توی مرورگرهای مختلف تقریباً شبیه هم می شه و ظاهرش دست خودته.
pdfjs-dist همون بسته توزیعی PDF.js هست؛ پروژه ای که موزیلا برای نمایشگر PDF داخلی فایرفاکس نگه می داره. برای همین لازم نیست سورس پروژه رو بیلد کنی. فقط بسته رو نصب می کنی یا فایل ها رو کنار سایتت می ذاری. پردازش سنگین فایل روی یه worker جدا انجام می شه و صفحه قفل نمی کنه. برای متن قابل انتخاب و جستجو هم می شه یه لایه متنی روی تصویر صفحه انداخت. یه نسخه سازگارتر با مرورگرهای قدیمی هم کنار نسخه اصلی هست. اگه بین مخاطب هات مرورگر کهنه زیاده، سراغ اون برو.
این کتابخانه برای توسعه دهنده ها و تیم هایی خوبه که نمایشگر اختصاصی لازم دارن: پیش نمایش فاکتور و قرارداد توی پنل کاربری، کتاب و جزوه توی سایت آموزشی، یا کاتالوگ محصول توی یه قالب سفارشی. یه نکته ایرانی هم داره. نمایشگرهایی که به سرویس خارجی وصلن، مثلاً iframe از یه سرویس بیرونی، توی روزهای محدودیت اینترنت بین الملل ممکنه کند بشن یا اصلاً باز نشن. وقتی خودِ کتابخانه روی هاست خودته، نمایشگر هم تا وقتی سایتت بالاست کار می کنه.
ولی همه جا به این کتابخانه نیاز نداری. اگه فقط می خوای کاربر PDF رو دانلود کنه، یه لینک ساده کافیه. pdfjs-dist افزونه آماده وردپرس هم نیست. یه کتابخانه است و خودت یا برنامه نویس تیمت باید کدش رو وصل کنید. فایل های بزرگ رو هم بهتره صفحه به صفحه رندر کنی، نه همه رو یکجا.
چند نکته موقع استفاده: فایل اصلی و فایل worker باید هم نسخه باشن، وگرنه خطای ناسازگاری می گیری. اگه PDF روی دامنه دیگه ای باشه، تنظیم CORS رو چک کن. توی PDFهای فارسی معمولاً فونت ها داخل فایل جاسازی شدن و نمایش مشکلی نداره، اما استخراج متن فارسی رو حتماً با چند نمونه واقعی امتحان کن. مجوز کتابخانه Apache هست و استفاده تجاری ازش آزاده، به شرط رعایت شرط های مجوز. نسخه های رسمی و بدون تغییر pdfjs-dist توی مخزن داخلی ما هم در دسترسه و برای دریافتش لازم نیست به منبع خارجی وصل بشی.
راه انداختن pdfjs-dist توی یه صفحه معمولی چند قدم بیشتر نیست. کد آماده اش پایین همین صفحه هست، اینجا فقط ترتیب کار رو می گم:
توی وردپرس فایل ها رو با wp_enqueue_script توی قالب یا افزونه خودت لود کن و آدرس PDF رو از کتابخانه رسانه بگیر. بعد از اولین تست، کنسول مرورگر رو نگاه کن. بیشتر خطاهای اول کار از مسیر اشتباه worker یا مشکل CORS می آد.
PDF.js خودِ پروژه متن باز موزیلاست و pdfjs-dist نسخه آماده و توزیع شده همون پروژه به شکل بسته npm. فایل های بیلدشده توشه، پس لازم نیست سورس رو کامپایل کنی. برای استفاده توی سایت یا اپ، همین بسته رو برمی داری و به صفحه وصل می کنی.
نه. اگه فقط یه PDF ساده می خوای نشون بدی، تگ embed یا یه افزونه آماده کافیه. pdfjs-dist وقتی به درد می خوره که نمایشگر اختصاصی، ظاهر یکدست توی مرورگرها یا کنترل کامل روی صفحه ها و دکمه ها بخوای و کدنویسی هم برات مشکلی نباشه.
معمولاً یکی از سه دلیل داره: مسیر workerSrc اشتباهه، فایل worker با فایل اصلی هم نسخه نیست، یا سرور فایل رو با نوع محتوای درست تحویل نمی ده. اول توی تب Network مرورگر ببین فایل worker لود می شه یا نه، بعد نسخه هر دو فایل رو با هم مقایسه کن.
معمولاً بله، چون فونت ها توی خودِ PDF جاسازی شدن و کتابخانه همون ها رو رندر می کنه. اگه فونت جاسازی نشده باشه، ممکنه ظاهر فرق کنه. اگه می خوای متن فارسی رو استخراج یا جستجو کنی، اول با چند فایل واقعی خودت امتحانش کن.
مجوز Apache استفاده تجاری رو اجازه می ده. فقط باید اطلاعیه مجوز و حق نشر رو نگه داری و اگه توی فایل ها تغییری دادی، طبق شرط های مجوز مشخصش کنی. اگه پروژه ات حساسیت حقوقی داره، متن کامل مجوز رو یه بار بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.