Ant Design組件庫(kù)的使用教程
一、AntDesign的介紹
AntDesign ,簡(jiǎn)稱 antd 是基于 Ant Design 設(shè)計(jì)體系的 React UI 組件庫(kù),主要用于研發(fā)企業(yè)級(jí)中后臺(tái)產(chǎn)品。
- 中后臺(tái)的產(chǎn)品 屬于工具性產(chǎn)品,很多優(yōu)秀的設(shè)計(jì)團(tuán)隊(duì)通過(guò)自身的探索和積累,形成了自己的設(shè)計(jì)體系。
AntDesign的特點(diǎn):
- 提煉自企業(yè)級(jí)中后臺(tái)產(chǎn)品的交互語(yǔ)言和視覺(jué)風(fēng)格。
- 開(kāi)箱即用的高質(zhì)量 React 組件。
- 使用 TypeScript 開(kāi)發(fā),提供完整的類型定義文件。
- 全鏈路開(kāi)發(fā)和設(shè)計(jì)工具體系。
- 數(shù)十個(gè)國(guó)際化語(yǔ)言支持。
- 深入每個(gè)細(xì)節(jié)的主題定制能力。
全鏈路開(kāi)發(fā)和設(shè)計(jì)指的是什么?
- 全鏈路這個(gè)詞我記得是16年左右阿里提出的;
- 從業(yè)務(wù)戰(zhàn)略—用戶場(chǎng)景—設(shè)計(jì)目標(biāo)—交互體驗(yàn)—用戶流程—預(yù)期效率全方面進(jìn)行分析和考慮;
- 這個(gè)主要是產(chǎn)品經(jīng)理會(huì)考慮的一個(gè)點(diǎn);
二、AntDesign兼容性
AntDesign的兼容性:
- 現(xiàn)代瀏覽器和 IE11(需要 polyfills)。
- 支持服務(wù)端渲染。
- Electron

antd@2.0 之后不再支持 IE8,antd@4.0 之后不再支持 IE9/10。
目前穩(wěn)定的版本:v4.4.0
三、AntDesign的安裝
AntDesign:https://ant.design/index-cn/
使用 npm 或 yarn 安裝
npm install antd –save 或 yarn add antd

我們需要在index.js中引入全局的Antd樣式:
import "antd/dist/antd.css";

在App.js中就可以使用一些組件了:
import React, {PureComponent} from 'react';
import moment from 'moment'
import {Button, Space, DatePicker} from 'antd'
import { PoweroffOutlined } from '@ant-design/icons';
function onChange(date, dateString) {
console.log(date, dateString);
}
class App extends PureComponent {
constructor(props) {
super(props);
this.state = {
loadings: [],
};
}
enterLoading = index => {
this.setState(({ loadings }) => {
const newLoadings = [...loadings];
newLoadings[index] = true;
return {
loadings: newLoadings,
};
});
setTimeout(() => {
this.setState(({ loadings }) => {
const newLoadings = [...loadings];
newLoadings[index] = false;
return {
loadings: newLoadings,
};
});
}, 6000);
};
render() {
const { loadings } = this.state;
return (
<div>
<>
{/*<Space style={{ width: '100%' }}>
<Button type="primary" loading>
Loading
</Button>
<Button type="primary" size="small" loading>
Loading
</Button>
<Button type="primary" icon={<PoweroffOutlined />} loading />
</Space>*/}
{/* <Space style={{ width: '100%' }}>
<Button type="primary" loading={loadings[0]} onClick={() => this.enterLoading(0)}>
Click me!
</Button>
<Button
type="primary"
icon={<PoweroffOutlined />}
loading={loadings[1]}
onClick={() => this.enterLoading(1)}
>
Click me!
</Button>
<Button
type="primary"
icon={<PoweroffOutlined />}
loading={loadings[2]}
onClick={() => this.enterLoading(2)}
/>
</Space>*/}
<Button type="primary" loading={loadings[0]} onClick={() => this.enterLoading(0)}>
Click me!
</Button>
<DatePicker defaultValue={moment('2018-06-12', 'YY-MM-DD')}
onChange={onChange} picker="day"
allowClear={false}
/>
</>
</div>
);
}
}
export default App;
/*class App extends PureComponent {
constructor(props) {
super(props);
this.state = {
isActive: true
}
}
render() {
const {isActive} = this.state
let isBar = true
const errClass = 'error'
const warnClass = null
return (
<div>
{/!* 原生React中添加class的方法 *!/}
<h2 className={'foo bar active title'}>我是標(biāo)題1</h2>
<h2 className={'title ' + (isActive ? 'active' : '')}>我是標(biāo)題2</h2>
<h2 className={['title', (isActive ? 'active' : '')].join(" ")}>我是標(biāo)題3</h2>
{/!* 使用classnames庫(kù)動(dòng)態(tài)添加class *!/}
<h2 className={'foo bar active title'}>我是標(biāo)題4</h2>
<h2 className={classNames('foo', 'bar', 'active', 'title')}>我是標(biāo)題5</h2>
<h2 className={classNames({'active': isActive, 'bar': isBar}, 'title')}>我是標(biāo)題6</h2>
<h2 className={classNames('foo', errClass, warnClass, {'active': isActive})}>我是標(biāo)題7</h2>
<h2 className={classNames(['active', 'title'])}>我是標(biāo)題8</h2>
<h2 className={classNames(['active', 'title'], {'bar': isBar})}>我是標(biāo)題9</h2>
</div>
);
}
}*/考慮一個(gè)問(wèn)題:Antd是否會(huì)將一些沒(méi)有用的代碼(組件或者邏輯代碼)引入,造成包很大呢?
antd 官網(wǎng)有提到:antd 的 JS 代碼默認(rèn)支持基于 ES modules 的 tree shaking,對(duì)于 js 部分,直接引入 import { Button } from ‘antd’ 就會(huì)有按需加載的效果。
四、認(rèn)識(shí)craco
上面的使用過(guò)程是無(wú)法對(duì)主題進(jìn)行配置的,好像對(duì)主題等相關(guān)的高級(jí)特性進(jìn)行配置,需要修改create-react-app 的默認(rèn)配置。
如何修改create-react-app 的默認(rèn)配置呢?
- 前面我們講過(guò),可以通過(guò)yarn run eject來(lái)暴露出來(lái)對(duì)應(yīng)的配置信息進(jìn)行修改;
- 但是對(duì)于webpack并不熟悉的人來(lái)說(shuō),直接修改 CRA 的配置是否會(huì)給你的項(xiàng)目帶來(lái)負(fù)擔(dān),甚至?xí)黾禹?xiàng)目的隱患和不穩(wěn)定 性呢?
- 所以,在項(xiàng)目開(kāi)發(fā)中是不建議大家直接去修改 CRA 的配置信息的;
那么如何來(lái)進(jìn)行修改默認(rèn)配置呢?社區(qū)目前有兩個(gè)比較常見(jiàn)的方案:
- react-app-rewired + customize-cra;(這個(gè)是antd早期推薦的方案)
- craco;(目前antd推薦的方案)
五、Craco的使用步驟
官方文檔:https://ant.design/docs/react/use-with-create-react-app-cn#%E9%AB%98%E7%BA%A7%E9%85%8D%E7%BD%AE
第一步:安裝craco:
yarn add @craco/craco
第二步:修改package.json文件
原本啟動(dòng)時(shí),我們是通過(guò)react-scripts來(lái)管理的;現(xiàn)在啟動(dòng)時(shí),我們通過(guò)craco來(lái)管理;

第三步:在根目錄下創(chuàng)建craco.config.js文件用于修改默認(rèn)配置

六、配置主題
按照 配置主題 的要求,自定義主題需要用到類似 less-loader 提供的 less 變量覆蓋功能:
我們可以引入 craco-less 來(lái)幫助加載 less 樣式和修改變量;
安裝 craco-less:
yarn add craco-less
修改craco.config.js中的plugins:
使用modifyVars可以在運(yùn)行時(shí)修改LESS變量;

引入antd的樣式時(shí),引入antd.less文件:
import 'antd/dist/antd.less';

修改后重啟 yarn start,如果看到一個(gè)綠色的按鈕就說(shuō)明配置成功了。

七、配置別名
在項(xiàng)目開(kāi)發(fā)中,某些組件或者文件的層級(jí)會(huì)較深,
如果我們通過(guò)上層目錄去引入就會(huì)出現(xiàn)這樣的情況:…/…/…/…/components/button;如果我們可以配置別名,就可以直接從根目錄下面開(kāi)始查找文件:@/components/button,甚至是:components/button;
配置別名也需要修改webpack的配置,當(dāng)然我們也可以借助于 craco 來(lái)完成:

在導(dǎo)入時(shí)就可以按照下面的方式來(lái)使用了:

到此這篇關(guān)于AntDesign組件庫(kù)的使用的文章就介紹到這了,更多相關(guān)AntDesign組件庫(kù)的使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
create-react-app修改為多頁(yè)面支持的方法
本篇文章主要介紹了create-react-app修改為多頁(yè)面支持的方法,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2018-05-05
React?component.forceUpdate()強(qiáng)制重新渲染方式
這篇文章主要介紹了React?component.forceUpdate()強(qiáng)制重新渲染方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-10-10
30分鐘精通React今年最勁爆的新特性——React Hooks
這篇文章主要介紹了30分鐘精通React今年最勁爆的新特性——React Hooks,小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2019-03-03
詳解如何使用React Hooks請(qǐng)求數(shù)據(jù)并渲染
這篇文章主要介紹了如何使用React Hooks請(qǐng)求數(shù)據(jù)并渲染,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10
react?路由權(quán)限動(dòng)態(tài)菜單方案配置react-router-auth-plus
這篇文章主要為大家介紹了react路由權(quán)限動(dòng)態(tài)菜單方案react-router-auth-plus傻瓜式配置詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-08-08
React + Node.js實(shí)現(xiàn)圖片上傳功能
最近筆者在開(kāi)發(fā)個(gè)人博客的后臺(tái)管理系統(tǒng),里面用到了圖片上傳相關(guān)的功能,在這里記錄并分享一下,希望可以幫到大家,話不多說(shuō)直接開(kāi)始吧,感興趣的朋友可以參考下2024-01-01
React中不適當(dāng)?shù)腍ooks使用問(wèn)題及解決方案
在 React 開(kāi)發(fā)中,Hooks 提供了一種強(qiáng)大的方式來(lái)管理組件的狀態(tài)和生命周期,然而,不恰當(dāng)?shù)?nbsp;Hooks 使用可能會(huì)導(dǎo)致組件行為異常、性能問(wèn)題或難以調(diào)試的錯(cuò)誤,本文將探討 React 中常見(jiàn)的不適當(dāng) Hooks 使用問(wèn)題,并提供解決方案,需要的朋友可以參考下2025-03-03
React實(shí)現(xiàn)阿里云OSS上傳文件的示例
這篇文章主要介紹了React實(shí)現(xiàn)阿里云OSS上傳文件的示例,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-08-08

