通過(guò)上一篇文章，我們對(duì)喬巴樂高海報(bào)平臺(tái)的整體架構(gòu)有了初步的了解。今天我們深入到編輯器部分，對(duì)其中的難點(diǎn)和實(shí)現(xiàn)細(xì)節(jié)進(jìn)行分析。

這是目前生產(chǎn)的編輯器頁(yè)面：

對(duì)應(yīng)的原型圖：

不難看出和市面上大部分低代碼平臺(tái)一樣，由三部分組成：左側(cè)組件列表、中間畫布區(qū)域、右側(cè)屬性區(qū)域。

大致操作流程就是拖動(dòng)左側(cè)的組件到中間的畫布，選中組件，右側(cè)屬性面板就會(huì)展示與該組件關(guān)聯(lián)的屬性。編輯右側(cè)屬性，畫布中對(duì)應(yīng)的組件樣式就會(huì)同步更新。頁(yè)面拼接完成。

從中看出組件串聯(lián)其中，在前面一篇文章中，我們大致分析了整體頁(yè)面和組件的數(shù)據(jù)結(jié)構(gòu)，但沒有細(xì)化。抽取一下文字、圖片、素材組件的通用特性：

尺寸屬性（Size）

• 寬度（width）
• 高度（height）

填充屬性（Padding）

• 上填充（padding-top）
• 右填充（padding-right）
• 下填充（padding-bottom）
• 左填充（padding-left）

視覺格式屬性

• 指定如何定位元素（position）
• 指定所定位元素的上邊緣的位置（top）
• 指定所定位元素的右邊緣的位置（right）
• 指定所定位元素底邊的位置（bottom）
• 指定定位元素左邊緣的位置（left）
• 將一個(gè)或多個(gè)陰影應(yīng)用于元素的框（box-shadow）

顏色屬性（Color）

• 透明度（opacity）

邊框?qū)傩裕˙order）

• 設(shè)置元素所有四個(gè)側(cè)面的邊框顏色（border-color）
• 設(shè)置元素所有四個(gè)側(cè)面的邊框?qū)挾龋╞order-width）
• 在元素的所有四個(gè)面上設(shè)置邊框的樣式（border-style）
• 定義元素邊界角的形狀（border-radius）

除此之外，文字組件還具有以下屬性：

字體屬性(Fonts)

• 定義元素的字體列表（font-family）
• 定義文本的字體大小（font-size）
• 定義文本的字體樣式（font-style）
• 指定文本的字體粗細(xì)（font-weight）

文字屬性(Text)

• 設(shè)置內(nèi)聯(lián)內(nèi)容的水平對(duì)齊方式（text-align）
• 指定添加到文本的裝飾（text-decoration）
• 設(shè)置文本行之間的高度（line-height）

圖片組件還具有：

圖片屬性（Image）

• 圖片鏈接（src）

素材組件還具有：

• 背景屬性(Background)

定義元素的背景色（background-color）

我們將上面的操作流程拆解為三步：

1?? 拖動(dòng)左側(cè)的組件到中間的畫布

2?? 選中組件，右側(cè)屬性面板就會(huì)展示與該組件關(guān)聯(lián)的屬性

3?? 編輯右側(cè)屬性，畫布中對(duì)應(yīng)的組件樣式就會(huì)同步更新

1.添加組件到畫布

通過(guò)上一篇文章，我們知道編輯器整體的數(shù)據(jù)結(jié)構(gòu)是這么設(shè)計(jì)的：

state:{
// 所有添加到畫布中的組件數(shù)據(jù)
componentData:[],
}

reducers:{
// 添加組件到componentData
addComponentData(){},
// 編輯組件，更新componentData及curComponent
editComponentData(){},
// 刪除組件
delComponentData(){}
}

那么從左側(cè)組件列表添加組件到畫布的操作其實(shí)就是向componentData中push一條組件數(shù)據(jù)。

這里主要是關(guān)注下組件列表要怎么設(shè)計(jì)：為了便于用戶快速創(chuàng)建活動(dòng)，組件列表最好是預(yù)設(shè)一些模板，其實(shí)就是針對(duì)文字、圖片和素材分別提供一些已有的元素。這樣當(dāng)對(duì)應(yīng)組件點(diǎn)擊添加到畫布時(shí)，對(duì)應(yīng)就會(huì)commit一個(gè)mutation來(lái)修改store中的componentData。

這里組件列表底層渲染也是用的組件庫(kù)，只是不同模板的props不同。

2.選中組件展示其關(guān)聯(lián)屬性

當(dāng)在畫布中選中具體組件時(shí)，我們需要知道此刻是哪個(gè)組件被選中了，意味著需要一個(gè)變量來(lái)存儲(chǔ)當(dāng)前高亮的組件。那么在store中添加setActive和getCurrentElement：

const editorModule = {
  state: {
    componentData: [],
    currentElement: "",
  },
  mutations: {
     addComponentData(state, component) {

     },
     setActive(state, id) {
      state.currentElement = id;
     },
  },
  getters: {
    getCurrentElement: (state) => {
      return state.componentData.find(
        (component) => component.id === state.currentElement
      );
    },
  }
}

當(dāng)在畫布中選中組件時(shí)，就會(huì)觸發(fā)setActive，更新currentElement。（通過(guò)getCurrentElement可以獲取到當(dāng)前正在被操作的組件）。

這個(gè)時(shí)候，怎么在右側(cè)屬性區(qū)域動(dòng)態(tài)展示不同組件的不同屬性呢？

對(duì)于單獨(dú)的組件來(lái)說(shuō)，屬性面板應(yīng)該是語(yǔ)義化的，無(wú)論是開發(fā)還是非開發(fā)同學(xué)，通過(guò)屬性面板的操作區(qū)，就可以直觀的知道一個(gè)組件的屬性是什么，應(yīng)該如何使用和編輯。

那么屬性面板應(yīng)該包含哪些內(nèi)容呢？

1、label：屬性名稱。這個(gè)可以顯式的告訴具體的屬性的作用，比如元素的寬高、邊框、背景顏色等。

2、description：屬性的描述信息。對(duì)于一些特殊屬性，可能第一下通過(guò)label并不能直觀的識(shí)別屬性的含義，添加描述信息可以進(jìn)行詳細(xì)的闡述。

3、content：屬性渲染器。用戶可以基于此實(shí)現(xiàn)對(duì)屬性的修改。最常見的有 textarea、input、select 等。

4、error：屬性校驗(yàn)信息。當(dāng)用戶輸入了不合法的或者類型不匹配時(shí)，可給予適當(dāng)?shù)腻e(cuò)誤提示信息。

通過(guò)以上描述，我們會(huì)發(fā)現(xiàn)，這其實(shí)就是我們常用的表單。

對(duì)應(yīng)上面組件的props信息，我們可以對(duì)這些屬性做一些歸類，那歸類的標(biāo)準(zhǔn)又是什么呢？我認(rèn)為應(yīng)該把屬性與js中的數(shù)據(jù)類型做一下映射，然后在具體的分類下選用合適的渲染器。

我們知道在JavaScript中，一共有七種數(shù)據(jù)類型，字符串（String）、數(shù)字(Number)、布爾(Boolean)、空（Null）、未定義（Undefined）、Symbol和對(duì)象（Object）。其中對(duì)象類型包括：數(shù)組（Array）、函數(shù)（Function）、還有兩個(gè)特殊的對(duì)象：正則（RegExp）和日期（Date）。

這里面的空（Null）、未定義（Undefined）、Symbol和正則（RegExp）在渲染器中基本用不到。

我們先來(lái)看一下字符串（String）、數(shù)字(Number)、布爾(Boolean)和日期（Date）可能渲染的方式：

字符串（String）

數(shù)字(Number)

布爾(Boolean)

日期（Date）

除了這幾種，還有對(duì)象（Object）、數(shù)組（Array）、函數(shù)（Function）。

對(duì)象和數(shù)組屬于較復(fù)雜的類型，不過(guò)我們可以把它抽象為多層級(jí)（可以理解為嵌套）的基礎(chǔ)數(shù)據(jù)類型：

像數(shù)組一般是用下拉框的形式來(lái)展現(xiàn)。

至于函數(shù)（Function），可以采用預(yù)定義的形式：

到這里，不難想到，我們要維護(hù)一個(gè)屬性和表單組件的對(duì)應(yīng)關(guān)系。屬性對(duì)應(yīng)上面的key，像borderColor、text、width、fontFamily這些，那組件呢？組件其實(shí)就是對(duì)屬性的具體呈現(xiàn)，像width可以用數(shù)字輸入框、text可以用普通輸入框，但是對(duì)于一些比較復(fù)雜的特性，我們自己去實(shí)現(xiàn)這些組件，就顯得捉襟見肘了，這個(gè)時(shí)候我們就可以考慮和現(xiàn)有的組件庫(kù)做一下結(jié)合了（這里我采用的是Ant Design Vue）。

那么這樣，屬性prop和component基礎(chǔ)的對(duì)應(yīng)關(guān)系就有了：

const mapPropsToComponents = {
  text: {
   component: "a-input",
  },
  width: {
   component: "a-input-number",
  },
  borderWidth: {
   component: "a-slider",
  },
  // ...
}

但這只是滿足了常規(guī)的基礎(chǔ)組件設(shè)計(jì)，像一些獨(dú)有的屬性或者基礎(chǔ)組件不能滿足的情況，我們需要對(duì)其做一定擴(kuò)展：

上面提到的上傳組件和顏色選擇組件是需要我們單獨(dú)去實(shí)現(xiàn)的。

3.編輯屬性，畫布同步更新

上面只是初步建立了屬性和組件的對(duì)應(yīng)關(guān)系，組件初始值的展示、復(fù)雜組件的展示以及表單值更新后，畫布如何同步更新，這些問題我們還都沒有解決。

其實(shí)把問題簡(jiǎn)化，這就是表單的回顯和更新問題。

以我以往的經(jīng)驗(yàn)來(lái)看：表單組件在設(shè)計(jì)時(shí)，有兩點(diǎn)是必須的：

• 表單初始值（默認(rèn)value），供初始展示使用
• 表單屬性更改的事件（默認(rèn)為change）

對(duì)于不同的表單，初始值和屬性更改后，參數(shù)的處理是不一樣的：

• 像高度、寬度這種數(shù)字類型的，傳入表單時(shí)應(yīng)保證是number(24)類型，屬性更改后，事件參數(shù)應(yīng)該是string(24px)類型的
• 字體加粗與否、傾斜與否、加下劃線與否，傳入表單時(shí)應(yīng)保證是boolean(true/false)類型，屬性更改后，事件參數(shù)應(yīng)該是string(bold/normal)類型的

所以給每一個(gè)屬性在傳入表單和事件更改后都要加一個(gè)額外的轉(zhuǎn)化函數(shù)去處理值：

• initialValueConvert
• eventChangeValueConvert

還有對(duì)屬性進(jìn)行賦值時(shí)，不是所有的表單控件接收的都是value，像checkbox就是checked，這種單獨(dú)抽一個(gè)屬性valueProp去控制即可。

其次，像上面提到的復(fù)雜組件（我們這里是指父子層級(jí)）的渲染，除了component還要多加一個(gè)subComponent。

完善后，屬性prop和component的對(duì)應(yīng)關(guān)系為：

const mapPropsToComponents = {
    text: {
        component: "textarea-fix",
        eventName: "change",
        valueProp: "value",
        initialValueConvert: (v: any) => v,
        eventChangeValueConvert: (e: any) => e.target.value,
        text: "文本",
    },
    width: {
        component: "a-input-number",
        eventName: "change",
        valueProp: "value",
        initialValueConvert: (v: string) => (v ? parseInt(v) : ""),
        eventChangeValueConvert: (e: number) => (e ? `${e}px` : ""),
        text: "寬度",
    },
    textDecoration: {
        component: "icon-switch",
        eventName: "change",
        initialValueConvert: (v: string) => v === "underline",
        eventChangeValueConvert: (e: boolean) => (e ? "underline" : "none"),
        valueProp: "checked",
    },
    backgroundSize: {
        component: "a-select",
        eventName: "change",
        initialValueConvert: (v: any) => v,
        eventChangeValueConvert: (e: any) => e,
        subComponent: "a-select-option",
        text: "背景大小",
        options: [
          { value: "contain", text: "自動(dòng)縮放" },
          { value: "cover", text: "自動(dòng)填充" },
          { value: "", text: "默認(rèn)" },
        ],
   },
   // ...
}

我們的數(shù)據(jù)始終保持自上而下的順序，也就是說(shuō)表單更新最終要反射回到總體的 store 當(dāng)中去。這個(gè)時(shí)候我們?cè)趯?duì)應(yīng)的組件當(dāng)中發(fā)射出一個(gè)事件（change），當(dāng) change 發(fā)生的時(shí)候，我們能夠知道是哪個(gè)元素的哪個(gè)屬性，以及新的值是什么，我們就用這些信息更新這個(gè)值，這樣 store完成更新，元素的 props 發(fā)生更新，那么整個(gè)數(shù)據(jù)流動(dòng)就完成了。

4.畫布區(qū)域交互設(shè)計(jì)實(shí)現(xiàn)

上面說(shuō)了這么多，基本都是圍繞左側(cè)組件區(qū)域、中間畫布區(qū)域、右側(cè)屬性區(qū)域相互之間的數(shù)據(jù)流動(dòng)來(lái)講的。最后來(lái)說(shuō)一下畫布區(qū)域本身一些比較復(fù)雜的交互實(shí)現(xiàn)。

我大概整理了這幾種：

• 拖拽（組件在畫布中移動(dòng)）
• 組件圖層
• 放大/縮小
• 撤銷/重做

拖拽（組件在畫布中移動(dòng)）

這個(gè)相對(duì)比較簡(jiǎn)單，就是mousedown、mousemove和mouseup事件的結(jié)合使用：在組件上按下鼠標(biāo)后，記錄組件當(dāng)前位置，也就是 x、y 坐標(biāo)（對(duì)應(yīng)的是 css 中的 left 和 top）；每次鼠標(biāo)移動(dòng)時(shí)用當(dāng)前最新的 xy 坐標(biāo)減去最開始的 xy 坐標(biāo)，計(jì)算出移動(dòng)的距離，然后更新組件位置；鼠標(biāo)抬起時(shí)結(jié)束移動(dòng)。

組件圖層

圖層面板主要是控制組件的顯示/隱藏、不同組件的層級(jí)關(guān)系以及點(diǎn)擊選中。

這里主要說(shuō)一下層級(jí)關(guān)系吧，正常情況下，我們會(huì)選擇使用z-index來(lái)控制層級(jí)。但是這里我沒有使用z-index，而是利用了層疊領(lǐng)域黃金準(zhǔn)則的第二條。

層疊領(lǐng)域黃金準(zhǔn)則：1、誰(shuí)大誰(shuí)上： 當(dāng)具有明顯的層疊水平標(biāo)示的時(shí)候，如識(shí)別的 z-indx 值，在同一個(gè)層疊上下文領(lǐng)域，層疊水平值大的那一個(gè)覆蓋小的那一個(gè)。2、后來(lái)居上： 當(dāng)元素的層疊水平一致、層疊順序相同的時(shí)候，在 DOM 流中處于后面的元素會(huì)覆蓋前面的元素。

為什么選擇第二個(gè)而沒有選擇最常見的第一條呢？首先，我們需要一個(gè)圖層列表可以對(duì)每個(gè)組件對(duì)應(yīng)的圖層進(jìn)行排序，其實(shí)就是對(duì)store中的components進(jìn)行排序，也就是數(shù)組排序了，那么在圖層列表中，如果你想增加某一圖層的層級(jí)，把它放置到后面就可以了（這樣渲染時(shí)，數(shù)組后面的元素就會(huì)處在 DOM 流的后面了。對(duì)應(yīng)的層疊順序也就居上了），這樣不僅操作方便，也不用增加額外冗余代碼，可謂一舉兩得。

放大/縮小

核心實(shí)現(xiàn)：在畫布組件的四個(gè)角（↖?、↗?、↙?、↘?）分別加一個(gè)小圓點(diǎn)：

左上：組件 left、top 均減小；width、height 均變大

右上：組件 left 不變、top 減小；width、height 均變大

左下：組件 left 減小、top 不變；width、height 均變大

右下：組件 left、top 均不變；width、height 均變大

撤銷/重做

撤銷、重做其實(shí)是我們平時(shí)一直在用的操作。對(duì)應(yīng)快捷鍵一般就是? Z / Ctrl+Z、?? Z / Ctrl+Shift+Z。這個(gè)功能是很常見的，他可以極大的提升用戶體驗(yàn)，提高編輯效率，但是用代碼應(yīng)該如何實(shí)現(xiàn)呢？