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)
  • Highlight text (not 100% sure yet)

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.5.tar.gz (408.5 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.5-py3-none-any.whl (411.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for nicegui_pdf-0.0.5.tar.gz
Algorithm Hash digest
SHA256 c389d4f51303cea321ecc280237766ac3c195d637263a4e776db49ee569d506e
MD5 5b85238e677df0a7ae50d4d988ab29d6
BLAKE2b-256 118e047ca0cf61db267eefd56abf1e21139fe3799d051837cd66b136aa9c3469

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for nicegui_pdf-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7651406b7e37d07a9d8b165b84be95f715ed47a3a9dcdb47bb815dce589d2439
MD5 ac4476264c01b632c6096c9ef8d769f8
BLAKE2b-256 770a5d96167cb063901114bcc9cf50a02580301ded745f40cb70feebea56693b

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