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

使用

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

import React from 'react';
import { ConfigProvider } from 'antd';

// ...
const Demo: React.FC = () => (
  <ConfigProvider direction="rtl">
    <App />
  </ConfigProvider>
);

export default Demo;

Content Security Policy

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

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

代码演示

API

参数	说明	类型	默认值	版本
autoInsertSpaceInButton	设置为 false 时，移除按钮中 2 个汉字之间的空格	boolean	true
componentDisabled	设置 antd 组件禁用状态	boolean	-	4.21.0
componentSize	设置 antd 组件大小	small | middle | large	-
csp	设置 Content Security Policy 配置	{ nonce: string }	-
direction	设置文本展示方向。 示例	ltr | rtl	ltr
getPopupContainer	弹出框（Select, Tooltip, Menu 等等）渲染父节点，默认渲染到 body 上。	function(triggerNode)	() => document.body
getTargetContainer	配置 Affix、Anchor 滚动监听容器。	() => HTMLElement	() => window	4.2.0
iconPrefixCls	设置图标统一样式前缀	string	anticon	4.11.0
locale	语言包配置，语言包可到 antd/locale 目录下寻找	object	-
popupMatchSelectWidth	下拉菜单和选择器同宽。默认将设置 min-width，当值小于选择框宽度时会被忽略。false 时会关闭虚拟滚动	boolean | number	-	5.5.0
popupOverflow	Select 类组件弹层展示逻辑，默认为可视区域滚动，可配置成滚动区域滚动	'viewport' | 'scroll' 预览	'viewport'	5.5.0
prefixCls	设置统一样式前缀	string	ant
renderEmpty	自定义组件空状态。参考 空状态	function(componentName: string): ReactNode	-
theme	设置主题，参考 定制主题	Theme	-	5.0.0
virtual	设置 false 时关闭虚拟滚动	boolean	-	4.3.0
warning	设置警告等级，strict 为 false 时会将废弃相关信息聚合为单条信息	{ strict: boolean }	-	5.10.0

ConfigProvider.config()

设置 Modal、Message、Notification 静态方法配置，只会对非 hooks 的静态方法调用生效。

ConfigProvider.config({
  prefixCls: 'ant',
  iconPrefixCls: 'anticon',

  // 5.6.0+
  // 请优先考虑使用 hooks 版本
  theme: { token: { colorPrimary: 'red' } },
});

ConfigProvider.useConfig() 5.3.0+

5.2.0 版本后可用。获取父级 Provider 的值。如 DisabledContextProvider、SizeContextProvider。

const {
  componentDisabled, // 5.3.0+
  componentSize, // 5.3.0+
} = ConfigProvider.useConfig();

组件配置

FAQ

如何增加一个新的语言包？

参考《增加语言包》。

为什么时间类组件的国际化 locale 设置不生效？

参考 FAQ 为什么时间类组件的国际化 locale 设置不生效？。

配置 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>

为什么 message.info、notification.open 或 Modal.confirm 等方法内的 ReactNode 无法继承 ConfigProvider 的属性？比如 prefixCls 和 theme。

静态方法是使用 ReactDOM.render 重新渲染一个 React 根节点上，和主应用的 React 节点是脱离的。我们建议使用 useMessage、useNotification 和 useModal 来使用相关方法。原先的静态方法在 5.0 中已被废弃。

Vite 生产模式打包后国际化 locale 设置不生效？

相关 issue：#39045

由于 Vite 生产模式下打包与开发模式不同，cjs 格式的文件会多一层，需要 zhCN.default 来获取。推荐 Vite 用户直接从 antd/es/locale 目录下引入 esm 格式的 locale 文件。