FAQ
以下整理了一些 Infra Design 社区常见的问题和官方答复,在提问之前建议找找有没有类似的问题。此外我们也维护了一个反馈较多 FAQ issues 标签 亦可参考。
- 你们会提供 Sass/Stylus 等格式的样式文件吗?
undefined
和null
在antd
的受控组件中有区别吗?- 当我点击
Select Dropdown DatePicker TimePicker Popover Popconfirm
内的另一个 popup 组件时它会消失,如何解决? Select Dropdown DatePicker TimePicker Popover Popconfirm
会跟随滚动条上下移动?- 如何修改 Ant Design 的默认主题?
- 如何修改 Ant Design 组件的默认样式?
- 如何使用 Day.js 替换 Moment.js 来减小打包大小?
- 当我动态改变
defaultValue
的时候它并没有生效。 - 为什么修改组件传入的对象或数组属性组件不会更新?
- 当我设置了
Input
/Select
等的value
时它就无法修改了。 - 多个组件放一排时没有垂直对齐怎么办?
- antd 覆盖了我的全局样式!
- 我没法安装
antd
和antd
的依赖,顺便提一句,我在中国大陆。 - 我在 package.json 里将
dependencies.antd
添加到了 git repository 中,但是没有用。 message
和notification
是小写的,但是其他的组件都是首字母大写的,这是手滑吗?antd
在移动端体验不佳。antd
是否有国内镜像?antd
可以像React
那样使用单文件引入吗?- 在我的网络环境下没法获取到
icon
文件。 - 如何拓展 antd 的组件?
- 我的组件默认语言是英文的?如何切回中文的。
- 为什么时间类组件的国际化 locale 设置不生效?
- 开启了 Content Security Policy (CSP) 如何处理动态样式?
- 当我指定了 DatePicker/RangePicker 的
mode
属性后,点击后无法选择年份/月份? - ConfigProvider 设置
prefixCls
后,message/notification/Modal.confirm 生成的节点样式丢失了? - 为什么我不应该通过 ref 访问组件内部的 props 和 state?
- 如何正确的拼写 Ant Design?
- 你们有接受捐助的渠道吗,比如支付宝或者微信支付?
你们会提供 Sass/Stylus 等格式的样式文件吗?#
暂无计划。事实上你可以使用工具(请自行 Google)将 Less 转换成 Sass/Stylus 等。
undefined
和 null
在 antd
的受控组件中有区别吗?#
有。antd 约定:undefined
是非受控的标志,null
作为显式的受控空值。
在输入元素中,React 认为 undefined
和 null
都属于非受控的标志。当 value
由非空值转化为 undefined
或 null
时,组件不再受控,这通常是一些意外情况发生的原因。
但在 antd 中,我们定义 undefined
为非受控的标志,而 null
则作为显式的受控空值。为的是处理 value
为复杂数据类型时的清空(如 allowClear
)置 value
为空值等场景。如果需要让组件受控且希望将 value
置为空值,请将 value
设置为 null
。
注意:对于类 Select
组件的 options
,我们强烈不建议使用 undefined
和 null
作为 option
中的 value
,请使用 string | number
作为 option
的 value
。
当我点击 Select Dropdown DatePicker TimePicker Popover Popconfirm
内的另一个 popup 组件时它会消失,如何解决?#
该问题在 3.11.0
后已经解决。如果你仍在使用旧版本,你可以通过 <Select getPopupContainer={trigger => trigger.parentElement}>
来在 Popover 中渲染组件,或者使用其他的 getXxxxContainer
参数。
可以参考 Select 属性
Select Dropdown DatePicker TimePicker Popover Popconfirm
会跟随滚动条上下移动?#
使用 <Select getPopupContainer={trigger => trigger.parentElement}>
(API 文档)来将组件渲染到滚动区域内,或者使用其他的 getXxxxContainer
参数。如果需要全局解决这个问题,可以使用 <ConfigProvider getPopupContainer={trigger => trigger.parentElement}>
(API 文档)
并且保证 parentElement 是 position: relative
或 position: absolute
。
如何修改 Ant Design 的默认主题?#
可以参考定制主题。
如何修改 Ant Design 组件的默认样式?#
你可以覆盖它们的样式,但是我们不推荐这么做。antd 是一系列 React 组件,但同样是一套设计规范。
如何使用 Day.js 替换 Moment.js 来减小打包大小?#
可以参考替换 Moment.js。
当我动态改变 defaultValue
的时候它并没有生效。#
Input
/Select
等的 defaultXxxx
(例如 defaultValue
)只有在第一次渲染的时候有效,这是 React 的规范,请阅读 React 的文档。
为什么修改组件传入的对象或数组属性组件不会更新?#
antd 内部会对 props 进行浅比较实现性能优化。当状态变更,你总是应该传递一个新的对象。具体请参考 React 的文档
当我设置了 Input
/Select
等的 value
时它就无法修改了。#
尝试使用 onChange
来改变 value
,请参考 React 的文档。
多个组件放一排时没有垂直对齐怎么办?#
尝试使用 Space 组件来使他们对齐。
antd 覆盖了我的全局样式!#
是的,antd 在设计的时候就是用来开发一个完整的应用的,为了方便,我们覆盖了一些全局样式,现在还不能移除,想要了解更多请追踪 这个 issue,或者参考这个教程 How to avoid modifying global styles?
我没法安装 antd
和 antd
的依赖,顺便提一句,我在中国大陆。#
那啥,试试 npmmirror 国内镜像 和 cnpm。
我在 package.json 里将 dependencies.antd
添加到了 git repository 中,但是没有用。#
当然没用了,请使用 npm 安装 antd
。
message
和 notification
是小写的,但是其他的组件都是首字母大写的,这是手滑吗?#
不,因为 message
是一个函数,而不是一个 React 组件。
antd
在移动端体验不佳。#
请浏览 Ant Design Mobile 以了解详情,antd
并非针对移动端设计。你可以试试 react-component,其中带有 'm-' 'rn-' 前缀的库是为移动端设计的。
antd
是否有国内镜像?#
有的,你可以访问 https://ant-design.antgroup.com/index-cn 或 https://ant-design.gitee.io/index-cn 。
历史版本:
antd
可以像 React
那样使用单文件引入吗?#
可以,你可以用 script 标签引入。但是我们推荐使用 npm
来引入 antd
,这样维护起来更简单方便。
在我的网络环境下没法获取到 icon
文件。#
你应该自行部署 iconfont 文件到你的网络上,参考这个例子。 #1070
在 3.9.x
版本后,我们会使用 svg 图标,你就不用担心本地部署 iconfont 的问题了!
如何拓展 antd 的组件?#
如果你需要一些 antd 没有包含的功能,你可以尝试通过 HOC 拓展 antd 的组件。 更多
我的组件默认语言是英文的?如何切回中文的。#
请尝试使用 ConfigProvider 组件来包裹你的应用。
如果日期组件的国际化仍未生效,请配置 moment.locale('zh-cn')
并检查你本地的 moment
版本和 antd
依赖的 moment
版本是否一致。
为什么时间类组件的国际化 locale 设置不生效?#
请检查是否正确设置了 moment 语言包。
import 'moment/locale/zh-cn';
moment.locale('zh-cn');
如果还有问题,请检查是否有两个版本的 moment 共存?
npm ls moment
一般来说,如果项目中依赖的 moment 版本和 antd 依赖的 moment 版本 无法兼容(semver 无法匹配,比如项目中的 moment 版本写死且较低),则会导致使用两个不同版本的 momenet 实例,这样也会导致国际化失效。
开启了 Content Security Policy (CSP) 如何处理动态样式?#
你可以通过 ConfigProvider 来配置 nonce
属性。
当我指定了 DatePicker/RangePicker 的 mode
属性后,点击后无法选择年份/月份?#
在业务开发中,你可能有年份选择,月份范围选择,周范围选择等需求,此时你给现有组件增加了 mode
属性,却发现无法进行点击选择行为,面板也不会关闭。如果给面板添加 disabledDate
也不会相应禁用对应的年/月/周。
就像 这个回复 里解释的一样,这是因为 <DatePicker mode="year" />
不等于 YearPicker
,<RangePicker mode="month" />
不等于 MonthRangePicker
。 mode
属性是在 antd 3.0 时,为了控制面板展现状态而添加的属性,以支持展示时间面板等需求而添加的。mode
只会简单的改变当前显示的面板,不会修改默认的交互行为(比如 DatePicker 依然是点击日才会完成选择并关闭面板)。
同样的,disabledDate
对于任何 <DatePicker />
也只会针对日面板生效,并不会对 <DatePicker mode="year/month" />
上的年/月面板生效。
解决办法#
你可以参照 这篇文章 或者 这篇文章 里的做法,利用 mode
和 onPanelChange
等方法去封装一个 YearPicker
等组件。
另外我们已经在在 antd@4.0 中直接添加了更多相关日期组件来支持这些需求,现在不再需要使用 mode="year|month"
,而是直接可以用 YearPicker
MonthPicker
,并且 disabledDate
也可以正确作用于这些 Picker。
ConfigProvider 设置 prefixCls
后,message/notification/Modal.confirm 生成的节点样式丢失了?#
message/notification/Modal.confirm 等静态方法不同于 <Button />
的渲染方式,是单独渲染在 ReactDOM.render
生成的 DOM 树节点上,无法共享 ConfigProvider 提供的 context 信息。你有两种解决方式:
使用官方提供的 message.useMessage、notification.useNotification 和 Modal.useModal 来调用这些方法。
使用
ConfigProvider.config
方法全局设置prefixCls
。
ConfigProvider.config({
prefixCls: 'ant',
});
为什么我不应该通过 ref 访问组件内部的 props 和 state?#
你通过 ref 获得引用时只应该使用文档提供的方法。直接读取组件内部的 props
和 state
不是一个好的设计,这会使你的代码与组件版本强耦合。任何重构都可能会使你的代码无法工作,其中重构包括且不仅限于改造成 Hooks 版本、移除 / 更名内部 props
与 state
、调整内部 React 节点结构等等。
如何正确的拼写 Ant Design?#
✅ Ant Design:用空格分隔的首字母大写单词,指代设计语言。
✅ antd:全小写,指代 React UI 组件库。
✅ ant.design:特指 ant.design 网站网址。
下面是一些典型的错误例子:
❌ AntD
❌ Ant-D
❌ antD
❌ Antd
❌ ant design
❌ AntDesign
❌ antdesign
❌ Antdesign