Document list
<sea-file-browser> lists source documents for the bound outputs. Use view="list" and selection-only to make it a selector beside data and source viewers.
| Integration | Entry |
|---|---|
| React | SeaFileBrowser from @sea-dev/widget-lit/react/file-browser |
| Without React | @sea-dev/widget-lit/file-browser |
html
<sea-file-browser
step-label="data"
view="list"
selection-only
></sea-file-browser>Place it inside a process and Sea context, with the page API host configured before mounting. It shares the selected output and document with sibling widgets. When a document belongs to several matching outputs, choose an output first. Without selection-only, opening a file displays its preview in a dialog.
Attributes and properties
| Property | Attribute | Type | Default | Description |
|---|---|---|---|---|
stepLabel | step-label | string or undefined | — | Selects one step by its unique pipeline label within the enclosing process. |
stepRole | step-role | PipelineStepRoleWire or undefined | — | Constrains the selected step to this execution role. |
stepId | step-id | string or undefined | — | Selects a pipeline step definition within the enclosing process. |
runStepId | run-step-id | string or undefined | — | Selects one executable step instance within the enclosing process. |
outputFormId | output-form-id | string or undefined | — | Narrows the selected step's outputs to this form. |
outputSubmissionId | output-submission-id | string or undefined | — | Selects an exact output submission from the enclosing process. |
workerUrl | worker-url | string | "" | Sets the PDF.js worker URL for document previews. |
view | view | BrowserView | "icon" | Selects the document list or icon grid. |
selectionOnly | selection-only | boolean | false | Selects documents for sibling viewers without opening a preview overlay. |
Events
| Event | Type | Description |
|---|---|---|
citation-selected | CustomEvent | { citationId, documentExtractionId } when a document is selected. |
file-action | CustomEvent | { action, file } after a supported file action. |
file-opened | CustomEvent | { file } containing the selected backend document. |
Styling parts
| Part | Description |
|---|---|
root | The document browser container. |
toolbar | The document heading and view controls. |
content | The scrollable document area. |
list | The document list or grid. |
item | An individual document. |
status | Loading, empty and error messages. |
Use a host class to set the panel's width and height. Layout and parts covers CSS Grid, tokens and ::part().