2018-11-26 12:06:42 +08:00
|
|
|
|
---
|
|
|
|
|
category: Components
|
|
|
|
|
subtitle: 全局化配置
|
2022-11-09 12:28:04 +08:00
|
|
|
|
group: 其他
|
2018-11-26 12:06:42 +08:00
|
|
|
|
title: ConfigProvider
|
2022-11-30 20:14:41 +08:00
|
|
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*NVKORa7BCVwAAAAAAAAAAAAADrJ8AQ/original
|
2018-11-26 12:06:42 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
为组件提供统一的全局化配置。
|
|
|
|
|
|
|
|
|
|
## 使用
|
|
|
|
|
|
|
|
|
|
ConfigProvider 使用 React 的 [context](https://facebook.github.io/react/docs/context.html) 特性,只需在应用外围包裹一次即可全局生效。
|
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
import { ConfigProvider } from 'antd';
|
|
|
|
|
|
|
|
|
|
// ...
|
|
|
|
|
|
2020-08-03 14:35:11 +08:00
|
|
|
|
export default () => (
|
|
|
|
|
<ConfigProvider direction="rtl">
|
2018-11-26 12:06:42 +08:00
|
|
|
|
<App />
|
|
|
|
|
</ConfigProvider>
|
|
|
|
|
);
|
|
|
|
|
```
|
|
|
|
|
|
2019-01-09 20:15:37 +08:00
|
|
|
|
### Content Security Policy
|
|
|
|
|
|
|
|
|
|
部分组件为了支持波纹效果,使用了动态样式。如果开启了 Content Security Policy (CSP),你可以通过 `csp` 属性来进行配置:
|
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
<ConfigProvider csp={{ nonce: 'YourNonceCode' }}>
|
|
|
|
|
<Button>My Button</Button>
|
|
|
|
|
</ConfigProvider>
|
|
|
|
|
```
|
|
|
|
|
|
2022-11-09 12:28:04 +08:00
|
|
|
|
## 代码演示
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
<!-- prettier-ignore -->
|
2022-11-09 12:28:04 +08:00
|
|
|
|
<code src="./demo/locale.tsx">国际化</code>
|
|
|
|
|
<code src="./demo/direction.tsx">方向</code>
|
|
|
|
|
<code src="./demo/size.tsx">组件尺寸</code>
|
|
|
|
|
<code src="./demo/theme.tsx">主题</code>
|
|
|
|
|
<code src="./demo/prefixCls.tsx" debug>前缀</code>
|
|
|
|
|
|
2018-11-26 12:06:42 +08:00
|
|
|
|
## API
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| autoInsertSpaceInButton | 设置为 `false` 时,移除按钮中 2 个汉字之间的空格 | boolean | true | |
|
|
|
|
|
| componentDisabled | 设置 antd 组件禁用状态 | boolean | - | 4.21.0 |
|
|
|
|
|
| componentSize | 设置 antd 组件大小 | `small` \| `middle` \| `large` | - | |
|
|
|
|
|
| csp | 设置 [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) 配置 | { nonce: string } | - | |
|
|
|
|
|
| direction | 设置文本展示方向。 [示例](#components-config-provider-demo-direction) | `ltr` \| `rtl` | `ltr` | |
|
|
|
|
|
| dropdownMatchSelectWidth | 下拉菜单和选择器同宽。默认将设置 `min-width`,当值小于选择框宽度时会被忽略。`false` 时会关闭虚拟滚动 | boolean \| number | - | 4.3.0 |
|
2022-12-13 15:49:05 +08:00
|
|
|
|
| form | 设置 Form 组件的通用属性 | { validateMessages?: [ValidateMessages](/components/form-cn#validateMessages), requiredMark?: boolean \| `optional`, colon?: boolean} | - | requiredMark: 4.8.0; colon: 4.18.0 |
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| getPopupContainer | 弹出框(Select, Tooltip, Menu 等等)渲染父节点,默认渲染到 body 上。 | function(triggerNode) | () => document.body | |
|
|
|
|
|
| getTargetContainer | 配置 Affix、Anchor 滚动监听容器。 | () => HTMLElement | () => window | 4.2.0 |
|
|
|
|
|
| iconPrefixCls | 设置图标统一样式前缀 | string | `anticon` | 4.11.0 |
|
|
|
|
|
| input | 设置 Input 组件的通用属性 | { autoComplete?: string } | - | 4.2.0 |
|
2022-12-14 10:22:17 +08:00
|
|
|
|
| select | 设置 Select 组件的通用属性 | { showSearch?: boolean } | - | |
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| locale | 语言包配置,语言包可到 [antd/locale](http://unpkg.com/antd/locale/) 目录下寻找 | object | - | |
|
|
|
|
|
| prefixCls | 设置统一样式前缀 | string | `ant` | |
|
2022-12-13 15:49:05 +08:00
|
|
|
|
| renderEmpty | 自定义组件空状态。参考 [空状态](/components/empty-cn) | function(componentName: string): ReactNode | - | |
|
|
|
|
|
| space | 设置 Space 的 `size`,参考 [Space](/components/space-cn) | { size: `small` \| `middle` \| `large` \| `number` } | - | 4.1.0 |
|
2022-11-24 11:26:38 +08:00
|
|
|
|
| theme | 设置主题,参考 [定制主题](/docs/react/customize-theme-cn) | - | - | 5.0.0 |
|
2022-11-17 17:31:26 +08:00
|
|
|
|
| virtual | 设置 `false` 时关闭虚拟滚动 | boolean | - | 4.3.0 |
|
2019-11-09 16:24:07 +08:00
|
|
|
|
|
2021-02-09 21:49:15 +08:00
|
|
|
|
### ConfigProvider.config() `4.13.0+`
|
|
|
|
|
|
2021-03-16 09:33:16 +08:00
|
|
|
|
设置 `Modal`、`Message`、`Notification` rootPrefixCls。
|
2021-02-09 21:49:15 +08:00
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
ConfigProvider.config({
|
2021-06-09 15:36:59 +08:00
|
|
|
|
prefixCls: 'ant', // 4.13.0+
|
|
|
|
|
iconPrefixCls: 'anticon', // 4.17.0+
|
2021-02-09 21:49:15 +08:00
|
|
|
|
});
|
|
|
|
|
```
|
|
|
|
|
|
2019-11-09 16:24:07 +08:00
|
|
|
|
## FAQ
|
|
|
|
|
|
2020-05-27 20:05:13 +08:00
|
|
|
|
#### 如何增加一个新的语言包?
|
|
|
|
|
|
|
|
|
|
参考[《增加语言包》](/docs/react/i18n#%E5%A2%9E%E5%8A%A0%E8%AF%AD%E8%A8%80%E5%8C%85)。
|
|
|
|
|
|
2022-07-12 13:10:20 +08:00
|
|
|
|
#### 为什么时间类组件的国际化 locale 设置不生效?
|
2019-11-09 16:24:07 +08:00
|
|
|
|
|
2022-07-12 13:10:20 +08:00
|
|
|
|
参考 FAQ [为什么时间类组件的国际化 locale 设置不生效?](/docs/react/faq#为什么时间类组件的国际化-locale-设置不生效?)。
|
2019-12-09 19:40:43 +08:00
|
|
|
|
|
|
|
|
|
#### 配置 `getPopupContainer` 导致 Modal 报错?
|
|
|
|
|
|
2020-10-21 10:33:43 +08:00
|
|
|
|
相关 issue:<https://github.com/ant-design/ant-design/issues/19974>
|
2019-12-09 19:40:43 +08:00
|
|
|
|
|
|
|
|
|
当如下全局设置 `getPopupContainer` 为触发节点的 parentNode 时,由于 Modal 的用法不存在 `triggerNode`,这样会导致 `triggerNode is undefined` 的报错,需要增加一个[判断条件](https://github.com/afc163/feedback-antd/commit/3e4d1ad1bc1a38460dc3bf3c56517f737fe7d44a)。
|
|
|
|
|
|
|
|
|
|
```diff
|
|
|
|
|
<ConfigProvider
|
|
|
|
|
- getPopupContainer={triggerNode => triggerNode.parentNode}
|
|
|
|
|
+ getPopupContainer={node => {
|
|
|
|
|
+ if (node) {
|
|
|
|
|
+ return node.parentNode;
|
|
|
|
|
+ }
|
|
|
|
|
+ return document.body;
|
|
|
|
|
+ }}
|
|
|
|
|
>
|
|
|
|
|
<App />
|
|
|
|
|
</ConfigProvider>
|
|
|
|
|
```
|
2022-11-29 10:39:57 +08:00
|
|
|
|
|
|
|
|
|
#### 为什么 message.info、notification.open 或 Modal.confirm 等方法内的 ReactNode 无法继承 ConfigProvider 的属性?比如 `prefixCls` 和 `theme`。
|
|
|
|
|
|
|
|
|
|
静态方法是使用 ReactDOM.render 重新渲染一个 React 根节点上,和主应用的 React 节点是脱离的。我们建议使用 useMessage、useNotification 和 useModal 来使用相关方法。原先的静态方法在 5.0 中已被废弃。
|
2022-12-13 18:07:28 +08:00
|
|
|
|
|
|
|
|
|
#### Vite 生产模式打包后国际化 locale 设置不生效?
|
|
|
|
|
|
|
|
|
|
相关 issue:[#39045](https://github.com/ant-design/ant-design/issues/39045)
|
|
|
|
|
|
|
|
|
|
由于 Vite 生产模式下打包与开发模式不同,cjs 格式的文件会多一层,需要 `zhCN.default` 来获取。推荐 Vite 用户直接从 `antd/es/locale` 目录下引入 esm 格式的 locale 文件。
|