GitHub

FileViewerSidebarTrigger

A button that toggles the nearest File Viewer sidebar.

FileViewerSidebarTrigger toggles the nearest FileViewerSidebar. Put it in FileViewerHeader, FileViewerControls, or another file-scoped control surface.

<FileViewerProvider source={source} defaultSidebarOpen>
  <FileViewer>
    <FileViewerHeader>
      <FileViewerSidebarTrigger />
      <FileViewerTitle />
      <FileViewerControls />
    </FileViewerHeader>
    <FileViewerContent>
      <FileViewerSidebar aria-label="PDF pages" />
      <FileViewerInset>
        <FileViewerViewport>
          <FileViewerDocument />
        </FileViewerViewport>
      </FileViewerInset>
    </FileViewerContent>
  </FileViewer>
</FileViewerProvider>

Behavior

  • Renders a data-slot="file-viewer-sidebar-trigger" button that flips the open/collapsed state supplied by the surrounding FileViewerProvider.
  • Targets the nearest FileViewer frame — nested file viewers each keep their own provider-backed sidebar state.
  • It is a thin wrapper over the button primitive, so it accepts the usual variant, size, className, and onClick props; the toggle runs before any onClick you pass.
  • Only render it when FileViewerContent has a FileViewerSidebar — there is nothing to toggle otherwise.

API Reference

PropTypeDescription
...propsButtonPropsButton props (variant, size, className, onClick, …). The trigger toggles the nearest sidebar in addition to any handler you pass.

Source

file-viewer.tsx