11 KiB
| order | title |
|---|---|
| 11 | FAQ |
以下整理了一些 Ant Design 社区常见的问题和官方答复，在提问之前建议找找有没有类似的问题。此外我们也维护了一个反馈较多 FAQ issues 标签 亦可参考。
你们会提供 Sass/Stylus 等格式的样式文件吗？
暂无计划。事实上你可以使用工具（请自行 Google）将 Less 转换成 Sass/Stylus 等。
当我点击 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 。
历史版本:
- 3.x: https://ant-design-3x.gitee.io/
- 2.x: https://ant-design-2x.gitee.io/
- 1.x: https://ant-design-1x.gitee.io/
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 版本是否一致。
开启了 Content Security Policy (CSP) 如何处理动态样式？
你可以通过 ConfigProvider 来配置 nonce 属性。
当我指定了 DatePicker/RangePicker 的 mode 属性后，点击后无法选择年份/月份？
在业务开发中，你可能有年份选择，月份范围选择，周范围选择等需求，此时你给现有组件增加了 mode 属性，却发现无法进行点击选择行为，面板也不会关闭。如果给面板添加 disabledDate 也不会相应禁用对应的年/月/周。
- 重现链接：https://codesandbox.io/s/dank-brook-v1csy
- 相同 issue：#15572、#16436、#11938、#11735、#11586、#10425、#11053
就像 这个回复 里解释的一样，这是因为 <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