feat(docs): add bilingual package documentation site

2026-09-20 15:53:28 +08:00
parent 60f6f1fb1a
commit dc80bd8ae0
111 changed files with 6531 additions and 0 deletions
@@ -0,0 +1,34 @@
+---
+title: 媒体库
+description: 提供存储 Adapter，并加入浏览、上传、文件夹和资源选择能力。
+order: 21
+toc:
+  - id: implement-the-adapter
+    title: 实现 Adapter
+  - id: provide-media
+    title: 提供媒体能力
+  - id: selection-flows
+    title: 选择流程
+---
+
+## 实现 Adapter {#implement-the-adapter}
+
+`MediaAdapter` 是媒体功能完整的持久化边界。通过产品存储服务实现查询、上传、文件夹、更新和删除操作。
+
+## 提供媒体能力 {#provide-media}
+
+在媒体界面外挂载一次 Adapter：
+
+```tsx
+import { MediaLibrary, MediaProvider } from "@workspace/blocks/media"
+
+;<MediaProvider adapter={mediaAdapter} notify={showNotice}>
+  <MediaLibrary />
+</MediaProvider>
+```
+
+可选的 `notify` 回调把操作结果转换为应用的 Toast 或通知。
+
+## 选择流程 {#selection-flows}
+
+单选或多选资源使用 `MediaPickerDialog`。`readMediaDimensions`、`formatMediaFileSize` 和 `defaultMediaReference` 覆盖上传与预览相关的常用展示工作。