mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-04 13:08:41 +08:00
fee211e3c4
close #19974
2.6 KiB
2.6 KiB
category | type | cols | title |
---|---|---|---|
Components | Other | 1 | ConfigProvider |
ConfigProvider
provides a uniform configuration support for components.
Usage
This component provides a configuration to all React components underneath itself via the context API. In the render tree all components will have access to the provided config.
import { ConfigProvider } from 'antd';
// ...
return (
<ConfigProvider {...yourConfig}>
<App />
</ConfigProvider>
);
Content Security Policy
Some components use dynamic style to support wave effect. You can config csp
prop if Content Security Policy (CSP) is enabled:
<ConfigProvider csp={{ nonce: 'YourNonceCode' }}>
<Button>My Button</Button>
</ConfigProvider>
API
Property | Description | Type | Default | Version |
---|---|---|---|---|
autoInsertSpaceInButton | Set false to remove space between 2 chinese characters on Button |
boolean | true | 3.13.0 |
csp | Set Content Security Policy config | { nonce: string } | - | 3.13.1 |
renderEmpty | set empty content of components. Ref Empty | Function(componentName: string): ReactNode | - | 3.12.2 |
getPopupContainer | to set the container of the popup element. The default is to create a div element in body . |
Function(triggerNode) | () => document.body |
3.11.0 |
locale | language package setting, you can find the packages in antd/es/locale | object | 3.21.0 | |
prefixCls | set prefix class | string | ant | 3.12.0 |
pageHeader | Unify the ghost of pageHeader ,Ref [pageHeader](<(/components/page-header)> | { ghost:boolean } | 'true' | 3.24.0 |
FAQ
Does the locale problem still exist in DatePicker even if ConfigProvider locale
is used?
Please make sure you set moment locale by moment.locale('zh-cn')
or that you don't have two different versions of moment.
Modal throw error when setting getPopupContainer
?
Related issue: https://github.com/ant-design/ant-design/issues/19974
When you config getPopupContainer
to parentNode globally, Modal will throw error of triggerNode is undefined
because it did not have a triggerNode. You can try the fix below.
<ConfigProvider
- getPopupContainer={triggerNode => triggerNode.parentNode}
+ getPopupContainer={node => {
+ if (node) {
+ return node.parentNode;
+ }
+ return document.body;
+ }}
>
<App />
</ConfigProvider>