DIV CSS 佈局教程網

react + webpack2 熱模塊替換(HMR)完整設定教學
編輯:JavaScript技巧     

模組熱替換(Hot Module Replacement,簡稱 HMR)能在應用程式運行過程中替換、新增或刪除模組,而不必重新載入整個頁面。這代表改動某個元件後,畫面會即時更新且 React 的元件狀態得以保留,開發速度提升非常明顯。

一、Babel 配置

先安裝 hot loader:

npm install --save-dev react-hot-loader@3.0.0-beta.6

接著在 .babelrc 中加入外掛:

 { "presets": [ ["es2015", {"modules": false}], // webpack 2 中需要這樣配置禁用 "stage-2", "react" ], "plugins": [ "react-hot-loader/babel" // 開啟 React 代碼的模塊熱替換(HMR) ] } 

這裡的 {"modules": false} 很重要:webpack 2 本身支援 ES Module,若讓 Babel 先把 import 轉成 CommonJS,tree shaking 與 HMR 都會失效。

二、Webpack 配置

入口檔插入 HMR 相關模組:

 entry: { app: [ 'react-hot-loader/patch', // 開啟 React 代碼的模塊熱替換(HMR) 'webpack-dev-server/client?https://localhost:8080', // 為 webpack-dev-server 的環境打包代碼 // 然後連接到指定服務器域名與端口,可以換成本機ip 'webpack/hot/only-dev-server', // 為熱替換(HMR)打包好代碼 // only- 意味著只有成功更新運行代碼才會執行熱替換(HMR) './index.js' // 我們 app 的入口文件 ], vendor: ['react', 'react-router'] // 公共文件打包 } 

出口必須設定 publicPath:

 output: { path: defPath.DEV_PATH, // 所有輸出文件的目標路徑 filename: 'js/bundle.js', publicPath: '/', chunkFilename: '[name].chunk.js' }, 

plugins 加入兩個外掛:

 plugins: [ new webpack.HotModuleReplacementPlugin(), // 開啟全局的模塊熱替換(HMR) new webpack.NamedModulesPlugin() // 控制台輸出模塊命名美化 ] 

devServer 開啟 hot:

 devServer: { // ... 其他配置 hot: true, // 開啟服務器的模塊熱替換(HMR) contentBase: defPath.DEV_PATH, // 輸出文件的路徑 publicPath: '/' // 和 output 的 publicPath 保持一致 } 

三、應用程式碼的調整

這部分改動最大,需要把原本寫在入口檔的路由配置拆出去。

(1)新增根元件 Root

 /* Root, Router 配置 */ import React from 'react'; import {Provider} from 'react-redux'; import {browserHistory, Router} from 'react-router'; import {syncHistoryWithStore} from 'react-router-redux'; import store from '../store/index'; // 引入 配置後的 store import routes from '../routes.js'; // 子級路由配置 // 創建一個增強版的history來結合store同步導航事件 const browhistory = syncHistoryWithStore(browserHistory, store); const Root = () => ( <Provider store={store}> <div> <Router history={browhistory} routes={routes}/> </div> </Provider> ); export default Root; 

(2)入口檔改為以下形式

 /* app/js/index.js 入口文件, 配置 webpack 熱加載模塊 */ import '../scss/index.scss'; import '../scss/commoncom.scss'; import React from 'react'; import ReactDOM from 'react-dom'; import {AppContainer} from 'react-hot-loader'; // 引入 react-hot-loader 提供的容器 import injectTapEventPlugin from 'react-tap-event-plugin'; // 引入總路由的配置模塊 import Root from './containers/Root'; // 定義要掛載的 DOM 節點 const mountNode = document.getElementById('app'); // react 的插件,提供onTouchTap() injectTapEventPlugin(); // 封裝 render 函數 const render = (Component) => { ReactDOM.render(( <AppContainer> <Component/> </AppContainer> ), mountNode); }; // 初始化調用 render(Root); // 配置需要熱模塊替換的條件 if (module.hot && process.env.NODE_ENV !== 'production') { // 處理對特定依賴的更改 module.hot.accept('./containers/Root', (err) => { if (err) { console.log(err); } // 從DOM 中移除已經掛載的 React 組件 然後重裝 ReactDOM.unmountComponentAtNode(mountNode); render(Root); }); } 

幾個容易出錯的重點

第一,AppContainer 一定要包在最外層,少了它 HMR 就不會生效。第二,module.hot.accept() 的路徑必須與要監聽的模組一致,寫錯會導致改動後仍觸發整頁刷新。第三,process.env.NODE_ENV !== 'production' 這個判斷不能省,否則打包後的正式版本會嘗試執行 HMR 邏輯而報錯。第四,若使用 CSS Modules 或 Sass,樣式的熱更新需要另外安裝對應的 loader,JS 的 HMR 設定並不會自動涵蓋樣式檔。

完成以上設定後,存檔即可看到畫面即時更新,且元件內的 state 不會被重置——這正是 HMR 相比整頁刷新最大的價值所在。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved