Guides

Reader 状态与界面回调

使用以下 CPDFReaderView Props 响应 Reader 状态和界面操作。

Reader 与查看器回调

回调	参数	触发时机
onViewCreated	无	Reader 就绪；后续 API 可通过 ref.current 调用。
onPageChanged	pageIndex: number	当前页面变化。
onSaveDocument	无	Reader 报告保存事件。
onPageEditDialogBackPress	无	点击页面编辑界面的返回按钮。
onFullScreenChanged	isFullScreen: boolean	全屏状态变化。
onTapMainDocArea	无	点击 PDF 页面主区域。
onIOSClickBackPressed	无	点击 iOS Reader 的返回按钮。
onSearchBackButtonTapped	无	点击搜索界面的返回按钮。
onAddWatermarkDialogDismissed	无	添加水印面板关闭。

onSaveDocument 的类型为 () => void，不提供成功状态、路径或 URI。应用主动保存并需要结果时，使用 await pdfReaderRef.current?.save() 返回的 Promise<boolean>。

<CPDFReaderView
  ref={pdfReaderRef}
  document={samplePDF}
  configuration={configuration}
  onViewCreated={() => {
    console.log("Reader is ready");
  }}
  onPageChanged={(pageIndex) => {
    console.log("Current page index:", pageIndex);
  }}
  onSaveDocument={() => {
    console.log("Native Reader reported a save event");
  }}
  onFullScreenChanged={(isFullScreen) => {
    console.log("Full screen:", isFullScreen);
  }}
  onIOSClickBackPressed={() => {
    console.log("iOS Reader back button tapped");
  }}
/>

Props 回调跟随 CPDFReaderView 生命周期，不使用 removeEventListener()。