DirectoryList
Card-wrapped directory listing with loading, error, and empty states
DirectoryList
Card-wrapped directory listing with loading, error, and empty states
Source: packages/appkit-ui/src/react/file-browser/directory-list.tsx
Props
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
entries | DirectoryEntry[] | ✓ | - | Directory entries to display |
loading | boolean | - | Whether the directory is currently loading | |
error | string | null | - | Error message to display | |
onEntryClick | (entry: DirectoryEntry) => void | ✓ | - | Called when an entry is clicked |
onNavigateToParent | (() => void) | - | Called when the back/parent button is clicked | |
onRetry | (() => void) | - | Called when the retry button is clicked | |
isAtRoot | boolean | - | Whether the user is at the root directory (hides back button) | |
selectedPath | string | null | - | Currently selected file path for highlighting | |
resolveEntryPath | (entry: DirectoryEntry) => string | ✓ | - | Resolves a DirectoryEntry to its full path |
headerContent | ReactNode | - | Content rendered between the back button and the entry list (e.g., NewFolderInput) | |
hasCurrentPath | boolean | - | Whether a current path is set (affects empty state message) | |
formatSize | ((bytes: number) => string) | - | Custom file size formatter | |
labels | Pick<FileBrowserLabels, "backToParent" | "emptyDirectory" | "noVolumeConfigured" | "retry"> | - | Customizable labels |
Usage
import { DirectoryList } from '@databricks/appkit-ui';
<DirectoryList /* props */ />