ant-design/docs/react/faq.zh-CN.md
Wendell ceb3435af2 doc: add Chinese faq and fix typo (#12292)
* doc: add Chinese faq and fix typo

* fix typo

* make some adjustments to sentencing

* adjustments
2018-09-19 14:00:31 +08:00

7.5 KiB
Raw Blame History

order title
9 FAQ

有问题请先问 Reacthttps://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

相关 issue#3487 #3438

Select Dropdown DatePicker TimePicker Popover Popconfirm 会跟随滚动条上下移动?

使用 <Select getPopupContainer={trigger => trigger.parentNode}> 来将组件渲染到滚动区域内,或者使用其他的 getXxxxContainer 参数。

https://ant.design/components/select/#Select-props

相关 issue#3487 #3438

如何修改 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 时它就无法修改了。

尝试使用 defaultValueonChange 来改变 value,请参考 React 的文档

antd 覆盖了我的全局样式!

是的antd 在设计的时候就是用来开发一个完整的应用的,为了方便,我们覆盖了一些全局样式,现在还不能移除,想要了解更多请追踪这个 issuehttps://github.com/ant-design/ant-design/issues/4331 ,或者参考这个教程 How to avoid modifying global styles?

我没法安装 antdantd 的依赖,顺便提一句,我在中国大陆。

那啥,试试 cnpm

我在 package.json 里将 dependencies.antd 添加到了 git repository 中,但是没有用。

当然没用了,请使用 npm 安装 antd

messagenotification 是小写的,但是其他的组件都是首字母大写的,这是手滑吗?

不,因为 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 组件库

下面是一些典型的错误例子:

  • 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。