|
|
|
|
---
|
|
|
|
|
category: Components
|
|
|
|
|
subtitle: 全局化配置
|
|
|
|
|
cols: 1
|
|
|
|
|
type: 其他
|
|
|
|
|
title: ConfigProvider
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
为组件提供统一的全局化配置。
|
|
|
|
|
|
|
|
|
|
## 使用
|
|
|
|
|
|
|
|
|
|
ConfigProvider 使用 React 的 [context](https://facebook.github.io/react/docs/context.html) 特性，只需在应用外围包裹一次即可全局生效。
|
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
import { ConfigProvider } from 'antd';
|
|
|
|
|
|
|
|
|
|
// ...
|
|
|
|
|
|
|
|
|
|
return (
|
|
|
|
|
<ConfigProvider {...yourConfig}>
|
|
|
|
|
<App />
|
|
|
|
|
</ConfigProvider>
|
|
|
|
|
);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Content Security Policy
|
|
|
|
|
|
|
|
|
|
部分组件为了支持波纹效果，使用了动态样式。如果开启了 Content Security Policy (CSP)，你可以通过 `csp` 属性来进行配置：
|
|
|
|
|
|
|
|
|
|
```jsx
|
|
|
|
|
<ConfigProvider csp={{ nonce: 'YourNonceCode' }}>
|
|
|
|
|
<Button>My Button</Button>
|
|
|
|
|
</ConfigProvider>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
|
| autoInsertSpaceInButton | 设置为 `false` 时，移除按钮中 2 个汉字之间的空格 | boolean | true | |
|
|
|
|
|
| componentSize | 设置 antd 组件大小 | `small` \| `middle` \| `large` | - | |
|
|
|
|
|
| csp | 设置 [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) 配置 | { nonce: string } | - | |
|
|
|
|
|
| form | 设置 Form 组件的通用属性 | { validateMessages?: [ValidateMessages](/components/form/#validateMessages) } | - | |
|
|
|
|
|
| renderEmpty | 自定义组件空状态。参考 [空状态](/components/empty/) | Function(componentName: string): ReactNode | - | |
|
|
|
|
|
| getPopupContainer | 弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。 | Function(triggerNode) | () => document.body | |
|
|
|
|
|
| locale | 语言包配置，语言包可到 [antd/es/locale](http://unpkg.com/antd/es/locale/) 目录下寻找 | object | - | |
|
|
|
|
|
| prefixCls | 设置统一样式前缀。`注意：这将不会应用由 antd 提供的默认样式`| string | ant | |
|
|
|
|
|
| pageHeader | 统一设置 pageHeader 的 ghost，参考 [pageHeader](<(/components/page-header)>) | { ghost: boolean } | 'true' | |
|
|
|
|
|
| direction | 设置文本展示方向。 [示例](#components-config-provider-demo-direction) | `ltr` \| `rtl` | `ltr` | |
|
|
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
|
|
|
|
#### 为什么我使用了 ConfigProvider `locale`，时间类组件的国际化还有问题？
|
|
|
|
|
|
|
|
|
|
请检查是否设置了 `moment.locale('zh-cn')`，或者是否有两个版本的 moment 共存。
|
|
|
|
|
|
|
|
|
|
#### 配置 `getPopupContainer` 导致 Modal 报错？
|
|
|
|
|
|
|
|
|
|
相关 issue：https://github.com/ant-design/ant-design/issues/19974
|
|
|
|
|
|
|
|
|
|
当如下全局设置 `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>
|
|
|
|
|
```
|
