我的電腦是Windows10
系統(tǒng)唧瘾,在使用react
之前需安裝node.js
,在node.js
中自帶npm
,另外還需要安裝yarn
,version:1.5.1
react
腳手架create-react-app
中文文檔地址:
[Create React App]: https://www.css88.com/create-react-app/docs/documentation-intro/
1. 搭建自己的react
項(xiàng)目
- 打開(kāi)
WebStorm
,在底部點(diǎn)擊進(jìn)入Terinal
俱诸,使用cd
命令進(jìn)入自己保存項(xiàng)目的位置粱坤。以下所有命令都是在該處(my-app目錄下)進(jìn)行 - 輸入:
yarn create-react-app my-app
其中my-app
為項(xiàng)目名稱(chēng) - 輸入:
yarn install
- 輸入:
yarn start
,啟動(dòng)項(xiàng)目 - 瀏覽器地址欄輸入:
localhost:3000
即可打開(kāi)react項(xiàng)目 - 要停止項(xiàng)目尚揣,按下
Ctrl + c
,輸入Y
即可
2.修改項(xiàng)目默認(rèn)端口號(hào)3000
- 進(jìn)入
node-modules
--react-scripts
--scripts
--start.js
修改端口號(hào) - 如下圖掖举,修改
3000
為你想要設(shè)置的端口號(hào) - ? 有圖
3.自動(dòng)生成的項(xiàng)目目錄以及文件解析
-
node_modules
: 項(xiàng)目依賴(lài)包目錄快骗; -
public
: 公共目錄,該目錄下的文件都不會(huì)被webpack
進(jìn)行加載塔次、解析方篮、打包;通過(guò)yarn build
進(jìn)行打包時(shí)該項(xiàng)目下的所有文件將會(huì)直接被復(fù)制到build目錄下励负;-
favicon.ico
: 是網(wǎng)站圖標(biāo)[可替換刪除] -
index.html
: 頁(yè)面模板藕溅,webpack
打包后將輸出文件引入到該模板內(nèi);補(bǔ)充:index.html
中通過(guò)環(huán)境變量%PUBLIC_URL%
來(lái)指向public目錄路徑继榆; -
manifest.json
:PWA
將應(yīng)用添加至桌面的功能的實(shí)現(xiàn)依賴(lài)于manifest.json
巾表。通過(guò)manifest.json
文件可以對(duì)圖標(biāo)、名稱(chēng)等信息進(jìn)行配置略吨。
-
-
src
: 是源碼目錄該目錄下除了index.js App.test.js registerServiceWorker.js
文件具有一定意義其余文件都是演示使用可直接刪除-
index.js
: 是整個(gè)項(xiàng)目的入口文件集币; -
App.test.js
: 測(cè)試單元演示文件,暫時(shí)并不知道干嘛用翠忠;可以直接刪除鞠苟; -
registerServiceWorker.js
:service worker
是在后臺(tái)運(yùn)行的一個(gè)線(xiàn)程,可以用來(lái)處理離線(xiàn)緩存秽之、消息推送当娱、后臺(tái)自動(dòng)更新等任務(wù);registerServiceWorker
就是為react項(xiàng)目注冊(cè)了一個(gè)service worker
考榨,用來(lái)做資源的緩存跨细,這樣你下次訪(fǎng)問(wèn)時(shí),就可以更快的獲取資源河质。而且因?yàn)橘Y源被緩存扼鞋,所以即使在離線(xiàn)的情況下也可以訪(fǎng)問(wèn)應(yīng)用(此時(shí)使用的資源是之前緩存的資源)。注意愤诱,registerServiceWorker
注冊(cè)的service worker
只在生產(chǎn)環(huán)境中生效云头,并且該功能只有在https
下才能有效果;
-
-
gitignore
: 該文件是github
過(guò)濾文件配置 -
README.md
: 該文件是github
描述文件 -
package.json
: 定義了項(xiàng)目所需要的各種模塊淫半,以及項(xiàng)目的配置信息(比如名稱(chēng)溃槐、版本、許可證等元數(shù)據(jù))科吭。部分依賴(lài)模塊被隱藏昏滴; -
yarn.lock
:每次通過(guò)yarm
添加依賴(lài)或者更新包版本時(shí)yarn
都會(huì)把相關(guān)版本信息寫(xiě)入yarn.lock
文件猴鲫;npm
也有類(lèi)似功能,npm
也可以生成一個(gè)鎖文件谣殊,就是使用上沒(méi)有yarn方便
4.擴(kuò)展webpack配置
使用 react-app-rewired 對(duì) webpack 進(jìn)行自定義配置
安裝依賴(lài)包
react-app-rewired
:yarn add react-app-rewired --save-dev
-
修改
package.json
中的腳本命令:修改如下"scripts": { "start": "react-app-rewired start", "build": "react-app-rewired build", "test": "react-app-rewired test --env=jsdom", "eject": "react-app-rewired eject" }
-
在項(xiàng)目根目錄下(和
package.json
同級(jí))新建配置文件config-overrides.js
燥狰,并添加如下內(nèi)容module.exports = function override(config, env) { // 在這里添加配置 return config; }
-
安裝依賴(lài)包
react-app-rewire-less
世分,通過(guò)該依賴(lài)包來(lái)實(shí)現(xiàn)對(duì)less
的支持yarn add react-app-rewired@1.5.0
-
修改
config-overrides.js
配置文件焕襟,為webpack
配置less
const rewireLess = require('react-app-rewire-less'); module.exports = function override(config, env) { // 只需要一條配置信息即可實(shí)現(xiàn)對(duì)less的支持 config = rewireLess(config, env); // 下面注釋用于配置loader的參數(shù) // config = rewireLess.withLoaderOptions(someLoaderOptions)(config, env); return config; }
在 create-react-app 中使用Antd
-
通過(guò)
babel-plugin-import + react-app-rewired
實(shí)現(xiàn)按需加載(官網(wǎng)推薦)-
react-app-rewired
:的使用上文有過(guò)描述朱监;主要用于在不暴露配置的情況下對(duì)webpack
的配置進(jìn)行擴(kuò)展; -
babel-plugin-import
是一個(gè)用于按需加載組件代碼和樣式的babel
插件
- 安裝依賴(lài)包:
babel-plugin-import
yarn add babel-plugin-import --save-dev
- 通過(guò)
react-app-rewired
對(duì)webpack
配置進(jìn)行擴(kuò)展添加新的babel
插件蛇捌,config-overrides.js
修改 ( 添加 ) 如下內(nèi)容:
// 引入 react-app-rewired 添加 babel 插件的函數(shù) const { injectBabelPlugin } = require('react-app-rewired'); module.exports = function override(config, env) { config = injectBabelPlugin(['import', { libraryName: 'antd', libraryDirectory: 'es', style: 'css' }], config); return config; };
- 配置完后可直接導(dǎo)入
antd
的組件抚恒,不再需要另外引入css
樣式;
import { Button } from 'antd';
-
-
通過(guò) react-app-rewired 擴(kuò)展 webpack 來(lái)實(shí)現(xiàn) antd 自定義主題
主要通過(guò)利用了less-loader
的modifyVars
參數(shù)來(lái)進(jìn)行主題配置- 安裝配置:
react-app-rewired
(上文已經(jīng)詳細(xì)介紹過(guò)這里就不再細(xì)說(shuō)) - 安裝依賴(lài)包
react-app-rewire-less
:實(shí)現(xiàn)對(duì) less 的支持同時(shí)添加modifyVars
加載參數(shù)設(shè)置
- 安裝配置:
yarn add react-app-rewire-less --save-dev
- 修改
config-overrides.js
配置文件
const rewireLess = require('react-app-rewire-less');
const { injectBabelPlugin } = require('react-app-rewired');
module.exports = function override(config, env) {
// 擴(kuò)展 webpack ==> 支持less
config = rewireLess(config, env);
// 配置loader參數(shù)
config = rewireLess.withLoaderOptions({
// 修改默認(rèn)顏色 實(shí)現(xiàn)自定義主題
modifyVars: { "@primary-color": "#1DA57A" },
})(config, env);
// antd 按需加載配置
config = injectBabelPlugin(['import',
{ libraryName: 'antd', libraryDirectory: 'es', style: true }], config);
return config;
}
版本兼容問(wèn)題:因?yàn)榘姹締?wèn)題導(dǎo)致的啟動(dòng)錯(cuò)誤络拌,這里提供一套正常兼容的基本版本俭驮。安裝的時(shí)候帶上版本號(hào)即可
yarn add package-name@1.2.3
package.json
{
"name": "icarus-ui",
"version": "0.1.0",
"private": true,
"dependencies": {
"babel-plugin-import": "^1.4.0",
"babel-plugin-transform-decorators-legacy": "1.3.4",
"react": "^16.7.0",
"react-app-rewire-less": "^2.1.0",
"react-app-rewired": "1.5.0",
"react-dom": "^16.7.0",
"react-scripts": "1.0.12"
},
"scripts": {
"start": "react-app-rewired start",
"build": "react-app-rewired build",
"test": "react-app-rewired test --env=jsdom",
"eject": "react-app-rewired eject"
},
"eslintConfig": {
"extends": "react-app"
},
"browserslist": [
">0.2%",
"not dead",
"not ie <= 11",
"not op_mini all"
]
}