Skip to main content

A PDF viewer for nicegui based on pdf.js

Project description

nicegui-pdf

A NiceGUI PDF component (using pdf.js) to nicely integrate PDFs without the need for iframes without having any control on which page is shown or without the possibility to read the seelcted text. Install with

pip install nicegui-pdf

A quick example on how to use the component is given next:

from nicegui import ui, app
from nicegui_pdf import PdfViewer

# [...] 

state = {
    "current_page": 1,
}

# [...]

ui.number().bind_value(state, "current_page")

path = app.add_static_file(local_file="example/paper.pdf")
PdfViewer(path).classes("w-full").style(
    "border: solid 1px gray;"
).bind_current_page(
    state
)

Features

  • Full integration of PDF files into NiceGUI
  • Two-way binding of current_page
  • One-way binidng of num_pages, is_rendering and selected_text

A full example demonstrating all features is given in example/main.py:

table

ToDo's

  • Integrate pdf.js and add a basic PDF viewer
  • Bind current page
  • Implement text overlay for selected text
  • Bind to selected text
  • Bind number of pages
  • Binding for is rendering
  • Resize PDF on window resize
  • Bind path (load new pdf document)

Optional

  • Highlight text
  • Show outline

Disclaimer

I'm neither a JS, NiceGUI or VUE expert. I simply tested a few things and found that an older version of PDF.js can be integrated as a custom NiceGUI component. Therefore, I cannot give any warranty etc. but still I'm trying to maintain this code. If you find any bugs or have feature requests, please open an issue or a pull request.

Donate

If you like it and want to buy me a coffee:

Thank you so much!

References

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nicegui_pdf-0.0.6.tar.gz (408.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nicegui_pdf-0.0.6-py3-none-any.whl (410.9 kB view details)

Uploaded Python 3

File details

Details for the file nicegui_pdf-0.0.6.tar.gz.

File metadata

  • Download URL: nicegui_pdf-0.0.6.tar.gz
  • Upload date:
  • Size: 408.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for nicegui_pdf-0.0.6.tar.gz
Algorithm Hash digest
SHA256 29d3a48b596d3526188bce3880033446e958073258fc9d0b09aec5752f6cefb4
MD5 e2434d2aad49869757836a6b46d1d31c
BLAKE2b-256 a9046554c35b54e9cb4936a46a4b65f443d1141077410418b77432b2284bf648

See more details on using hashes here.

File details

Details for the file nicegui_pdf-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: nicegui_pdf-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 410.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for nicegui_pdf-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 6f01e7500cf0f1fb03b906026cea0284512c4fc86cdab31c049aae198d9afd4e
MD5 a1742e4c950a110abaa735caf8c8c5a7
BLAKE2b-256 5c2a2c7f4e78d39bb94bc5f556f724ad8ef60d8a5be960112336fe8bc953a617

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page