Sections
File Viewer
- Overview
- Anatomy
- Header
- Navigation
- Renderers
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 surroundingFileViewerProvider. - Targets the nearest
FileViewerframe — 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, andonClickprops; the toggle runs before anyonClickyou pass. - Only render it when
FileViewerContenthas aFileViewerSidebar— there is nothing to toggle otherwise.
API Reference
| Prop | Type | Description |
|---|---|---|
...props | ButtonProps | Button props (variant, size, className, onClick, …). The trigger toggles the nearest sidebar in addition to any handler you pass. |
Source
file-viewer.tsx
"use client";
export type { ViewerSource } from "./file-viewer-core";
export {
FileViewerContent,
FileViewerInset,
FileViewerLegend,
FileViewerViewport,
type FileViewerContentProps,
type FileViewerInsetProps,
type FileViewerLegendProps,
type FileViewerViewportProps,