充气娃娃,一二三四视频社区在线,成版人app网站

這是可視化編輯器 Gaea-Editor 的第一篇連載分析文章，希望我能在有限的篇幅講清楚制作這個(gè)網(wǎng)頁(yè)編輯器的動(dòng)機(jī)，以及可能帶來(lái)的美好使用前景（畫(huà)大餅）。它會(huì)具有如下幾個(gè)特征：

運(yùn)行在網(wǎng)頁(yè)
文檔流布局，絕對(duì)定位同時(shí)支持
對(duì)插入的任何 React 組件都可以直接作為編輯元素拖拽到頁(yè)面中
兼容 React-Native 的 web 組件可以讓它生成 android 和 ios 原生頁(yè)面
擁有 Gaea-Preview 套件，傳入 Gaea-Editor 生成的 json，可以立刻生成頁(yè)面
擁有 Gaea-web-components Gaea-native-components 分別提供網(wǎng)頁(yè)、原生基礎(chǔ)最小粒度的組件
可以定制任何 React 組件插入到編輯器中
像 chrome-devtools 一樣靈活，可以跨層級(jí)排序拖拽任何編輯區(qū)的元素
可以自定義組合模板，三下五除二搞定相似的需求

當(dāng)然看完這篇文章，不僅限于了解這個(gè)編輯器的功能，我會(huì)非常詳細(xì)介紹其設(shè)計(jì)細(xì)節(jié)，只要你仔細(xì)讀它，完全可以做出自己的網(wǎng)頁(yè)編輯器 ^_。

在說(shuō)這個(gè)可視化編輯器之前，不得不提到 React，這是我創(chuàng)作它的動(dòng)機(jī)。雖然不確定 React 能火多久，但它帶來(lái)的組件化掀起了一場(chǎng)前端界的工業(yè)革命，當(dāng)然，組件化這個(gè)理念也不是 React 首創(chuàng)，但 React 大大降低了組件化的成本，就像發(fā)明了活字印刷術(shù)，讓只有貴族才買(mǎi)得起的書(shū)本普及到了千家萬(wàn)戶。

在全民組件化的時(shí)代里，我寫(xiě)過(guò)幾篇文章介紹如何應(yīng)用和管理組件：http://www.lxweimin.com/p/aaca5047a149 以及組件庫(kù)的維護(hù)經(jīng)驗(yàn)：https://github.com/fex-team/fit/issues/3 。現(xiàn)在組件化正在越來(lái)越普及，我們掌握了組件開(kāi)發(fā)和管理的規(guī)律后，項(xiàng)目結(jié)構(gòu)組織，團(tuán)隊(duì)間協(xié)作已經(jīng)取得了飛速進(jìn)步，組件化帶來(lái)效率的提升也會(huì)日漸枯竭，但可視化編輯可能是一條突破瓶頸之路，第一，在有了現(xiàn)成組件的基礎(chǔ)上，將其遷移到可視化編輯平臺(tái)的成本非常小，第二，代碼之外的頁(yè)面開(kāi)發(fā)更加直觀，加上部分代碼的輔佐會(huì)讓結(jié)構(gòu)組織更高效（類似 Unity 引擎）。

React 與原生拖拽結(jié)合

網(wǎng)頁(yè)編輯器第一步，也是最重要的一步，就是拖拽功能了，我們希望最終效果如圖所示：

drag.gif

如圖所示，支持隨意拖拽、拖拽動(dòng)畫(huà)，跨父級(jí)拖拽。我們使用 sortablejs 可以達(dá)到此效果，這篇文章重點(diǎn)就是介紹如何結(jié)合到 React。

使用 sortable.js

為了支持嵌套拖拽，我們使用開(kāi)發(fā)版地址安裝 "sortablejs":"git://github.com/RubaXa/Sortable.git#dev"

將 sortable 與 react 結(jié)合我們首先會(huì)想到在拖拽結(jié)束后重新 render，但這樣做有如下幾個(gè)缺點(diǎn)：

sortable 因?yàn)橥献н^(guò)程中改變了 dom 結(jié)構(gòu)，所以操作流暢，但因此生成的 dom 節(jié)點(diǎn)脫離了 react 的控制
排序拖拽后會(huì)，sortable 會(huì)刪除之前拖拽的節(jié)點(diǎn)，導(dǎo)致 react diff 算法刪除元素時(shí)發(fā)現(xiàn) dom 已經(jīng)消失

總結(jié)來(lái)說(shuō)就是既要讓 sortable 操作 dom，又不能讓 dom 操作導(dǎo)致脫離 react 的控制，我們采用操作回放的方式，將 sortable 操作結(jié)束后的 dom 修改回退，再將操作結(jié)果狀態(tài)用 react 刷新。

右側(cè)菜單配置

對(duì)右側(cè)菜單配置如下：

Sortable.create(ReactDOM.findDOMNode(this.dragContainerInstance), {
    // 放在一個(gè)組里,可以跨組拖拽
    group: {
        name: 'gaea-layout',
        pull: 'clone',
        put: false
    },
    sort: false,
    delay: 0,
    onStart: (event: any) => {
        // 存儲(chǔ)開(kāi)始拖拽的位置和拖拽結(jié)束的位置
        // ...
    },
    onEnd: (event: any) => {
        // 拖拽菜單時(shí)，真實(shí)元素會(huì)被拖拽走，拖拽成功的話元素會(huì)重復(fù), 沒(méi)成功拖拽會(huì)被添加到末尾
        // 所以先移除 clone 的元素（吐槽下, 拖走的才是真的, 留下的才是 clone 的）
        // 有 parentNode, 說(shuō)明拖拽完畢還是沒(méi)有被清除, 說(shuō)明被拖走了, 因?yàn)槿绻麤](méi)真正拖動(dòng)成功, clone 元素會(huì)被刪除
        if (event.clone.parentNode) {
            // 有 clone, 說(shuō)明已經(jīng)真正拖走了
            this.dragContainerDomInstance.removeChild(event.clone)
            // 再把真正移過(guò)去的弄回來(lái)
            if (this.lastDragStartIndex === this.dragContainerDomInstance.childNodes.length) {
                // 如果拖拽的是最后一個(gè)
                this.dragContainerDomInstance.appendChild(event.item)
            } else {
                // 拖拽的不是最后一個(gè)
                this.dragContainerDomInstance.insertBefore(event.item, this.dragContainerDomInstance.childNodes[this.lastDragStartIndex])
            }
        } else {
            // 沒(méi)拖走, 只是晃了一下, 不用管了
        }
    }
})

如上代碼注釋寫(xiě)的很詳盡，解釋一下就是，從菜單拖拽的配置要用 pull:clone 的方式配置，這樣同一個(gè)元素才可以拖拽多次。put:false 讓菜單不能被其它元素拖入。

當(dāng)開(kāi)始拖拽時(shí)，保存拖拽后的位置，便于找到用戶拖拽的元素，在頁(yè)面生成實(shí)例，同時(shí)保存拖拽前的位置，便于拖拽結(jié)束后恢復(fù)元素。

所以拖拽結(jié)束后，先判斷 event.clone.parentNode，如果是空，說(shuō)明元素并沒(méi)有被拖走，所以不需要處理，否則需要先刪除原先位置留下的 clone dom，因?yàn)檫@個(gè)元素不受 react 控制，再將真實(shí)拖走的元素還原到之前的位置

視圖區(qū)域配置

編輯器視圖區(qū)域的 sortable 配置比較長(zhǎng)，因此拆解分析。

`group` 配置：

group: {
    name: 'gaea-layout',
    pull: true,
    put: true
}

這個(gè)很容易理解，因?yàn)橐晥D區(qū)域的元素可以被移走，也可以被其它元素移入，因此 pull 和 put 都是 true。

開(kāi)始拖拽時(shí)

onStart: (event: any) => {
    // 保存拖拽前、后的位置
}

拖拽結(jié)束時(shí)

onEnd: (event: any) => {
    // 略
}

拖拽結(jié)束不需要做特殊處理，但可以做一些視覺(jué)設(shè)置，比如告訴用戶拖拽結(jié)束了。

有元素新增時(shí)

onAdd: (event: any)=> {
    // 取消 srotable 對(duì) dom 的修改
    // 刪掉 dom 元素, 讓 react 去生成 dom
    if (this.props.viewport.currentMovingComponent.isNew) {
        // 是新拖進(jìn)來(lái)的, 不用管, 因?yàn)楣ぞ邫跁?huì)把它收回去
        // 為什么不刪掉? 因?yàn)檫@個(gè)元素不論是不是 clone, 都被移過(guò)來(lái)了, 不還回去 react 在更新 dom 時(shí)會(huì)無(wú)法找到
    } else {
        // 如果是從某個(gè)元素移過(guò)來(lái)的（新增的,而不是同一個(gè)父級(jí)改變排序）
        // 把這個(gè)元素還給之前拖拽的父級(jí)
        if (this.props.viewport.dragStartParentElement.childNodes.length === 0) {
            // 之前只有一個(gè)元素
            this.props.viewport.dragStartParentElement.appendChild(event.item)
        } else if (this.props.viewport.dragStartParentElement.childNodes.length === this.props.viewport.dragStartIndex) {
            // 是上一次位置是最后一個(gè), 而且父元素有多個(gè)元素
            this.props.viewport.dragStartParentElement.appendChild(event.item)
        } else {
            // 不是最后一個(gè), 而且有多個(gè)元素
            // 插入到它下一個(gè)元素的前一個(gè)
            this.props.viewport.dragStartParentElement.insertBefore(event.item, this.props.viewport.dragStartParentElement.childNodes[this.props.viewport.dragStartIndex])
        }
    }
}

有元素新增后，有兩種情況：新增元素，或者從已有元素中拖拽進(jìn)來(lái)新增。

如果是從工具欄拖拽進(jìn)來(lái)新增的元素，只需要用 react 重新渲染一遍即可。

如果是從其它視圖元素中移入進(jìn)來(lái)的，需要把這個(gè)元素還原到之前拖拽的位置，這樣就回退到 sortable 操作之前的狀態(tài)，再用 react 渲染這兩個(gè)父級(jí)組件。

同一父級(jí)內(nèi)元素位置更新時(shí)

onUpdate: (event: any)=> {
    // 同一個(gè)父級(jí)下子元素交換父級(jí)
    // 取消 srotable 對(duì) dom 的修改, 讓元素回到最初的位置即可復(fù)原
    const oldIndex = event.oldIndex as number
    const newIndex = event.newIndex as number
    if (this.props.viewport.dragStartParentElement.childNodes.length === oldIndex + 1) {
        // 是從最后一個(gè)元素開(kāi)始拖拽的
        this.props.viewport.dragStartParentElement.appendChild(event.item)
    } else {
        if (newIndex > oldIndex) {
            // 如果移到了后面
            this.props.viewport.dragStartParentElement.insertBefore(event.item, this.props.viewport.dragStartParentElement.childNodes[oldIndex])
        } else {
            // 如果移到了前面
            this.props.viewport.dragStartParentElement.insertBefore(event.item, this.props.viewport.dragStartParentElement.childNodes[oldIndex + 1])
        }
    }
    this.props.viewport.sortComponents(this.props.mapUniqueKey, event.oldIndex as number, event.newIndex as number)
}

我們只需要對(duì)元素位置進(jìn)行還原，之后根據(jù)起點(diǎn)位置和終點(diǎn)位置模擬元素移動(dòng)，再使用 react 渲染即可。這里需要注意， sortable 的拖拽不是簡(jiǎn)單的a b互換，而是 a -> b，下面用圖簡(jiǎn)單描述一下：

Paste_Image.png

如上圖所示，同一個(gè)父級(jí)下有6個(gè)元素，當(dāng)我們拖拽第一個(gè)元素到第5個(gè)元素時(shí)，排序不是變成了 5 2 3 4 1 6，而是如下圖所示：

Paste_Image.png

不可避免的產(chǎn)生了互換，我們逐一互換元素位置，然后更新父級(jí)元素子元素的位置。注意此時(shí)最佳狀態(tài)是不觸發(fā) react 元素渲染，我們只要保證子元素的 key 不變, react diff 算法會(huì)自動(dòng)移動(dòng) dom 節(jié)點(diǎn)，而不是重新渲染 1 2 3 4 5 這 5 個(gè)子節(jié)點(diǎn)。

當(dāng)元素被移走時(shí)

onRemove: (event: any)=> {
    // 渲染父級(jí)元素，減少一個(gè)子元素在當(dāng)前位置
}

當(dāng)元素被移走時(shí)，不會(huì)觸發(fā) onUpdate 方法，而會(huì)觸發(fā) onAdd 方法，但是我們已經(jīng)在 onAdd 方法中將移走的元素還原回去，因此這里不需要做任何處理，相當(dāng)于沒(méi)有改動(dòng)，我們只需要更新 react 父級(jí)元素重新渲染，讓 react 將元素移走即可。

總結(jié)

基于以上菜單區(qū)域和視圖區(qū)域的博弈，終于將 sortable 與 react 渲染完美結(jié)合起來(lái)，然而不用擔(dān)心有什么副作用，因?yàn)槲覀円呀?jīng)將所有 sortable 的操作還原，所以實(shí)際上只用了它的拖拽過(guò)程已經(jīng)拖拽結(jié)果，忙到后來(lái)其實(shí)沒(méi)有改變?nèi)魏?dom 結(jié)構(gòu)，最終 dom 元素的變化還是由 react 來(lái)控制。

后續(xù)系列我們會(huì)繼續(xù)剖析實(shí)現(xiàn)部分，以及放上倉(cāng)庫(kù)地址。解析到底是如何將元素放在視圖區(qū)域，并且并支持無(wú)限層級(jí)嵌套的，敬請(qǐng)期待！

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

React Editor 應(yīng)用編輯器(1) - 拖拽功能剖析

React Editor 應(yīng)用編輯器(1) - 拖拽功能剖析

React 與原生拖拽結(jié)合

使用 sortable.js

右側(cè)菜單配置

視圖區(qū)域配置

`group` 配置：

開(kāi)始拖拽時(shí)

拖拽結(jié)束時(shí)

有元素新增時(shí)

同一父級(jí)內(nèi)元素位置更新時(shí)

當(dāng)元素被移走時(shí)

總結(jié)

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

React Editor 應(yīng)用編輯器(1) - 拖拽功能剖析

React 與原生拖拽結(jié)合

使用 sortable.js

右側(cè)菜單配置

視圖區(qū)域配置

group 配置：

開(kāi)始拖拽時(shí)

拖拽結(jié)束時(shí)

有元素新增時(shí)

同一父級(jí)內(nèi)元素位置更新時(shí)

當(dāng)元素被移走時(shí)

總結(jié)

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

`group` 配置：