Ten przykład HotPDF pokazuje, jak umieszczać klikalne hiperłącza w wygenerowanym dokumencie PDF. Hiperłącza są małą funkcją, ale mają znaczenie w fakturach, raportach, kartach produktów, eksportach dokumentacji i każdym PDF, który powinien prowadzić czytelnika z powrotem do strony, zamówienia, formularza supportu lub instrukcji online.
Najważniejsze jest to, że widoczny tekst i klikalny cel są osobnymi sprawami. PDF może wyświetlać przyjazną etykietę, podczas gdy adnotacja wskazuje pełny URL. W prawdziwej aplikacji utrzymuj te dwa elementy zsynchronizowane, aby użytkownicy widzieli, dokąd prowadzi link.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
unit Main; interface uses Windows, Messages, SysUtils, Classes, Graphics, Controls, StdCtrls, Forms, Dialogs, HPDFDoc; type TForm1 = class(TForm) HotPDF: THotPDF; HelloWorldButton: TButton; edtWeb: TEdit; edtProduct: TEdit; edtOrder: TEdit; edtContact: TEdit; Label1: TLabel; Label2: TLabel; Label3: TLabel; Label4: TLabel; procedure HelloWorldButtonClick(Sender: TObject); private { Private declarations } public { Public declarations } end; var Form1: TForm1; implementation {$R *.dfm} procedure TForm1.HelloWorldButtonClick(Sender: TObject); begin HotPDF.BeginDoc; HotPDF.CurrentPage.SetFont( 'Microsoft Sans Serif', [], 13 ); HotPDF.CurrentPage.TextOut(20,30,0,'Clickable links:'); HotPDF.CurrentPage.PrintHyperlink(20, 60, 'Company site: ' + edtWeb.Text, edtWeb.Text); HotPDF.CurrentPage.PrintHyperlink(20, 80, 'Product page: ' + edtProduct.Text, edtProduct.Text); HotPDF.CurrentPage.SetRGBHyperlinkColor(clRed); HotPDF.CurrentPage.PrintHyperlink(20, 100, 'Purchase link: ' + edtOrder.Text, edtOrder.Text); HotPDF.CurrentPage.SetRGBHyperlinkColor(clBlue); HotPDF.CurrentPage.PrintHyperlink(20, 120, 'Contact form: ' + edtContact.Text, edtContact.Text); HotPDF.EndDoc; end; end. |
Gdzie ten wzorzec pasuje
Używaj hiperłączy PDF dla odwołań, które powinny pozostać aktywne po wysłaniu dokumentu e-mailem, zarchiwizowaniu albo pobraniu z portalu klienta. Typowe cele obejmują strony produktów, instrukcje online, release notes, issue trackers, faktury, strony wyszukiwania licencji i endpointy weryfikacji dokumentów.
Położenie i styl
Linki PDF są adnotacjami umieszczonymi nad obszarem strony. Jeśli zmieniasz font, pozycję tekstu, skalowanie lub układ współrzędnych strony, zweryfikuj, czy klikalny prostokąt nadal pasuje do tekstu widocznego dla użytkownika. Link przesunięty wizualnie o kilka pikseli może sprawiać wrażenie zepsutego, nawet gdy sam URL jest poprawny.
Kolor też jest częścią doświadczenia użytkownika. Niebieski podkreślony tekst nadal jest najczytelniejszą konwencją linku webowego, ale generowane raporty czasem potrzebują spokojniejszego stylu. Jeśli używasz własnego koloru, zadbaj, aby otaczający tekst jasno mówił czytelnikowi, że element jest klikalny.
Lista kontrolna walidacji
- Używaj w pełni kwalifikowanych adresów HTTPS URL dla dokumentów publicznych.
- Waliduj adresy URL podane przez użytkowników przed zapisaniem ich w PDF.
- Testuj linki w więcej niż jednym PDF viewerze, ponieważ obsługa adnotacji może różnić się między czytnikami.
- Sprawdź klikalny obszar po zmianie rozmiaru strony, marginesów, fontów lub skalowania.
- Nie ukrywaj ważnych akcji workflow wyłącznie za tekstem linku; podaj kontekst w treści PDF.
Uwaga o SEO i dystrybucji dokumentów
Gdy pliki PDF są publikowane online, jasne etykiety linków pomagają użytkownikom i wyszukiwarkom zrozumieć relację między dokumentem a połączonym zasobem. Preferuj opisowy tekst, taki jak dokumentacja produktu lub portal supportu klienta, zamiast ogólnych etykiet typu kliknij tutaj.