# 配置 ConfigProvider

- 页面: https://jiguang132.com/zh/resources/ant-design-mobile/docs/config-provider
- 资源: Ant Design Mobile (https://jiguang132.com/zh/resources/ant-design-mobile.md)
- 全部指南: https://jiguang132.com/zh/resources/ant-design-mobile/docs.md

用于全局配置本地化文案和个性化图标。

## 安装

```bash
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 }` | - |

[zh-CN]: https://github.com/ant-design/ant-design-mobile/blob/master/src/locales/zh-CN.ts

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt