配置 ConfigProvider
用于全局配置本地化文案和个性化图标。
安装
npm install antd-mobile@5.43.0
antd-mobile 是移动网页组件库,不是 React Native 或小程序组件。React 19 项目需在入口用 unstableSetRender 注册 createRoot,否则 Toast、Dialog 等命令式 API 无法渲染;深色模式通过 <html data-prefers-color-scheme="dark"> 切换。
示例来自 Ant Design Mobile 官方仓库(MIT),固定在 npm 5.43.0 对应的提交;示例中的 DemoBlock 等展示辅助组件由 JGuang 重写,不属于 antd-mobile 的 API。
用于全局配置本地化文案和个性化图标。
何时使用
- 您想使用除英文之外的语言。
- 您想使用自己的图标集,而不是内置的
antd-mobile-icons。
示例
ConfigProvider
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| locale | 本地化文案 | Locale | zh-CN |
| checkList | CheckList 配置 | { activeIcon?: ReactNode } | - |
| collapse | Collapse 配置 | { arrowIcon?: ReactNode | ((active: boolean) => ReactNode) } | - |
| dropdown | Dropdown 配置 | { arrowIcon?: ReactNode } | - |
| form | Form 配置 | { helpIcon?: ReactNode } | - |
| input | Input 配置 | { clearIcon?: ReactNode } | - |
| list | List 配置 | { arrowIcon?: ReactNode } | - |
| navBar | NavBar 配置 | { backIcon?: ReactNode } | - |
| noticeBar | NoticeBar 配置 | { icon?: ReactNode, closeIcon?: ReactNode } | - |
| popup | Popup 配置 | { closeIcon?: ReactNode } | - |
| result | Result 配置 | { successIcon?: ReactNode, errorIcon?: ReactNode, infoIcon?: ReactNode, waitingIcon?: ReactNode, warningIcon?: ReactNode } | - |
| searchBar | SearchBar 配置 | { searchIcon?: ReactNode } | - |