ant-design/components/config-provider/index.zh-CN.md

category	subtitle	cols	type	title
Components	全局化配置	1	其他	ConfigProvider

为组件提供统一的全局化配置。

使用

ConfigProvider 使用 React 的 context 特性，只需在应用外围包裹一次即可全局生效。

import { ConfigProvider } from 'antd';

// ...

return (
  <ConfigProvider {...yourConfig}>
    <App />
  </ConfigProvider>
);

Content Security Policy

部分组件为了支持波纹效果，使用了动态样式。如果开启了 Content Security Policy (CSP)，你可以通过 csp 属性来进行配置：

<ConfigProvider csp={{ nonce: 'YourNonceCode' }}>
  <Button>My Button</Button>
</ConfigProvider>

API

参数	说明	类型	默认值	版本
autoInsertSpaceInButton	设置为 false 时，移除按钮中 2 个汉字之间的空格	boolean	true
componentSize	设置 antd 组件大小	`small	middle	large`
csp	设置 Content Security Policy 配置	{ nonce: string }	-
form	设置 Form 组件的通用属性	{ validateMessages?: ValidateMessages }	-
renderEmpty	自定义组件空状态。参考 空状态	Function(componentName: string): ReactNode	-
getPopupContainer	弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。	Function(triggerNode)	() => document.body
locale	语言包配置，语言包可到 antd/es/locale 目录下寻找	object	-
prefixCls	设置统一样式前缀	string	ant
pageHeader	统一设置 pageHeader 的 ghost，参考 pageHeader	{ ghost: boolean }	'true'
direction	设置文本展示方向。 示例	string: '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 的报错，需要增加一个判断条件。

 <ConfigProvider
-  getPopupContainer={triggerNode => triggerNode.parentNode}
+  getPopupContainer={node => {
+    if (node) {
+      return node.parentNode;
+    }
+    return document.body;
+  }}
 >
   <App />
 </ConfigProvider>