نحوه کار با پیوست‌های PDF در TypeScript
این راهنما نشان می‌دهد چگونه با پیوست‌های فایل در اسناد PDF با Aspose.PDF FOSS برای TypeScript کار کنید. Document.AddAttachment() فایلی را در سطح سند جاسازی می‌کند؛ Page.AddFileAttachment() یک حاشیه‌نویسی شبیه گیره‌کاغذی قابل کلیک بر روی صفحه قرار می‌دهد که یک فایل جاسازی شده را باز می‌کند. نیاز به Node.js 22 یا بالاتر دارد.
راهنمای گام به گام
گام 1: نصب بسته
git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-TypeScript.git
cd Aspose.PDF-FOSS-for-TypeScript
npm install
npm run buildنصب را با وارد کردن کلاس Document در یک فایل جدید TypeScript تأیید کنید — این خط باید پس از نصب بسته بدون خطا حل شود:
import { Document } from '@asposefoss/pdf';گام 2: وارد کردن کلاس‌های مورد نیاز
برای باز کردن فایل Document را وارد کنید و به هر دو نقطه ورودی پیوست استفاده شده در زیر دسترسی پیدا کنید:
import { Document } from '@asposefoss/pdf';مرحله ۳: سند هدف را باز کنید
هر دو روش پیوست بر روی یک Document باز فراخوانی می‌شوند — پیوست‌های سطح Page علاوه بر آن به Page هدف نیاز دارند:
const doc = Document.OpenFile('input.pdf');
const page = doc.Pages[0];مرحله ۴: پیوست در سطح سند را جاسازی کنید
Document.AddAttachment(name, bytes, opts) -> Attachment یک فایل را در مجموعهٔ فایل‌های جاسازی‌شدهٔ سند، با کلید name قرار می‌دهد. Document.GetAttachments() -> Attachment[] تمام موارد currently embedded را فهرست می‌کند، و Document.RemoveAttachment(name) -> boolean یک مورد را بر اساس نام حذف می‌کند.
مرحله ۵: افزودن حاشیه‌نویس پیوست فایل در سطح صفحه
Page.AddFileAttachment(opts) -> FileAttachmentAnnotation یک نماد قابل کلیک روی صفحه قرار می‌دهد — مشابه یادداشت‌های استیک‌نوت و حاشیه‌نویسی‌های متن آزاد که در حاشیه‌نویسی‌ها راهنما — که یک نمایشگر آن را باز می‌کند تا فایل جاسازی‌شده را ذخیره یا پیش‌نمایش کند. متفاوت از Document.AddAttachment()، این نماد به یک مکان خاص در صفحه پیوست شده است نه اینکه فقط در مجموعهٔ فایل‌های جاسازی‌شدهٔ سند فهرست شود.
مسایل رایج و راه‌حل‌ها
یک پیوست که با Document.AddAttachment() آیکون قابل مشاهده‌ای روی هیچ صفحه‌ای ندارد. این مورد طبیعی است — یک پیوست در سطح سند در مجموعهٔ فایل‌های جاسازی‌شده قرار دارد، نه روی صفحه. از Page.AddFileAttachment() به‌علاوه اگر نیاز به نماد قابل کلیک روی یک صفحه خاص باشد.
Document.RemoveAttachment() returns false. باز می‌گرداند false زمانی که هیچ پیوستی تحت مقدار داده شده ثبت نشده باشد name — فهرست مجموعهٔ فعلی با Document.GetAttachments() اول برای تأیید نام دقیق استفاده‌شده.
دو پیوست تحت یک name. name in Document.AddAttachment() کلیدی است که برای جستجوی دوبارهٔ پیوست به‌کار می‌رود RemoveAttachment() — استفاده مجدد از یک نام برای تماس دوم می‌تواند اولین را مخفی یا با آن تضاد داشته باشد، بسته به اینکه نمایشگر چطور تکراری‌ها را حل می‌کند. برای هر فایل جاسازی‌شده از یک نام متمایز استفاده کنید.
سوالات متداول
تفاوت بین پیوست سطح-سند و پیوست سطح-صفحه چیست؟
یک پیوست سطح-سند (Document.AddAttachment()) در مجموعهٔ embedded-files PDF قرار دارد و به هیچ صفحه‌ای وابسته نیست. یک پیوست سطح-صفحه (Page.AddFileAttachment()) یک حاشیه‌نویسی است که به موقعیت خاصی در صفحه متصل می‌شود، مشابه یادداشت چسبان.
چگونه می‌توانم ببینم که در حال حاضر چه چیزهایی در یک سند جاسازی شده‌اند؟
فراخوانی Document.GetAttachments()، که تمام Attachmentهای فعلی جاسازی‌شده را برمی‌گرداند.
آیا می‌توان پس از افزودن، یک پیوست را حذف کرد؟
بله — Document.RemoveAttachment(name) یک پیوست در سطح سند را بر اساس نامی که تحت آن افزوده شده است حذف می‌کند و در صورت یافتن و حذف یک پیوست، true را برمی‌گرداند.
