Files
simple-react-app-kit/packages/media/docs/en-US/examples/asset-picker.mdx
T
2026-09-20 16:44:22 +08:00

35 lines
1.1 KiB
Plaintext

---
title: Asset picker
description: Reuse the media library as a controlled single- or multiple-selection dialog.
order: 30
toc:
- id: open-the-picker
title: Open the picker
- id: constrain-selection
title: Constrain selection
- id: consume-results
title: Consume results
---
## Open the picker {#open-the-picker}
`MediaPickerDialog` reuses the same adapter and folder model as the full library:
```tsx
import { MediaPickerDialog } from "@workspace/media"
;<MediaPickerDialog
open={open}
onOpenChange={setOpen}
onConfirm={(assets) => editor.insertImages(assets)}
/>
```
## Constrain selection {#constrain-selection}
Pass `allowedKinds={["image"]}` for an image-only workflow. The dialog selects one asset by default; pass `multiple` when the consumer accepts several assets, and provide `initialSelection` when editing an existing value.
## Consume results {#consume-results}
The confirmation callback receives complete `MediaAsset` records. Store the adapter-provided reference rather than a temporary preview URL when the result must survive signed-URL expiration.