DirectoryView
Folder is empty
Usage
API
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| items | Array | [] | Array of file/folder items |
| viewMode | String | "list" | Display mode: "list" or "grid" |
| busy | Boolean | false | Show loading state |
| editable | Boolean | true | Allow rename/edit operations |
| showSize | Boolean | false | Show size column |
| showOwner | Boolean | false | Show owner column |
| showModified | Boolean | false | Show modified date column |
| showStar | Boolean | false | Show star/favorite column |
| showShare | Boolean | false | Show share option |
| showExtract | Boolean | true | Show extract for archives |
| showNewFile | Boolean | true | Show "New File" menu option |
| showNewFolder | Boolean | true | Show "New Folder" menu option |
| showCut | Boolean | true | Show cut option |
| showCopy | Boolean | true | Show copy option |
| showPaste | Boolean | true | Show paste option |
| showRename | Boolean | true | Show rename option |
| showSelectAll | Boolean | true | Show select all option |
| showDownload | Boolean | true | Show download option |
| showDelete | Boolean | true | Show delete option |
| showUploadFile | Boolean | false | Show upload file menu option |
| showUploadFolder | Boolean | false | Show upload folder menu option |
| multiDownload | Boolean | false | Allow multi-file download |
| shareIndicatorProperty | String | "" | Item property name for share indicator |
| fallbackIcon | String | - | Fallback icon URL |
| ownersModel | Array | [] | Owner options for chown dialog |
| tr | Function | - | Translation function |
| dragScope | String | "" | Item drags are only accepted from DirectoryViews of the same scope, also in other browser windows |
Handler Props
| Prop | Signature | Description |
|---|---|---|
| deleteHandler | (items) => Promise | Handle deletion |
| changeOwnerHandler | (items, newOwnerUid) => Promise | Handle owner change |
| pasteHandler | (action, files, targetItem) => void | Handle paste |
| newFileHandler | () => void | Handle new file creation |
| newFolderHandler | () => void | Handle new folder creation |
| uploadFileHandler | () => void | Handle file upload |
| uploadFolderHandler | () => void | Handle folder upload |
| shareHandler | (item) => void | Handle share |
| starHandler | (item) => void | Handle star/favorite |
| dropHandler | (target, dataTransfer, selected, { payload, action }) => void | Handle drag-drop. selected is set for drags within this view, dataTransfer for external drops and payload for drags from another DirectoryView of the same scope. action is 'copy' when ctrl (option on macOS) is held, otherwise 'move' |
| dragPayloadHandler | (selected) => any | JSON serializable payload of an item drag, required for drops into other DirectoryViews |
| downloadHandler | (item|items) => void | Handle download |
| extractHandler | (item) => void | Handle archive extraction |
| refreshHandler | (item) => void | Handle refresh |
Item Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | String | Yes | Unique identifier |
| name | String | Yes | Display name |
| icon | String | Yes | Icon URL |
| previewUrl | String | Yes | Thumbnail URL (can be empty) |
| isDirectory | Boolean | No | Is folder |
| size | Number | No | File size in bytes |
| owner | String | No | Owner name |
| modified | Date | No | Last modified date |
| href | String | No | Link URL |
| target | String | No | Symlink target |
Events
| Event | Payload | Description |
|---|---|---|
| item-activated | Item object | Item double-clicked/activated |
| selectionChanged | Array of items | Selection changed |
| rename-requested | Item object | Rename requested via context menu |
Methods
| Method | Arguments | Description |
|---|---|---|
| highlight | (item) | Highlight and scroll to item |
| highlightByName | (name) | Highlight item by name |
| getSelected | - | Get selected items array |
Slots
| Slot | Description |
|---|---|
| empty | Empty state content |