Atvērtā pirmkoda JavaScript PDF skatītāja bibliotēka
Bezmaksas un atvērtā pirmkoda JavaScript bibliotēka, lai skatītu PDF dokumentus.
Kas ir PDFObject?
PDFObject ir bezmaksas atvērtā koda JavaScript bibliotēka, kas izstrādāta PDF dokumentu iegulšanai tīmekļa lapās. Tas darbojas, ģenerējot HTML iegulšanas elementu un pēc tam integrējot to HTML struktūrā. Pēc tam iegulšanas elements atveido PDF dokumentu. PDFObject pats par sevi nav renderētājs; drīzāk tā koncentrējas uz iegultā elementa izveidi un ievietošanu HTML. Tas var izveidot iegulšanas elementus PDF failu parādīšanai pilnā izmērā vai noteiktās tīmekļa lapas sadaļās.
Tālāk ir norādītas dažas no galvenajām PDFObject funkcijām:
- Atkāpšanās mehānisms: PDFObject ir rezerves mehānisms, tāpēc gadījumos, kad pārlūkprogramma neatbalsta PDF failu iegulšanu, PDFObject automātiski aktivizē atkāpšanās loģiku, ļaujot izstrādātājiem pēc vajadzības nodrošināt saiti uz PDF vai jebkuru citu loģiku. .
- PDF.js integrācija: PDFObject nodrošina papildu integrāciju ar PDF.js, ļaujot izstrādātājiem iegult PDF failus neatkarīgi no pārlūkprogrammas noklusējuma PDF faila. skatītājs. Šī funkcija ir noderīga, ja pārlūkprogramma neatbalsta PDF dokumentu iegulšanu HTML.
- PDF atvērtie parametri: PDFObject atbalsta Adobe patentētos PDF atvērtos parametrus, kas ļauj izstrādātājiem norādīt parametrus PDF attēlošanai. Tas ietver tādas opcijas kā skata režīms un citi Adobe specifiski iestatījumi. Visus šos parametrus var atrast šeit.
Darba sākšana ar PDFObject
Mēs varam lejupielādēt PDFObject bibliotēku, izmantojot npm moduli:
Instalējiet, izmantojot NPM
npm i pdfobject
Iegult PDF failu HTML ar pārlūkprogrammas atbalsta verifikāciju
Mēs varam iegult PDF dokumentu HTML, izmantojot PDFObject bibliotēku. Sākotnēji mēs pārbaudīsim, vai pārlūkprogramma atbalsta PDF dokumenta iegulšanu HTML, izmantojot PDFObject bibliotēkas metodi supportsPDFs. Ja tas atgriež patieso vērtību, norādot, ka tas atbalsta PDF iegulšanu HTML, mēs iegulsim PDF failu HTML, izmantojot metodi embed("document_name.pdf","#elementid"). Šī funkcija ieguls PDF noteiktā HTML elementā. Pilna izmēra PDF iegulšanai mēs neminēsim nevienu elementa ID un izsauksim metodi kā embed("document_name.pdf"). Tomēr, ja tas atgriež nepatiesu, norādot, ka tas neatbalsta PDF iegulšanu HTML, pēc vajadzības pāriesim uz citu loģiku. Sīkāku informāciju skatiet tālāk norādītajā koda fragmentā.
Šī izvade parāda HTML iegulto PDF dokumentu:
Izveidojiet atkāpšanās mehānismu
Mēs varam izveidot rezerves mehānismu, iegulstot PDF tīmekļa lapā, izmantojot PDFObject, kas tiek aktivizēts, ja pārlūkprogramma neatbalsta PDF iegulšanu HTML. PDFObject izmanto parametru fallbackLink, kas satur alternatīvu loģiku, izsaucot funkciju iegult. Tātad, ja pārlūkprogramma neatbalsta PDF failu iegulšanu, fallbackLink esošais kods tiek izpildīts norādītajā elementā div. Sīkāku informāciju skatiet tālāk norādītajā koda fragmentā.
Izvades ekrānuzņēmumā tiek parādīts saturs, ko parāda atkāpšanās mehānisms. Atkāpšanās mehānisms tika aktivizēts, kad pārlūkprogramma neatbalstīja PDF failu iegulšanu HTML.
Iegult PDF ar Adobe PDF atvēršanas parametriem
Mēs varam iegult PDF failus kopā ar dažiem atvēršanas parametriem, izmantojot PDFObject bibliotēku. Mēs izmantosim metodi PDFObject.embed("mans fails.pdf", "#my-container", {pdfOpenParams: {parametri }}), lai iegultu PDF dokumentu HTML kopā ar sākuma parametriem. . Šie PDF atvērtie parametri ietver tādas funkcijas kā PDF faila atvēršana un ritināšana līdz noteiktam lappuses numuram. Sīkāku informāciju skatiet tālāk norādītajā koda fragmentā.
Šajā ekrānuzņēmumā ir redzams HTML kodā iegultais PDF dokuments ar papildu parametriem, kas liek iegulšanas elementam ritināt līdz 3. lappusei pēc tā renderēšanas:
Iegult PDF, integrējot PDF.js
Kā mēs zinām, PDFObject ir atkarīgs no pārlūkprogrammas atbalsta PDF failu iegulšanai HTML, taču tas nodrošina alternatīvu metodi PDF failu renderēšanai, ja pārlūkprogramma to neatbalsta. Alternatīva metode ir integrēt PDF.js ar PDFObject. Lai to izdarītu, mums mūsu serverī ir jāiestata PDF.js, un pēc tam mēs nodosim ForcePDFJS: true un PDFJS_URL: path/to/viewer.html/in/pdf. .js parametrus funkcijai embed.
Piezīme. Tālāk sniegtajā koda fragmenta piemērā esam izveidojuši un iniciējuši serveri, kurā ir PDF.js bibliotēka, tāpēc http://localhost:8888 norāda uz PDF.js bibliotēku.
Šis ekrānuzņēmums parāda atveidoto PDF dokumentu, integrējot PDFObject ar PDF.js:
Secinājums
Visbeidzot, PDFObject ir viegli lietojama JavaScript bibliotēka PDF dokumentu iegulšanai HTML. Lai gan tā nedarbojas kā renderētājs un paļaujas uz pārlūkprogrammas atbalstu iegulšanas elementiem, kas var izraisīt problēmas, piemēram, bojātu lietotāja interfeisu pārlūkprogrammās, kas neatbalsta iegulto elementu, taču bibliotēkai ir līdzekļi šādu problēmu risināšanai, izmantojot atbalsta noteikšanu iegulšanas elementu un atkāpšanās mehānismu. Mēs varam arī renderēt PDF failus pārlūkprogrammās, kas neatbalsta iegulšanas elementus, integrējot PDF.js ar PDFObject. Neskatoties uz ierobežojumiem, PDFObject izceļas kā vērtīgs rīks PDF dokumentu iegulšanai un renderēšanai tīmekļa lapās.
