日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

去年上線的可視化編輯器 H5-dooring 至今已有一年的時間，期間有很多熱心的網(wǎng)友和大佬提出了非常多寶貴的建議，我們也在一步步實現(xiàn)中，以下是幾個比較典型的低代碼可視化平臺需求:

公司主營業(yè)務：成都做網(wǎng)站、成都網(wǎng)站制作、移動網(wǎng)站開發(fā)等業(yè)務。幫助企業(yè)客戶真正實現(xiàn)互聯(lián)網(wǎng)宣傳，提高企業(yè)的競爭能力。創(chuàng)新互聯(lián)建站是一支青春激揚、勤奮敬業(yè)、活力青春激揚、勤奮敬業(yè)、活力澎湃、和諧高效的團隊。公司秉承以“開放、自由、嚴謹、自律”為核心的企業(yè)文化，感謝他們對我們的高要求，感謝他們從不同領域給我們帶來的挑戰(zhàn)，讓我們激情的團隊有機會用頭腦與智慧不斷的給客戶帶來驚喜。創(chuàng)新互聯(lián)建站推出廣陽免費做網(wǎng)站回饋大家。

• 出碼能力(即源碼下載功能)
• 組件交互(即組件支持業(yè)務中常用的鏈接跳轉，彈窗交互，自定義事件等)
• 數(shù)據(jù)源管理(即用戶創(chuàng)建的不同頁面擁有共享數(shù)據(jù)的能力，不同組件之間也有共享數(shù)據(jù)的能力)
• 組件商店(即用戶可以自主生產(chǎn)組件，定義組件，接入組件數(shù)據(jù)的能力)
• 布局能力(即用戶可以選擇不同的布局方案來設計頁面)
• 常用功能集成(頁面截圖，微信分享，debug能力)

上面的這些功需求已經(jīng)在 H5-dooring 陸續(xù)實現(xiàn)了，在我之前的文章中也有對應的技術分享。但是為了讓更多的人能低成本的擁有自己的可視化搭建系統(tǒng)，我們團隊的大佬花了非常多的時間研究和沉淀，最近也開源了一款可視化搭建框架 dooringx-lib，我們可以基于它輕松制作可視化編輯器，而無需考慮內(nèi)部的實現(xiàn)細節(jié)，接下來我就和大家分享一下這款可視化框架的使用方式和實現(xiàn)思路，同時也非常感謝 dooring可視化團隊 各位大佬們的辛勤付出。

可視化搭建框架基本使用和技術實現(xiàn)

為了讓大家更好的理解可視化搭建框架，我這里舉幾個形象的例子:

antd —— antd-pro

我們都知道 antd 是流行的前端組件庫，那么基于它上層封裝的管理后臺 antd-pro 就是它的上層應用。

GrapesJS —— craft.js

GrapesJS 是一款國外的頁面編輯器框架(詳細介紹可參考我之前的文章 這款國外開源框架, 讓你輕松構建自己的頁面編輯器) ，那么 craft.js 就是它的上層應用框架。

dooringx-lib —— dooringx

dooringx-lib 是一款可視化搭建框架，同理 dooringx 就是基于 dooringx-lib 的可視化編輯器。

之所以要介紹它們的區(qū)別，是因為之前有很多朋友對這塊概念理解的不是很清晰，在了解了可視化搭建框架 的 “內(nèi)涵” 之后，我們開始今天的核心內(nèi)容。

1.技術棧

在分享框架實現(xiàn)思路之前當然要自報家門，框架實現(xiàn)上我們還是采用熟悉的 React 生態(tài)，移動端組件庫采用的眾安團隊的 zarm，編輯器應用層采用的 antd，至于其他的比如拖拽，參考線，狀態(tài)管理，插件機制等都是我們團隊大佬自研的方案。如果你是 vue 或者其他技術棧為主的團隊，也可以參考實現(xiàn)思路，相信也會對你有一定的啟發(fā)。

2.基本使用方式

在開始深入之前我們先看看如何使用這款框架，我們只需要按照如下方式即可安裝使用:

 
 
 
 

  
  
  
  
npm/yarn install dooringx-lib
 
 
 
 

同時我們還提供了基礎的使用demo，方便大家在自己的工程中快速上手:

 
 
 
 

  
  
  
  
# 克隆項目
  
  
  
  
# cnpmjs
  
  
  
  
git clone https://github.com.cnpmjs.org/H5-Dooring/dooringx.git
  
  
  
  

  
  
  
  
# or
  
  
  
  
git clone https://github.com/H5-Dooring/dooringx.git
  
  
  
  

  
  
  
  

  
  
  
  
# 進入項目目錄
  
  
  
  
cd dooringx
  
  
  
  

  
  
  
  
# 安裝依賴
  
  
  
  
yarn install
  
  
  
  

  
  
  
  
# 啟動基礎示例
  
  
  
  
yarn start:example
  
  
  
  

  
  
  
  
# 啟動 dooringx-lib
  
  
  
  
yarn start
  
  
  
  

  
  
  
  
# 啟動 dooringx doc 文檔
  
  
  
  
yarn start:doc
  
  
  
  

  
  
  
  
yarn build
 
 
 
 

demo 的 github 項目如下:

github地址: https://github.com/H5-Dooring/dooringx

在了解完使用方式之后，我們來看看基本架構和實現(xiàn)思路。

3.dooringx-lib基礎架構和工作機制

上圖就是我根據(jù)目前 dooringx-lib 的項目架構梳理的架構圖，基本包含了搭建化編輯框架的大部分必備模塊。為了保證框架的靈活性，我們還可以按需安裝對應的功能組件，開發(fā)自定義的組件等。如下是一個基本的導入案例:

 
 
 
 

  
  
  
  
import {
  
  
  
  
    RightConfig,
  
  
  
  
    Container,
  
  
  
  
    useStoreState,
  
  
  
  
    innerContainerDragUp,
  
  
  
  
    LeftConfig,
  
  
  
  
    ContainerWrapper,
  
  
  
  
    Control,
  
  
  
  
} from 'dooringx-lib';
 
 
 
 

我們將整個框架拆分成了不同的模塊，這些模塊既相互獨立又可以相互關聯(lián)。完整的工作流程如下:

由上圖可以看出，我們只需要擁有基礎的業(yè)務研發(fā)能力，就可以借助 dooringx-lib 構建一個屬于自己的搭建平臺，就好比任何程序的本質(zhì): 數(shù)據(jù)和邏輯。

4.dooringx-lib插件開發(fā)

接下來我會和大家分享 dooringx-lib 的插件開發(fā)方式和具體實現(xiàn)(如何導入插件，如何編寫組件，如何注冊函數(shù)等)，如果大家感興趣的話也可以跟著下面的方式實踐一下。

4.1 如何導入組件

我們在上圖可以看到左側是我們的組件物料區(qū)，分為基礎組件，媒體組件，可視化組件，它們的添加會統(tǒng)一放在 LeftRegistMap 數(shù)組中來管理，其基本結構如下:

 
 
 
 

  
  
  
  
const LeftRegistMap: LeftRegistComponentMapItem[] = [
  
  
  
  
  {
  
  
  
  
      type: 'basic', // 組件類別
  
  
  
  
      component: 'button', // 組件名稱
  
  
  
  
      img: 'icon-anniu', // 組件icon
  
  
  
  
      displayName: '按鈕', // 組件中文名
  
  
  
  
      urlFn: () => import('./registComponents/button'),  // 注冊回調(diào)
  
  
  
  
  },
  
  
  
  
];
 
 
 
 

左側組件支持同步導入或者異步導入。

如果需要異步導入組件，則需要填寫 urlFn，需要一個返回 promise 的函數(shù)。也可以支持遠程載入組件，只要 webpack 配上即可。

如果需要同步導入組件，則需要將組件放入配置項的 initComponentCache 中，這樣在載入時便會注冊進 componentRegister 里。

 
 
 
 

  
  
  
  
initComponentCache: {
  
  
  
  
  modalMask: { component: MmodalMask },  
  
  
  
  
},
 
 
 
 

4.2 如何定制左側面板

左側面板傳入 leftRenderListCategory 即可。

 
 
 
 

  
  
  
  
leftRenderListCategory: [
  
  
  
  
  {
  
  
  
  
type: 'basic',
  
  
  
  
icon: ,
  
  
  
  
displayName: '基礎組件',
  
  
  
  
  },
  
  
  
  
  {
  
  
  
  
type: 'xxc',
  
  
  
  
icon: ,
  
  
  
  
custom: true,
  
  
  
  
customRender: 
我是自定義渲染
,
  
  
  
  
  },
  
  
  
  
],
 
 
 
 

type 是分類，左側組件顯示在哪個分類由該字段決定。icon 則是左側分類小圖標(如上圖所示)。當 custom 為 true 時，可以使用 customRender 自定義渲染。

4.3 開發(fā)一個自定義的可視化組件

組件需要導出一個由 ComponentItemFactory 生成的對象:

 
 
 
 

  
  
  
  
const MButton = new ComponentItemFactory(
  
  
  
  
 'button',
  
  
  
  
 '按鈕',
  
  
  
  
 {
  
  
  
  
style: [
  
  
  
  
 createPannelOptions('input', {
  
  
  
  
  receive: 'text', 
  
  
  
  
  label: '文字',
  
  
  
  
 }),
  
  
  
  
],
  
  
  
  
animate: [createPannelOptions('animateControl', {})],
  
  
  
  
actions: [createPannelOptions('actionButton', {})],
  
  
  
  
 },
  
  
  
  
 {
  
  
  
  
props: {
  
  
  
  
 ...
  
  
  
  
 text:'x.dooring'// input配置項組件接收的初始值
  
  
  
  
},
  
  
  
  
 },
  
  
  
  
 (data, context, store, config) => {
  
  
  
  
return ;
  
  
  
  
 },
  
  
  
  
 true
  
  
  
  
);
  
  
  
  

  
  
  
  
export default MButton;
 
 
 
 

其中第一個參數(shù)為組件注冊名，第二個參數(shù)用來展示使用。

第三個參數(shù)用來配置右側面板的配置項組件。其中鍵為右側面板的分類，值為配置項組件數(shù)組。

第四個參數(shù)會配置組件的初始值，特別注意的是，制作組件必須要有初始寬度高度(非由內(nèi)容撐開)，否則會在適配時全選時產(chǎn)生問題。

這個初始值里有很多有用的屬性，比如fixed代表使用固定定位，可以結合配置項更改該值，使得組件可以fixed定位。

還有 canDrag 類似于鎖定命令，鎖定的元素不可拖拽。

初始值里的 rotate 需要個對象，value 代表旋轉角度，canRotate 代表是否可以操作旋轉。(0.7.0版本開始支持)

第五個參數(shù)是個函數(shù)，你將獲得配置項中的 receive 屬性(暫且都默認該配置為receive)傳來的配置，比如上例中 receive 的是 text，則該函數(shù)中 data 里會收到該字段。

context 一般只有 preview 和 edit，用來進行環(huán)境判斷。

config 可以拿到所有數(shù)據(jù)，用來制作事件時使用。

第六個參數(shù) resize 是為了判斷是否能進行縮放，當為 false 時，無法進行縮放。

第七個參數(shù) needPosition，某些組件移入畫布后會默認采取拖拽的落點，該配置項默認為 true, 就是需要拖拽的位置，為 false 時將使用組件自身 top 和 left 定位來放置。

4.4 事件注冊

注冊時機

事件可以細分為 注冊時機 和 函數(shù)，組件內(nèi)可以通過 hook 的方式來實現(xiàn)注冊時機：

 
 
 
 

  
  
  
  
useDynamicAddEventCenter(pr, `${pr.data.id}-init`, '初始渲染時機'); //注冊名必須帶id 約定！
  
  
  
  
useDynamicAddEventCenter(pr, `${pr.data.id}-click`, '點擊執(zhí)行時機');
 
 
 
 

useDynamicAddEventCenter 第一個參數(shù)是 render 的四個參數(shù)組成的對象。第二個參數(shù)是注冊的時機名，必須跟 id 相關，這是約定，否則多個組件可能會導致名稱沖突，并且方便查找該時機。

注冊完時機后，我們需要將時機放入對應的觸發(fā)位置上，比如這個 button 的點擊執(zhí)行時機就放到 onclick 中：

 
 
 
 

  
  
  
  

  
  
  
  
    onClick={() => {
  
  
  
  
eventCenter.runEventQueue(`${pr.data.id}-click`, pr.config);
  
  
  
  
    }}
  
  
  
  
>
  
  
  
  
    x.dooring
  
  
  
  
 
 
 
 
 

其中第一個參數(shù)則為注冊的時機名，第二個為 render 函數(shù)中最后一個參數(shù) config

函數(shù)注冊

函數(shù)由組件拋出，可以加載到事件鏈上。比如，注冊個改變文本函數(shù)，那么我可以在任意組件的時機中去調(diào)用該函數(shù)，從而觸發(fā)該組件改變文本。

函數(shù)注冊需要放入 useEffect 中，在組件卸載時需要卸載函數(shù)!否則會導致函數(shù)越來越多。

 
 
 
 

  
  
  
  
useEffect(() => {
  
  
  
  
const functionCenter = eventCenter.getFunctionCenter();
  
  
  
  
const unregist = functionCenter.register(
  
  
  
  
 `${pr.data.id}+改變文本函數(shù)`,
  
  
  
  
 async (ctx, next, config, args, _eventList, iname) => {
  
  
  
  
  const userSelect = iname.data;
  
  
  
  
  const ctxVal = changeUserValue(
  
  
  
  
   userSelect['改變文本數(shù)據(jù)源'],
  
  
  
  
   args,
  
  
  
  
   '_changeval',
  
  
  
  
   config,
  
  
  
  
   ctx
  
  
  
  
  );
  
  
  
  
  const text = ctxVal[0];
  
  
  
  
  setText(text);
  
  
  
  
  next();
  
  
  
  
 },
  
  
  
  
 [
  
  
  
  
  {
  
  
  
  
   name: '改變文本數(shù)據(jù)源',
  
  
  
  
   data: ['ctx', 'input', 'dataSource'],
  
  
  
  
   options: {
  
  
  
  
    receive: '_changeval',
  
  
  
  
    multi: false,
  
  
  
  
   },
  
  
  
  
  },
  
  
  
  
 ]
  
  
  
  
);
  
  
  
  
return () => {
  
  
  
  
 unregist();
  
  
  
  
};
  
  
  
  
}, []);
 
 
 
 

函數(shù)中參數(shù)與配置見后面的函數(shù)開發(fā)。

4.5 右側面板開發(fā)

為了開發(fā)自定義的右側屬性面板，我們只要將開發(fā)的組件配成一個對象放入 initFormComponents 即可。為了良好的開發(fā)體驗，需要定義個 formMap 類型：

 
 
 
 

  
  
  
  
export interface FormBaseType {
  
  
  
  
    receive?: string;
  
  
  
  
}
  
  
  
  
export interface FormInputType extends FormBaseType {
  
  
  
  
    label: string;
  
  
  
  
}
  
  
  
  
export interface FormActionButtonType {}
  
  
  
  
export interface FormAnimateControlType {}
  
  
  
  
export interface FormMap {
  
  
  
  
    input: FormInputType;
  
  
  
  
    actionButton: FormActionButtonType;
  
  
  
  
    animateControl: FormAnimateControlType;
  
  
  
  
}
 
 
 
 

formMap 的鍵名就是 initFormComponents 鍵名，formMap 的值對應組件需要收到的值。

以 input 組件為例，F(xiàn)ormInputType 此時有2個屬性: label, receive。

那么在開發(fā)該組件時，props 會收到：

 
 
 
 

  
  
  
  
interface MInputProps {
  
  
  
  
    data: CreateOptionsRes;
  
  
  
  
    current: IBlockType;
  
  
  
  
    config: UserConfig;
  
  
  
  
}
 
 
 
 

也就是 data 是 formMap 類型，而 current 是當前點擊的組件，config 就不用說了。

還記得在左側組件開發(fā)中的第三個參數(shù)嗎?這樣就都關聯(lián)起來了：

 
 
 
 

  
  
  
  
style: [
  
  
  
  
    createPannelOptions('input', {
  
  
  
  
        receive: 'text',  
  
  
  
  
        label: '文字'
  
  
  
  
    })
  
  
  
  
],
 
 
 
 

createPannelOptions 這個函數(shù)的泛型里填入對應的組件，將會給收到的配置項良好的提示。

在配置項組件里所要做的就是接收組件傳來的配置項，然后去修改 current 的屬性：

 
 
 
 

  
  
  
  
function MInput(props: MInputProps) {
  
  
  
  
 const option = useMemo(() => {
  
  
  
  
return props.data?.option || {};
  
  
  
  
 }, [props.data]);
  
  
  
  
 return (
  
  
  
  

  
  
  
  
 
  
  
  
  
  {(option as any)?.label || '文字'}：
  
  
  
  
 
  
  
  
  
 
  
  
  
  
            
  
  
  
  
                value={props.current.props[(option as any).receive] || ''}
  
  
  
  
                onChange={(e) => {
  
  
  
  
                        const receive = (option as any).receive;
  
  
  
  
                        const clonedata = deepCopy(store.getData());
  
  
  
  
                        const newblock = clonedata.block.map((v: IBlockType) => {
  
  
  
  
                                if (v.id === props.current.id) {
  
  
  
  
                                        v.props[receive] = e.target.value;
  
  
  
  
                                }
  
  
  
  
                                return v;
  
  
  
  
                        });
  
  
  
  
                        store.setData({ ...clonedata, block: [...newblock] });
  
  
  
  
                }}
  
  
  
  
            >
  
  
  
  
 
  
  
  
  

  
  
  
  
 );
  
  
  
  
}
 
 
 
 

由于可以很輕松的拿到 store，所以可以在任意地方進行修改數(shù)據(jù)。

將組件的 value 關聯(lián) current 的屬性，onChange 去修改 store，這樣就完成了個雙向綁定。

注意：如果你的右側組件需要用到 block 以外的屬性，可能需要去判斷是否處于彈窗模式。

4.6 自定義右鍵菜單

右鍵菜單可以進行自定義：

 
 
 
 

  
  
  
  
// 自定義右鍵
  
  
  
  
const contextMenuState = config.getContextMenuState();
  
  
  
  
const unmountContextMenu = contextMenuState.unmountContextMenu;
  
  
  
  
const commander = config.getCommanderRegister();
  
  
  
  
const ContextMenu = () => {
  
  
  
  
 const handleclick = () => {
  
  
  
  
unmountContextMenu();
  
  
  
  
 };
  
  
  
  
 const forceUpdate = useState(0)[1];
  
  
  
  
 contextMenuState.forceUpdate = () => {
  
  
  
  
forceUpdate((pre) => pre + 1);
  
  
  
  
 };
  
  
  
  
 return (
  
  
  
  

  
  
  
  
 style={{
  
  
  
  
            left: contextMenuState.left,
  
  
  
  
            top: contextMenuState.top,
  
  
  
  
            position: 'fixed',
  
  
  
  
            background: 'rgb(24, 23, 23)',
  
  
  
  
 }}
  
  
  
  
>
  
  
  
  
 
  
  
  
  
            style={{ width: '100%' }}
  
  
  
  
            onClick={() => {
  
  
  
  
                    commander.exec('redo');
  
  
  
  
                    handleclick();
  
  
  
  
            }}
  
  
  
  
        >
  
  
  
  
            自定義