API Reference

@univerjs-pro/pdfs-ui

Canvas rendering and editing UI for Web SDK PDF units, including the PDF View ribbon and virtual continuous scrolling.

TypeScript
import { UniverPdfsUIPlugin } from '@univerjs-pro/pdfs-ui'import '@univerjs-pro/pdfs-ui/lib/index.css'univer.registerPlugin(UniverPdfsUIPlugin, {  editor: { enabled: true },  thumbnailWorkerURL: new Worker(new URL('./pdf-thumbnail.worker.ts', import.meta.url), { type: 'module' }),})

editor.enabled defaults to true and controls whether the plugin registers PDF editing commands, clipboard handling, the ribbon, the inspector, and thumbnail actions. thumbnailWorkerURL accepts a string, URL, or Worker for OffscreenCanvas thumbnail rendering.

Create the worker entry referenced above:

TypeScript
import { startPdfPageThumbnailWorker } from '@univerjs-pro/pdfs-ui'startPdfPageThumbnailWorker()

Configure the shared Ribbon through UniverUIPlugin's menu and ribbonType options. They are not options of UniverPdfsUIPlugin. For example, pdf.menu.tool.highlight and pdf.menu.tool.ink accept sibling order and Ribbon gridLayout overrides.

Import @univerjs/ui/facade to use FUniver.updateMenuConfig() at runtime. createMenu() and createSubmenu() also accept placement options. See the PDF menu guide for initialization and update examples.

The PDF Ribbon is registered only while editing is enabled. menu overrides do not enable it when editor.enabled is false.

Entry Points

  • Locale: @univerjs-pro/pdfs-ui/locale/*
  • Style: @univerjs-pro/pdfs-ui/lib/index.css
  • Worker runtime: startPdfPageThumbnailWorker from @univerjs-pro/pdfs-ui

The root entry also exports renderPdfPageToCanvas for rendering a PDF page into an existing canvas. See the PDF UI overview.

How is this guide?

© 2026 DreamNum Co., Ltd.