摘要：是一個(gè)前端頁面制作工具，方便產(chǎn)品，運(yùn)營和視覺的同學(xué)迅速開發(fā)簡單的前端頁面，從而可以解放前端同學(xué)的工作量。支持恢復(fù)現(xiàn)場功能關(guān)閉頁面配置不丟失支持操作。提供了一個(gè)方法，用于的拆分。就是發(fā)出的通知，表示應(yīng)該要發(fā)生變化了。

pagemaker是一個(gè)前端頁面制作工具，方便產(chǎn)品，運(yùn)營和視覺的同學(xué)迅速開發(fā)簡單的前端頁面，從而可以解放前端同學(xué)的工作量。此項(xiàng)目創(chuàng)意來自網(wǎng)易樂得內(nèi)部項(xiàng)目nfop中的pagemaker項(xiàng)目。原來項(xiàng)目的前端是采用jquery和模板e(cuò)js做的，每次組件的更新都會(huì)重繪整個(gè)dom，性能不是很好。因?yàn)楫?dāng)時(shí)react特別火，加上項(xiàng)目本身的適合，最后決定采用react來試試水。因?yàn)樵瓉碚麄€(gè)項(xiàng)目是包含很多子項(xiàng)目一起，所以后臺(tái)的實(shí)現(xiàn)也沒有參考，完全重寫。

本項(xiàng)目只是原來項(xiàng)目的簡單實(shí)現(xiàn)，去除了用的不多和復(fù)雜的組件。但麻雀雖小五臟俱全，本項(xiàng)目采用了react的一整套技術(shù)棧，適合那些對(duì)react有過前期學(xué)習(xí)，想通過demo來加深理解并動(dòng)手實(shí)踐的同學(xué)。建議學(xué)習(xí)本demo的之前，先學(xué)習(xí)/復(fù)習(xí)下相關(guān)的知識(shí)點(diǎn)：React 技術(shù)棧系列教程、Immutable 詳解及 React 中實(shí)踐。

線上地址

組件豐富。有標(biāo)題、圖片、按鈕、正文、音頻、視頻、統(tǒng)計(jì)、jscss輸入。

實(shí)時(shí)預(yù)覽。每次修改都可以立馬看到最新的預(yù)覽。

支持三種導(dǎo)入方式，支持導(dǎo)出配置文件。

支持恢復(fù)現(xiàn)場功能(關(guān)閉頁面配置不丟失)

支持Undo/Redo操作。(組件個(gè)數(shù)發(fā)生變化為觸發(fā)點(diǎn))

可以隨時(shí)發(fā)布、修改、刪除已發(fā)布的頁面。

本項(xiàng)目密碼統(tǒng)一采用bcrypt編碼，即使拖庫也不會(huì)泄漏自己的密碼。

每個(gè)頁面都有一個(gè)發(fā)布密碼，從而可以方便多人管理也可防止別人修改。

頁面前端架構(gòu)采用react+redux，并采用immutable數(shù)據(jù)結(jié)構(gòu)。可以將每次組件的更新最小化，從而達(dá)到頁面性能的最優(yōu)化。

后臺(tái)對(duì)上傳的圖片自動(dòng)進(jìn)行壓縮，防止文件過大

適配移動(dòng)端

React

Redux

React-Redux

Immutable

React-Router

fetch

es6

es7

Node

Express

Webpack

Sass

Pug

因?yàn)轫?xiàng)目用的技術(shù)比較多，采用腳手架工具可以省去我們搭建項(xiàng)目的時(shí)間。經(jīng)過搜索，我發(fā)現(xiàn)有三個(gè)用的比較多：

create-react-app

react-starter-kit

react-boilerplate

github上的star數(shù)都很高，第一個(gè)是Facebook官方出的react demo。但是看下來，三個(gè)項(xiàng)目都比較龐大，引入了很多不需要的功能包。后來搜索了下，發(fā)現(xiàn)一個(gè)好用的腳手架工具：yeoman，大家可以選擇相應(yīng)的generator。我選擇的是react-webpack。項(xiàng)目比較清爽，需要大家自己搭建redux和immutable環(huán)境，以及后臺(tái)express。其實(shí)也好，鍛煉下自己構(gòu)建項(xiàng)目的能力。

Store 就是保存數(shù)據(jù)的地方，你可以把它看成一個(gè)容器。整個(gè)應(yīng)用只能有一個(gè) Store。

import { createStore } from "redux";
import { combineReducers } from "redux-immutable";

import unit from "./reducer/unit";
// import content from "./reducer/content";

let devToolsEnhancer = null;
if (process.env.NODE_ENV === "development") {
    devToolsEnhancer = require("remote-redux-devtools");
}

const reducers = combineReducers({ unit });
let store = null;
if (devToolsEnhancer) {
    store = createStore(reducers, devToolsEnhancer.default({ realtime: true, port: config.reduxDevPort }));
}
else {
    store = createStore(reducers);
}
export default store;

Redux 提供createStore這個(gè)函數(shù)，用來生成 Store。由于整個(gè)應(yīng)用只有一個(gè) State 對(duì)象，包含所有數(shù)據(jù)，對(duì)于大型應(yīng)用來說，這個(gè) State 必然十分龐大，導(dǎo)致 Reducer 函數(shù)也十分龐大。Redux 提供了一個(gè) combineReducers 方法，用于 Reducer 的拆分。你只要定義各個(gè)子 Reducer 函數(shù)，然后用這個(gè)方法，將它們合成一個(gè)大的 Reducer。當(dāng)然，我們這里只有一個(gè) unit 的 Reducer ，拆不拆分都可以。

devToolsEnhancer是個(gè)中間件（middleware）。用于在開發(fā)環(huán)境時(shí)使用Redux DevTools來調(diào)試redux。

Action 描述當(dāng)前發(fā)生的事情。改變 State 的唯一辦法，就是使用 Action。它會(huì)運(yùn)送數(shù)據(jù)到 Store。

import Store from "../store";

const dispatch = Store.dispatch;

const actions = {
    addUnit: (name) => dispatch({ type: "AddUnit", name }),
    copyUnit: (id) => dispatch({ type: "CopyUnit", id }),
    editUnit: (id, prop, value) => dispatch({ type: "EditUnit", id, prop, value }),
    removeUnit: (id) => dispatch({ type: "RemoveUnit", id }),
    clear: () => dispatch({ type: "Clear"}),
    insert: (data, index) => dispatch({ type: "Insert", data, index}),
    moveUnit: (fid, tid) => dispatch({ type: "MoveUnit", fid, tid }),
};

export default actions;

State 的變化，會(huì)導(dǎo)致 View 的變化。但是，用戶接觸不到 State，只能接觸到 View。所以，State 的變化必須是 View 導(dǎo)致的。Action 就是 View 發(fā)出的通知，表示 State 應(yīng)該要發(fā)生變化了。代碼中，我們定義了actions對(duì)象，他有很多屬性，每個(gè)屬性都是函數(shù)，函數(shù)的輸出是派發(fā)了一個(gè)action對(duì)象，通過Store.dispatch發(fā)出。action是一個(gè)包含了必須的type屬性，還有其他附帶的信息。

Immutable Data 就是一旦創(chuàng)建，就不能再被更改的數(shù)據(jù)。對(duì) Immutable 對(duì)象的任何修改或添加刪除操作都會(huì)返回一個(gè)新的 Immutable 對(duì)象。詳細(xì)介紹，推薦知乎上的Immutable 詳解及 React 中實(shí)踐。我們項(xiàng)目里用的是Facebook 工程師 Lee Byron 花費(fèi) 3 年時(shí)間打造的immutable.js庫。具體的API大家可以去官網(wǎng)學(xué)習(xí)。

熟悉 React 的都知道，React 做性能優(yōu)化時(shí)有一個(gè)避免重復(fù)渲染的大招，就是使用 shouldComponentUpdate()，但它默認(rèn)返回 true，即始終會(huì)執(zhí)行 render() 方法，然后做 Virtual DOM 比較，并得出是否需要做真實(shí) DOM 更新，這里往往會(huì)帶來很多無必要的渲染并成為性能瓶頸。當(dāng)然我們也可以在 shouldComponentUpdate() 中使用使用 deepCopy 和 deepCompare 來避免無必要的 render()，但 deepCopy 和 deepCompare 一般都是非常耗性能的。

Immutable 則提供了簡潔高效的判斷數(shù)據(jù)是否變化的方法，只需 ===(地址比較) 和 is( 值比較) 比較就能知道是否需要執(zhí)行 render()，而這個(gè)操作幾乎 0 成本，所以可以極大提高性能。修改后的 shouldComponentUpdate 是這樣的：

import { is } from "immutable";

shouldComponentUpdate: (nextProps = {}, nextState = {}) => {
  const thisProps = this.props || {}, thisState = this.state || {};

  if (Object.keys(thisProps).length !== Object.keys(nextProps).length ||
      Object.keys(thisState).length !== Object.keys(nextState).length) {
    return true;
  }

  for (const key in nextProps) {
    if (thisProps[key] !== nextProps[key] || ！is(thisProps[key], nextProps[key])) {
      return true;
    }
  }

  for (const key in nextState) {
    if (thisState[key] !== nextState[key] || ！is(thisState[key], nextState[key])) {
      return true;
    }
  }
  return false;
}

使用 Immutable 后，如下圖，當(dāng)紅色節(jié)點(diǎn)的 state 變化后，不會(huì)再渲染樹中的所有節(jié)點(diǎn)，而是只渲染圖中綠色的部分：

本項(xiàng)目中，我們采用支持 class 語法的 pure-render-decorator 來實(shí)現(xiàn)。我們希望達(dá)到的效果是：當(dāng)我們編輯組件的屬性時(shí)，其他組件并不被渲染，而且preview里，只有被修改的preview組件update，而其他preview組件不渲染。為了方便觀察組件是否被渲染，我們?nèi)藶榈慕o組件增加了data-id的屬性，其值為Math.random()的隨機(jī)值。效果如下圖所示：

immutable實(shí)際效果圖

可見，當(dāng)我們?nèi)ジ淖儤?biāo)題組件標(biāo)題文字的時(shí)候，只有標(biāo)題組件和標(biāo)題預(yù)覽組件會(huì)被重新渲染，其他組件和預(yù)覽組件并沒有。這就是immutable帶來的性能提升的地方。原來的項(xiàng)目當(dāng)組件多了之后，渲染會(huì)卡頓，有時(shí)候甚至短暫黑屏。

Store 收到 Action 以后，必須給出一個(gè)新的 State，這樣 View 才會(huì)發(fā)生變化。這種 State 的計(jì)算過程就叫做 Reducer。

import immutable from "immutable";

const unitsConfig = immutable.fromJS({
    META: {
        type: "META",
        name: "META信息配置",
        title: "",
        keywords: "",
        desc: ""
    },
    TITLE: {
        type: "TITLE",
        name: "標(biāo)題",
        text: "",
        url: "",
        color: "#000",
        fontSize: "middle",
        textAlign: "center",
        padding: [0, 0, 0, 0],
        margin: [10, 0, 20, 0]
    },
    IMAGE: {
        type: "IMAGE",
        name: "圖片",
        address: "",
        url: "",
        bgColor: "#fff",
        padding: [0, 0, 0, 0],
        margin: [10, 0, 20, 0]
    },
    BUTTON: {
        type: "BUTTON",
        name: "按鈕",
        address: "",
        url: "",
        txt: "",
        margin: [
            0, 30, 20, 30
        ],
        buttonStyle: "yellowStyle",
        bigRadius: true,
        style: "default"
    },
    TEXTBODY: {
        type: "TEXTBODY",
        name: "正文",
        text: "",
        textColor: "#333",
        bgColor: "#fff",
        fontSize: "small",
        textAlign: "center",
        padding: [0, 0, 0, 0],
        margin: [0, 30, 20, 30],
        changeLine: true,
        retract: true,
        bigLH: true,
        bigPD: true,
        noUL: true,
        borderRadius: true
    },
    AUDIO: {
        type: "AUDIO",
        name: "音頻",
        address: "",
        size: "middle",
        position: "topRight",
        bgColor: "#9160c3",
        loop: true,
        auto: true
    },
    VIDEO: {
        type: "VIDEO",
        name: "視頻",
        address: "",
        loop: true,
        auto: true,
        padding: [0, 0, 20, 0]
    },
    CODE: {
        type: "CODE",
        name: "JSCSS",
        js: "",
        css: ""
    },
    STATISTIC: {
        type: "STATISTIC",
        name: "統(tǒng)計(jì)",
        id: ""
    }
})

const initialState = immutable.fromJS([
    {
        type: "META",
        name: "META信息配置",
        title: "",
        keywords: "",
        desc: "",
        // 非常重要的屬性，表明這次state變化來自哪個(gè)組件！
        fromType: ""
    }
]);


function reducer(state = initialState, action) {
    let newState, localData, tmp
    // 初始化從localstorage取數(shù)據(jù)
    if (state === initialState) {
        localData = localStorage.getItem("config");
        !!localData && (state = immutable.fromJS(JSON.parse(localData)));
        // sessionStorage的初始化
        sessionStorage.setItem("configs", JSON.stringify([]));
        sessionStorage.setItem("index", 0);
    }
    switch (action.type) {
        case "AddUnit": {
            tmp = state.push(unitsConfig.get(action.name));
            newState = tmp.setIn([0, "fromType"], action.name);
            break
        }
        case "CopyUnit": {
            tmp = state.push(state.get(action.id));
            newState = tmp.setIn([0, "fromType"], state.getIn([action.id, "type"]));
            break
        }
        case "EditUnit": {
            tmp = state.setIn([action.id, action.prop], action.value);
            newState = tmp.setIn([0, "fromType"], state.getIn([action.id, "type"]));
            break
        }
        case "RemoveUnit": {
            const type = state.getIn([action.id, "type"]);
            tmp = state.splice(action.id, 1);
            newState = tmp.setIn([0, "fromType"], type);
            break
        }
        case "Clear": {
            tmp = initialState;
            newState = tmp.setIn([0, "fromType"], "ALL");
            break
        }
        case "Insert": {
            tmp = immutable.fromJS(action.data);
            newState = tmp.setIn([0, "fromType"], "ALL");
            break
        }
        case "MoveUnit":{
            const {fid, tid} = action;
            const fitem = state.get(fid);
            if (fitem && fid != tid) {
                tmp = state.splice(fid, 1).splice(tid, 0, fitem);
            } else {
                tmp = state;
            }
            newState = tmp.setIn([0, "fromType"], "");
            break;
        }
        default:
            newState = state;
    }
    // 更新localstorage，便于恢復(fù)現(xiàn)場
    localStorage.setItem("config", JSON.stringify(newState.toJS()));

    // 撤銷，恢復(fù)操作(僅以組件數(shù)量變化為觸發(fā)點(diǎn)，否則存儲(chǔ)數(shù)據(jù)巨大，也沒必要)
    let index = parseInt(sessionStorage.getItem("index"));
    let configs = JSON.parse(sessionStorage.getItem("configs"));
    if(action.type == "Insert" && action.index){
        sessionStorage.setItem("index", index + action.index);
    }else{
        if(newState.toJS().length != state.toJS().length){
            // 組件的數(shù)量有變化，刪除歷史記錄index指針狀態(tài)之后的所有configs，將這次變化的config作為最新的記錄
            configs.splice(index + 1, configs.length - index - 1, JSON.stringify(newState.toJS()));
            sessionStorage.setItem("configs", JSON.stringify(configs));
            sessionStorage.setItem("index", configs.length - 1);
        }else{
            // 組件數(shù)量沒有變化，index不變。但是要更新存儲(chǔ)的config配置
            configs.splice(index, 1, JSON.stringify(newState.toJS()));
            sessionStorage.setItem("configs", JSON.stringify(configs));
        }
    }
    
    // console.log(JSON.parse(sessionStorage.getItem("configs")));
    return newState
}

export default reducer;

Reducer是一個(gè)函數(shù)，它接受Action和當(dāng)前State作為參數(shù)，返回一個(gè)新的State。unitsConfig是存儲(chǔ)著各個(gè)組件初始配置的對(duì)象集合，所有新添加的組件都從里邊取初始值。State有一個(gè)初始值：initialState，包含META組件，因?yàn)槊總€(gè)web頁面必定有一個(gè)META信息，而且只有一個(gè)，所以頁面左側(cè)組件列表里不包含它。

reducer會(huì)根據(jù)action的type不同，去執(zhí)行相應(yīng)的操作。但是一定要注意，immutable數(shù)據(jù)操作后要記得賦值。每次結(jié)束后我們都會(huì)去修改fromType值，是因?yàn)橛械慕M件，比如AUDIO、CODE等修改后，預(yù)覽的js代碼需要重新執(zhí)行一次才可以生效，而其他組件我們可以不用去執(zhí)行，提高性能。

當(dāng)然，我們頁面也做了現(xiàn)場恢復(fù)功能(localStorage)，也得益于immutable數(shù)據(jù)結(jié)構(gòu)，我們實(shí)現(xiàn)了Redo/Undo的功能。Redo/Undo的功能僅會(huì)在組件個(gè)數(shù)有變化的時(shí)候計(jì)作一次版本，否則錄取的的信息太多，會(huì)對(duì)性能造成影響。當(dāng)然，組件信息發(fā)生變化我們是會(huì)去更新數(shù)組的。

如下圖所示：

用戶能接觸到的只有view層，就是組件里的各種輸入框，單選多選等。用戶與之發(fā)生交互，會(huì)發(fā)出action。React-Redux提供connect方法，用于從UI組件生成容器組件。connect方法接受兩個(gè)參數(shù)：mapStateToProps和mapDispatchToProps，按照React-Redux的API，我們需要將Store.dispatch(action)寫在mapDispatchToProps函數(shù)里邊，但是為了書寫方便和直觀看出這個(gè)action是哪里發(fā)出的，我們沒有遵循這個(gè)API，而是直接寫在在代碼中。

然后，Store 自動(dòng)調(diào)用 Reducer，并且傳入兩個(gè)參數(shù)：當(dāng)前 State 和收到的 Action。 Reducer 會(huì)返回新的 State 。State 一旦有變化，Store 就會(huì)調(diào)用監(jiān)聽函數(shù)。在React-Redux規(guī)則里，我們需要提供mapStateToProps函數(shù)，建立一個(gè)從（外部的）state對(duì)象到（UI組件的）props對(duì)象的映射關(guān)系。mapStateToProps會(huì)訂閱 Store，每當(dāng)state更新的時(shí)候，就會(huì)自動(dòng)執(zhí)行，重新計(jì)算 UI 組件的參數(shù)，從而觸發(fā)UI組件的重新渲染。大家可以看我們content.js組件的最后代碼：

export default connect(
    state => ({
        unit: state.get("unit"),
    })
)(Content);

connect方法可以省略mapStateToProps參數(shù)，那樣的話，UI組件就不會(huì)訂閱Store，就是說 Store 的更新不會(huì)引起 UI 組件的更新。像header和footer組件，就是純UI組件。

為什么我們的各個(gè)子組件都可以拿到state狀態(tài)，那是因?yàn)槲覀冊(cè)谧铐攲咏M件外面又包了一層 組件。入口文件index.js代碼如下：

import "babel-polyfill";
import React from "react";
import ReactDom from "react-dom";
import { Provider } from "react-redux";
import { Router, Route, IndexRoute, browserHistory } from "react-router";

import "./index.scss";

import Store from "./store";

import App from "./components/app";

ReactDom.render(
    
        
            

            
        
    ,
    document.querySelector("#app")
);

我們的react-router采用的是browserHistory，使用的是HTML5的History API，路由切換交給后臺(tái)。

左邊一欄是組件列表，在移動(dòng)端點(diǎn)擊左上角的雙右箭頭即可看到。點(diǎn)擊對(duì)應(yīng)的組件，網(wǎng)頁中間會(huì)出現(xiàn)相應(yīng)的組件信息。單擊出來的組件頭，可以切換展開與隱藏。更新相應(yīng)的組件信息，在右側(cè)可以看到實(shí)時(shí)預(yù)覽。移動(dòng)端需要點(diǎn)擊右下角的黃色按鈕（支持拖動(dòng)）。

在中間區(qū)域的最上面有個(gè)內(nèi)容配置區(qū)。左邊有導(dǎo)入、導(dǎo)出、清空功能。導(dǎo)入支持支持導(dǎo)入json配置文件，這個(gè)配置文件可以在我們配置完準(zhǔn)備發(fā)布的時(shí)候點(diǎn)擊導(dǎo)出即可生成。還支持直接輸入發(fā)布目錄名稱，比如：lmlc；或者輸入完整的線上地址，比如：https://pagemaker.wty90.com/release/lmlc.html；當(dāng)然也支持粘貼配置文件內(nèi)容。清空會(huì)清空掉現(xiàn)在的所有配置的組件。內(nèi)容配置區(qū)的右邊是Redo/Undo功能。為了性能考慮，這里只以組件個(gè)數(shù)發(fā)生變化為觸發(fā)點(diǎn)。

右側(cè)是預(yù)覽區(qū)域。中間區(qū)域內(nèi)容一有變化，右側(cè)會(huì)實(shí)時(shí)更新展示。當(dāng)項(xiàng)目配置完成想要發(fā)布的時(shí)候，點(diǎn)擊右側(cè)區(qū)域左上角的發(fā)布按鈕，會(huì)出現(xiàn)一個(gè)彈窗。第一個(gè)輸入框是發(fā)布目錄，如果是新項(xiàng)目需要?jiǎng)?chuàng)建發(fā)布密碼。如果要更新已存在的項(xiàng)目，需要確認(rèn)發(fā)布密碼。平臺(tái)密碼是：pagemaker。如需更改，在data文件夾下修改password.json文件內(nèi)容的value值。我們采用的是bcrypt編碼。大家可以去BCrypt Calculator網(wǎng)站，方便計(jì)算出編碼值。右上角有個(gè)查看按鈕，可以查看采用 pagemaker 已經(jīng)發(fā)布的頁面。

隱藏功能：點(diǎn)擊預(yù)覽區(qū)域蘋果手機(jī)的home鍵，會(huì)出現(xiàn)清理無用文件的彈窗，因?yàn)橄螺d文件會(huì)在服務(wù)器端創(chuàng)建一個(gè)緩存文件。還有一些用戶上傳的圖片等一直沒有發(fā)布，在服務(wù)器端會(huì)一直堆積。這個(gè)需要提供后臺(tái)密碼，修改同平臺(tái)密碼，在data文件夾下的server_code.json文件。這個(gè)功能是針對(duì)管理員的，普通用戶無須理會(huì)。

為了讓頁面更好的兼容IE9+和android瀏覽器，因?yàn)轫?xiàng)目使用了babel，所以采用babel-polyfill和babel-plugin-transform-runtime插件。

Antd完整包特別大，有10M多。而我們項(xiàng)目里主要是采用了彈窗組件，所以我們應(yīng)該采用按需加載。只需在.babelrc文件里配置一下即可，詳見官方說明。

項(xiàng)目最后打包的main.js非常大，有接近10M多。在網(wǎng)上搜了很多方法，最后發(fā)現(xiàn)webpack配置externals屬性的方法非常好。可以利用pc的多文件并行下載，降低自己服務(wù)器的壓力和流量，同時(shí)可以利用cdn的緩存資源。配置如下所示：

externals: {
    "jquery": "jQuery",
    "react": "React",
    "react-dom": "ReactDOM",
    "CodeMirror": "CodeMirror",
    "immutable": "Immutable",
    "react-router": "ReactRouter"
}

externals屬性告訴webpack，如下的這些資源不進(jìn)行打包，從外部引入。一般都是一些公共文件，比如jquery、react等。注意，因?yàn)檫@些文件從外部引入，所以在npm install的時(shí)候，有些依賴這些公共文件的包安裝會(huì)報(bào)warning，所以看到這些大家不要緊張。經(jīng)過處理，main.js文件大小降到3.7M，然后nginx配置下gzip編碼壓縮，最終將文件大小降到872KB。因?yàn)樵谝苿?dòng)端，文件加載還是比較慢的，我又給頁面加了loading效果。

歡迎大家star學(xué)習(xí)交流：github地址 | 我的博客