Appearance
ConfigProvider 全局配置
用于为组件库提供文件预览、上传、国际化和弹层层级等全局配置。通常在应用根节点包裹一次，使内部组件共享同一份配置。
示例
弹层层级
使用 z-index 统一配置 Popover、Dialog、Message 等弹层组件的层级。
国际化
使用 locale 配置组件内置文案语言或覆盖文案。
文件相关配置
使用 file-preview 和 file-upload 为文件预览、上传组件提供全局能力。
API
Props
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| file-preview | 文件预览配置 | FilePreviewConfigContext | - |
| file-upload | 文件上传配置 | FileUploadConfigContext | - |
| locale | 国际化配置 | LocaleConfig | - |
| z-index | 弹层层级配置 | ZIndexConfig | - |
file-preview
| 字段名 | 说明 | 类型 |
|---|---|---|
| generatePreviewUrl | 根据文件原始地址生成预览地址 | (viewUrl: string, previewParams?: Record<string, string>) => string |
file-upload
| 字段名 | 说明 | 类型 |
|---|---|---|
| getToken | 获取上传鉴权 token | () => string |
| obsServerType | OBS 服务类型 | 'aws' | 'huawei' | 'auto' |
locale
| 字段名 | 说明 | 类型 |
|---|---|---|
| lang | 语言标识 | string |
z-index
| 字段名 | 说明 | 类型 | 默认层级 |
|---|---|---|---|
| popover | Popover 层级配置 | { zIndex?: number } | 5000 |
| dialog | Dialog 层级配置 | { zIndex?: number } | 2000 |
| message | Message 层级配置 | { zIndex?: number } | 8000 |
Events
该组件无自定义事件。
Slots
| 插槽名 | 说明 | 作用域参数 |
|---|---|---|
| default | 需要接收全局配置的内容 | - |
Exposes
该组件无 Exposes 暴露。
注意事项
- 建议在应用根节点统一包裹一次，避免配置分散。
- 弹层类组件较多时，通过
z-index统一规划层级。 - 文件上传配置通常包含鉴权能力，示例中的 token 仅用于展示结构，真实项目应由业务安全地获取。