Ant Design組件庫的使用教程
一、AntDesign的介紹
AntDesign ,簡稱 antd 是基于 Ant Design 設(shè)計體系的 React UI 組件庫,主要用于研發(fā)企業(yè)級中后臺產(chǎn)品。
- 中后臺的產(chǎn)品 屬于工具性產(chǎn)品,很多優(yōu)秀的設(shè)計團隊通過自身的探索和積累,形成了自己的設(shè)計體系。
AntDesign的特點:
- 提煉自企業(yè)級中后臺產(chǎn)品的交互語言和視覺風(fēng)格。
- 開箱即用的高質(zhì)量 React 組件。
- 使用 TypeScript 開發(fā),提供完整的類型定義文件。
- 全鏈路開發(fā)和設(shè)計工具體系。
- 數(shù)十個國際化語言支持。
- 深入每個細節(jié)的主題定制能力。
全鏈路開發(fā)和設(shè)計指的是什么?
- 全鏈路這個詞我記得是16年左右阿里提出的;
- 從業(yè)務(wù)戰(zhàn)略—用戶場景—設(shè)計目標(biāo)—交互體驗—用戶流程—預(yù)期效率全方面進行分析和考慮;
- 這個主要是產(chǎn)品經(jīng)理會考慮的一個點;
二、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庫動態(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> ); } }*/
考慮一個問題:Antd是否會將一些沒有用的代碼(組件或者邏輯代碼)引入,造成包很大呢?
antd 官網(wǎng)有提到:antd 的 JS 代碼默認支持基于 ES modules 的 tree shaking,對于 js 部分,直接引入 import { Button } from ‘antd’ 就會有按需加載的效果。
四、認識craco
上面的使用過程是無法對主題進行配置的,好像對主題等相關(guān)的高級特性進行配置,需要修改create-react-app 的默認配置。
如何修改create-react-app 的默認配置呢?
- 前面我們講過,可以通過yarn run eject來暴露出來對應(yīng)的配置信息進行修改;
- 但是對于webpack并不熟悉的人來說,直接修改 CRA 的配置是否會給你的項目帶來負擔(dān),甚至?xí)黾禹椖康碾[患和不穩(wěn)定 性呢?
- 所以,在項目開發(fā)中是不建議大家直接去修改 CRA 的配置信息的;
那么如何來進行修改默認配置呢?社區(qū)目前有兩個比較常見的方案:
- react-app-rewired + customize-cra;(這個是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文件
原本啟動時,我們是通過react-scripts來管理的;現(xiàn)在啟動時,我們通過craco來管理;
第三步:在根目錄下創(chuàng)建craco.config.js文件用于修改默認配置
六、配置主題
按照 配置主題 的要求,自定義主題需要用到類似 less-loader 提供的 less 變量覆蓋功能:
我們可以引入 craco-less 來幫助加載 less 樣式和修改變量;
安裝 craco-less:
yarn add craco-less
修改craco.config.js中的plugins:
使用modifyVars可以在運行時修改LESS變量;
引入antd的樣式時,引入antd.less文件:
import 'antd/dist/antd.less';
修改后重啟 yarn start,如果看到一個綠色的按鈕就說明配置成功了。
七、配置別名
在項目開發(fā)中,某些組件或者文件的層級會較深,
如果我們通過上層目錄去引入就會出現(xiàn)這樣的情況:…/…/…/…/components/button;如果我們可以配置別名,就可以直接從根目錄下面開始查找文件:@/components/button,甚至是:components/button;
配置別名也需要修改webpack的配置,當(dāng)然我們也可以借助于 craco 來完成:
在導(dǎo)入時就可以按照下面的方式來使用了:
到此這篇關(guān)于AntDesign組件庫的使用的文章就介紹到這了,更多相關(guān)AntDesign組件庫的使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
React?component.forceUpdate()強制重新渲染方式
這篇文章主要介紹了React?component.forceUpdate()強制重新渲染方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-10-1030分鐘精通React今年最勁爆的新特性——React Hooks
這篇文章主要介紹了30分鐘精通React今年最勁爆的新特性——React Hooks,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2019-03-03詳解如何使用React Hooks請求數(shù)據(jù)并渲染
這篇文章主要介紹了如何使用React Hooks請求數(shù)據(jù)并渲染,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10react?路由權(quán)限動態(tài)菜單方案配置react-router-auth-plus
這篇文章主要為大家介紹了react路由權(quán)限動態(tài)菜單方案react-router-auth-plus傻瓜式配置詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-08-08React中不適當(dāng)?shù)腍ooks使用問題及解決方案
在 React 開發(fā)中,Hooks 提供了一種強大的方式來管理組件的狀態(tài)和生命周期,然而,不恰當(dāng)?shù)?nbsp;Hooks 使用可能會導(dǎo)致組件行為異常、性能問題或難以調(diào)試的錯誤,本文將探討 React 中常見的不適當(dāng) Hooks 使用問題,并提供解決方案,需要的朋友可以參考下2025-03-03