---
url: /components/import-export-panel.md
---
# ImportExportPanel 导入导出面板

批量导入与数据导出的双分区面板。组件本身不执行网络 IO：选择文件后 emit `import-file`、点击格式按钮 emit `export`，由消费方完成上传/导出后调用 `done(kind)` 收尾。

状态流转：

* 选择文件后面板进入导入中（按钮显示导入中并禁用重复选择），移除文件会自动复位；
* 点击任一导出按钮后导出按钮组整体禁用；
* 两种状态都只能由消费方调用 `done('import' | 'export')` 结束——校验失败要立即 `done('import')`，否则按钮一直转圈。

## 基础用法

## 导入回调与错误处理

完整闭环示例：`import-file` 的参数是文件描述对象 `{ name, size, raw }`；先做类型/大小校验，失败立即 `done('import')` 复位，成功则模拟上传后再收尾。

## 自定义文案与格式按钮

`formats` 声明导出格式按钮组（默认 `[xlsx, csv]`），`default-format` 高亮默认项；`accept`、`import-button-text`、分区标题都可定制，例如改成压缩包素材导入。

## 导出区扩展内容

`export-extra` 插槽渲染在导出按钮组下方，适合补充导出范围说明或后台任务提示。

## API