PDFs einfach in Ihre Website einbetten mit PDF Embed API

Es ist erstaunlich, wie viele Informationen wir heute im PDF-Format gespeichert haben. Laut der PDF Association werden jedes Jahr etwa 2,5 Billionen PDFs erstellt, was 6 Prozent des Webs ausmacht. Als Webentwickler können PDFs auf einer Website jedoch eine Reihe von Herausforderungen mit sich bringen:

  • Das Anzeigeerlebnis variiert stark zwischen verschiedenen Benutzern und Geräten, da sie von einem PDF-Viewer abhängig sind. Ob in Webbrowsern eingebettet oder in kostenlosen Online-Bibliotheken, einige Viewer sind besser als andere. Adobe Acrobat Reader ist in der Regel der universelle Standard für die korrekte Anzeige von PDFs.
  • Schwierig wird es für mich, wenn ich PDFs in den Rest meiner Website einbinden möchte. Meistens würden PDFs die Benutzer dazu auffordern, die PDFs auf ihren Geräten herunterzuladen.
  • PDFs in HTML zu konvertieren ist schwierig und unzuverlässig. Wenn ich Inhalte innerhalb einer Webseite präsentieren möchte, die im PDF-Format vorliegen, muss ich sie oft in PDF umwandeln, um sie leichter einbetten zu können.
  • Ich habe keinen Einblick in die Art und Weise, wie meine Besucher diese PDFs betrachten. Das bedeutet, dass ich keine Ahnung habe, ob jemand bestimmte Seiten liest, wie lange er auf diesen Seiten verweilt usw.

Glücklicherweise hat Adobe die Adobe PDF Embed API (PDF Embed) veröffentlicht, eine einfache Möglichkeit für Sie, ein PDF direkt in Ihre Website mit einem einfachen Codeschnipsel einzubinden. Die Anwendung ist völlig kostenlos und wird clientseitig innerhalb Ihrer Web-Applikation gerendert. Sie müssen keine ausgefeilte PDF-Bibliothek erlernen, und es ist super einfach zu machen. Es werden keine Daten auf Adobe-Servern gerendert. Tatsächlich können Sie hier sogar lernen, wie man damit spielt.

NICHTS! Das ist das Tollste an der Sache. Sie brauchen nichts anderes als eine Webseite, um PDF Embed zu nutzen.

Demoseite zum Ausprobieren der PDF Embed API

Die PDF Embed Demo-Seite ermöglicht es Ihnen, den Viewer anzupassen und dann einen Einbettungscode zu generieren.

Der einfachste Weg, sich mit PDF Embed vertraut zu machen, ist, es auf der Demo-Site auszuprobieren. Es ist eine einfache Ressource für den Einstieg, denn sie erlaubt Ihnen:

  • Sehen Sie in Echtzeit die verschiedenen Einbettungsmodi, die für Ihre PDFs zur Verfügung stehen.
  • Anpassen, welche Funktionen Sie als Teil des Viewers haben möchten, wie z.B. Anmerkungswerkzeuge, PDF herunterladen, PDF drucken, Seitensteuerungen, etc.
  • Generiert Code, den Sie direkt in Ihre Website einfügen können.

Erhalten Sie Ihre Client-ID

Wenn Sie die PDF-Einbettung in Ihrem eigenen Code ausprobieren möchten, funktioniert sie ohne Client-ID, wenn Sie sie lokal verwenden. Wenn Sie es jedoch tatsächlich in Ihre Website einbinden wollen, benötigen Sie eine Client-ID. Ihre Client-ID erhalten Sie hier.

Die Einstellung Ihrer Anwendungsdomäne ist wichtig. Wenn die PDF-Einbettung geladen wird, prüft sie, ob der Viewer aus dieser Domäne geladen wird.

Hier sind ein paar wichtige Tipps:

  • Um eine Client-ID zu erstellen, benötigen Sie eine Adobe-ID. Wenn Sie keine haben, können Sie sich hier mit einer E-Mail-Adresse, Google-, Facebook- oder Apple-ID anmelden.
  • Sie müssen Ihre Anwendungsdomäne festlegen, damit dies funktioniert.

Nachdem Sie Ihre Client-ID erstellt haben, müssen Sie diese kopieren und in Ihrem Code verwenden.

Ihre Client ID befindet sich hier innerhalb von Adobe IO.

Hinweis: Während Sie Ihre Konfigurationen in der Adobe.io-Konsole bearbeiten können, müssen Sie den Link zur Erstellung Ihres Schlüssels aufrufen. Wenn Sie Ihren Schlüssel aus der Adobe.io Console heraus erstellen, haben Sie nicht die Möglichkeit, Ihre Domain festzulegen.

Auswahl des Einbettungsmodus

Eine der Stärken von PDF Embed ist, dass Sie verschiedene Einbettungsmodi zur Auswahl haben:

Full Window

Mit dem Anzeigemodus „Volles Fenster“ können Sie eine PDF-Anzeige ähnlich wie im Adobe Acrobat Reader in Ihrer Website erstellen.

Mit dem Anzeigemodus „Volles Fenster“ können Sie ein Anzeigeerlebnis ähnlich dem Adobe Acrobat Reader auf Ihrem Computer erzeugen und in Ihre Website einbetten. Ich finde dies ideal, wenn ich lange Dokumente betrachte oder wenn ich eine vertraute PDF-Ansicht in meiner Benutzeroberfläche haben möchte.

Große Container

Sized Container ist eine gute Option, wenn Sie Inhalte wie Folien in Ihre Website einbetten möchten.

Große Container eignen sich hervorragend für Inhalte wie PowerPoint-Präsentationen, die in PDF konvertiert wurden, oder eine Reihe von Anleitungen. Weniger ideal finde ich es, wenn Sie lange PDFs einbinden.

In-Line

In-Line-Modus ermöglicht es Ihnen, ein PDF inline in Ihre Webseite einzubetten.

Die In-Line-Ansicht kann Designern dabei helfen, ihre Entwürfe in eine Webseite einzubetten, ohne sie neu aufbauen oder in ein Bild umwandeln zu müssen. Die In-Line-Ansicht nimmt Ihr PDF und rendert es inline als HTML. Ich mag diesen Einbettungsmodus, wenn Sie Inhalte wie z. B. Infografiken anzeigen möchten, die Sie in Illustrator, InDesign usw. entworfen und als PDF exportiert haben, die aber trotzdem durchsuchbar sein und Hyperlinks enthalten sollen, ohne dass Sie sich Gedanken über die Neugestaltung für das Web machen müssen.

Lightbox

Lightbox ermöglicht es Ihnen, PDFs auf Ihrer Webseite einfach als Lightbox über Ihrer Webseite zu präsentieren.

Die Lightbox öffnet den PDF-Viewer über der Webseite, um eine konzentriertere Ansicht zu ermöglichen. Dieser Modus ist ideal, wenn Sie Links zu PDF-Dateien auf Ihrer Website haben, aber das Anzeigeerlebnis kontrollieren, Analysen sammeln und Ereignisse auslösen möchten, die darauf basieren, wie Ihr Publikum mit den PDF-Dateien interagiert, die Sie bereitgestellt haben.

Generieren des Codes

Wenn Sie die Demo-Site verwenden und auf Code generieren klicken, wird es ungefähr so aussehen:

Um loszulegen, müssen Sie die folgenden Elemente ersetzen:

  • Ersetzen Sie <YOUR_CLIENT_ID> durch die von Ihnen generierte Client-ID.
  • Ersetzen Sie den url-Parameter mit der URL der PDF-Datei, die Sie anzeigen möchten.
    Hinweis: Da PDF Embed clientseitig im Browser gerendert wird, werden alle eingestellten Cross-Domain-Einschränkungen beachtet, so dass Sie möglicherweise sicherstellen müssen, dass Ihre Header eine Cross-Domain-Verknüpfung erlauben.
  • Ändern Sie fileName auf den Namen Ihres Dokuments. Dieser wird im Viewer angezeigt.

Sobald Sie das getan haben, können Sie Ihr PDF in Ihre Website einbetten. So einfach ist das!

Beispiele, die Services SDK heute nutzen

Es gibt eine Reihe von Anwendungen, die Services SDK heute schon nutzen:

  • PDF Viewer Component for AEM
  • PDF like a boss
  • Microsoft SharePoint Plugin
  • Adobe Acrobat for G Suite

Fazit

PDF Embed ermöglicht wirklich eine Menge Flexibilität, um PDFs in Ihren Webseiten zu nutzen. Es gibt noch viel mehr, was Sie damit machen können, wie z.B. Analytics, Event Listener und vieles mehr, worüber Sie in dieser Dokumentation mehr erfahren können.

Wir möchten von Ihnen hören

Wenn Sie sich PDF Embed einmal angesehen haben, würden wir gerne Ihre Meinung hören! Beteiligen Sie sich im Adobe Document Cloud Forum, um Ihr Feedback zu geben, oder antworten Sie auf diesen Artikel!

UPDATE (07.07.2020): Aktualisiert, um den neuen Lightbox-Einbettungsmodus hinzuzufügen und ein neues Header-Bild.

UPDATE (31.07.2020): Aktualisiert, um neues Branding zu reflektieren.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.