PageView class

A widget that renders a single page of a PdfDocument.

PageView is a stateful widget that accepts a PdfDocument and a pageIndex. On build it calls PdfDocument.getPageSize to derive the aspect ratio, then PdfDocument.renderPageToBytes at the widget's full available width (fit-to-width). The logical width is multiplied by MediaQuery.devicePixelRatioOf to produce sharp output on high-DPI displays.

A CircularProgressIndicator is shown while the render is in flight. The last successfully rendered ui.Image is cached and reused to avoid re-rendering on cosmetic rebuilds. Re-rendering is triggered only when pageIndex changes or the available width changes by more than 2 logical pixels.

Example

PageView(
  document: doc,
  pageIndex: 0,
  options: RenderOptions(renderAnnotations: false),
)

Resource management

The widget disposes each ui.Image it owns when it is replaced by a new render or when the widget is disposed. The PdfDocument itself is owned by the caller and is not closed by this widget.

Error handling

Render errors (RangeError, StateError, PdfiumException) are caught and displayed as a centred error message. The widget does not rethrow.

Accessibility

The rendered page canvas is wrapped in a Semantics widget labelled as an image. Provide a meaningful semanticLabel when the document content is known (e.g. the file name). Loading and error states are also labelled.