7.5 KiB
order | title |
---|---|
9 | FAQ |
有问题请先问 React:https://reactfaq.site 。
你们会提供 Vue 版本的 Ant Design 吗?
不,但是 ant-design 基于 MIT 协议开源,所以你可以尝试用 ant-design 的样式去实现一套,例如:ant-design-vue vue-beauty 或者 antue。
你们会提供 Sass/Stylus 等格式的样式文件吗?
不。事实上你可以使用工具(请自行 Google)将 Less 转换成 Sass/Stylus 等。
当我点击 Select Dropdown DatePicker TimePicker Popover Popconfirm
内的另一个 popup 组件时它会消失,如何解决?
使用 <Select getPopupContainer={trigger => trigger.parentNode}>
来在 Popover 中渲染组件,或者使用其他的 getXxxxContainer 参数。
https://ant.design/components/select/#Select-props
Select Dropdown DatePicker TimePicker Popover Popconfirm
会跟随滚动条上下移动?
使用 <Select getPopupContainer={trigger => trigger.parentNode}>
来将组件渲染到滚动区域内,或者使用其他的 getXxxxContainer 参数。
https://ant.design/components/select/#Select-props
如何修改 Ant Design 的默认主题?
参考:https://ant.design/docs/react/customize-theme 。
你们会提供其他主题吗?
不,我们遵守 Ant Design 设计规范。https://github.com/ant-design/ant-design/issues/1241 。
如何修改 Ant Design 组件的默认样式?
你可以覆盖它们的样式,但是我们不推荐这么做。antd 是一系列 React 组件,但同样是一套设计规范。
我只想使用 Menu
/Button
等,但似乎我必须 import 整个 antd 和它的样式文件。
试试 babel-plugin-import,或者用下面这种方式来按需加载:
import Menu from 'antd/lib/menu';
import 'antd/lib/button/style/css';
或者(ES6 支持的 tree shaking 方式):
import { Menu, Breadcrumb, Icon } from 'antd';
如何配置 webpack 以优化 momentjs 的打包大小?
参考:https://github.com/jmblog/how-to-optimize-momentjs-with-webpack 。
当我动态改变 defaultValue
的时候它并没有生效。
Input
/Select
等的 defaultXxxx
(例如 defaultValue
)只有在第一次渲染的时候有效,这是 React 的规范,请阅读 React 的文档。
当我设置了 Input
/Select
等的 value
时它就无法修改了。
尝试使用 defaultValue
或 onChange
来改变 value
,请参考 React 的文档。
antd 覆盖了我的全局样式!
是的,antd 在设计的时候就是用来开发一个完整的应用的,为了方便,我们覆盖了一些全局样式,现在还不能移除,想要了解更多请追踪这个 issue:https://github.com/ant-design/ant-design/issues/4331 ,或者参考这个教程 How to avoid modifying global styles?
我没法安装 antd
和 antd
的依赖,顺便提一句,我在中国大陆。
那啥,试试 cnpm。
我在 package.json 里将 dependencies.antd
添加到了 git repository 中,但是没有用。
当然没用了,请使用 npm 安装 antd
。
message
和 notification
是小写的,但是其他的组件都是首字母大写的,这是手滑吗?
不,因为 message
是一个函数,而不是一个 React 组件。
antd
在移动端体验不佳。
请浏览 And Design Mobile 以了解详情,antd
并非针对移动端设计。你可以试试 react-component,其中带有 'm-' 'rn-' 前缀的库是为移动端设计的。
antd
会像 React
那样提供单文件引入吗?
是的,你可以用 script 标签引入。但是我们推荐使用 npm
来引入 antd
,这样维护起来更简单方便。
在我的网络环境下没法获取到 icon
文件。
你应该自行部署 iconfont 文件到你的网络上,参考这个例子。 #1070
在 3.9.x 版本后,我们会使用 svg 图标,你就不用担心本地部署 iconfont 的问题了!
如何拓展 antd 的组件?
如果你需要一些 antd 没有包含的功能,你可以尝试通过 HOC 拓展 antd 的组件。 更多
如何正确的拼写 Ant Design?
- ✅ Ant Design:用空格分隔的首字母大写单词,指代设计语言。
- ✅ antd:全小写,指代 React UI 组件库。
- ✅ ant.design:特指 ant.design 网站网址。
下面是一些典型的错误例子:
- ❌ AntD
- ❌ antD
- ❌ Antd
- ❌ ant design
- ❌ AntDesign
- ❌ antdesign
- ❌ Antdesign
你们有接受捐助的渠道吗,比如支付宝或者微信支付?
还没有。
为什么?
马爸爸会付给我们钱。
错误和警告
这里是一些你在使用 antd 的过程中可能会遇到的错误和警告,但是其中一些并不是 antd 的 bug。
Adjacent JSX elements must be wrapped in an enclosing tag
这里有一篇来自 StackOverflow 的回答,另外请阅读 React 的文档。
React.createElement: type should not be null, undefined, boolean, or number. It should be a string (for DOM elements) or a ReactClass (for composite components)
请确保你正确引入了 antd
的组件。参考 antd
相应组件的文档,注意你代码中的 typo。
rm is not recognized as an internal or external command
请阅读这个 issue,或者试试 Linux/Unix。
Failed propType: Invalid prop AAA
of type BBB
supplied to CCC
, expected DDD
. Check the render method of EEE
.
请阅读你正在使用版本的 antd
的文档,确保你传递给 antd
组件的参数类型正确。
Unknown option: xxx/package.json.presets
这里有一篇来自 StackOverflow 的回答可以参考。
Invariant Violation: findComponentRoot(...): Unable to find element.
你或许引入了 React 两次。如果你使用 webpack,请将 React & ReactDOM 设置为 external,参见:#525。如果你使用其他工具(browserify 等),请阅读它们的文档并将 React & ReactDOM 设置为 external。