Jak pracovat s PDF přílohami v TypeScript

Tento průvodce ukazuje, jak pracovat s přílohami souborů v PDF dokumentech pomocí Aspose.PDF FOSS pro TypeScript. Document.AddAttachment() vloží soubor na úrovni dokumentu; Page.AddFileAttachment() umístí kliknutelnou anotaci ve stylu sponky na stránku, která otevře vložený soubor. Vyžaduje Node.js 22 nebo novější.

Průvodce krok za krokem

Krok 1: Nainstalujte balíček

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

Ověřte instalaci importováním třídy Document v novém souboru TypeScript — tento řádek by měl být bez chyb po instalaci balíčku:

import { Document } from '@asposefoss/pdf';

Krok 2: Importujte požadované třídy

Importujte Document, abyste otevřeli soubor a dosáhli obou vstupních bodů příloh používaných níže:

import { Document } from '@asposefoss/pdf';

Krok 3: Otevřít cílový dokument

Obě metody příloh jsou volány na otevřeném Document — Page-úrovňové přílohy navíc vyžadují cílový Page:

const doc = Document.OpenFile('input.pdf');
const page = doc.Pages[0];

Krok 4: Vložit přílohu na úrovni dokumentu

Document.AddAttachment(name, bytes, opts) -> Attachment vloží soubor do sbírky vložených souborů dokumentu, indexované pomocí name. Document.GetAttachments() -> Attachment[] vypisuje vše, co je v současnosti vloženo, a Document.RemoveAttachment(name) -> boolean odstraní jeden podle názvu.

Krok 5: Přidat anotaci přílohy souboru na úrovni stránky

Page.AddFileAttachment(opts) -> FileAttachmentAnnotation umístí klikací ikonu na stránku — podobně jako lepicí poznámky a volné textové anotace popsané v Anotace průvodci — který si prohlížeč otevře k uložení nebo náhledu vloženého souboru. Na rozdíl od Document.AddAttachment(), je ukotvena na konkrétním místě stránky, místo aby byla uvedena pouze ve sbírce vložených souborů dokumentu.

Časté problémy a opravy

Příloha přidaná pomocí Document.AddAttachment() nemá na žádné stránce viditelnou ikonu. To je očekávané — příloha na úrovni dokumentu žije ve sbírce vložených souborů, nikoli na stránce. Použijte Page.AddFileAttachment() navíc, pokud je vyžadována klikací ikona na konkrétní stránce.

Document.RemoveAttachment() returns false. Vrací false když není pod zadaným registrována žádná příloha name — vypište aktuální sadu pomocí Document.GetAttachments() nejprve pro potvrzení přesného názvu, který se používá.

Dvě přílohy byly vloženy pod stejným name. name in Document.AddAttachment() je klíč, který se používá k vyhledání přílohy RemoveAttachment() — opětovné použití názvu pro druhé volání může zastínit nebo způsobit konflikt s prvním, v závislosti na tom, jak prohlížeč řeší duplicitní názvy. Použijte odlišný název pro každý vložený soubor.

Často kladené otázky

Jaký je rozdíl mezi přílohou na úrovni dokumentu a přílohou na úrovni stránky?

Příloha na úrovni dokumentu (Document.AddAttachment()) žije ve sbírce embedded-files PDF a není svázána s žádnou stránkou. Příloha na úrovni stránky (Page.AddFileAttachment()) je anotace ukotvená na konkrétním místě stránky, podobně jako lepicí poznámka.

Jak mohu zobrazit, co je v dokumentu aktuálně vloženo?

Zavolejte Document.GetAttachments(), který vrací všechny aktuálně vložené Attachment.

Lze přílohu odstranit po jejím přidání?

Ano — Document.RemoveAttachment(name) odstraňuje přílohu na úrovni dokumentu podle názvu, pod kterým byla přidána, a vrací true, pokud ji našel a odstranil.