我們都知道普通的HTML自帶的功能相對有限,很多復雜的交互式場景,如果手動去寫功能的話會非常的復雜,而且可擴展性差,就拿HTML表格來說,對于初學者或者對于復雜的拖拽式交互編程不熟悉的話會很浪費時間,因此今天就介紹一個第三方的插件——Table-draagger,來輕松實現類似的功能。Table-draagger是用于構建可重排序的拖放表的極簡主義純Javascript庫!
https://github.com/sindu12jun/table-dragger
Table-draagger因為其以下幾個特征而讓拖拽和排序的實現變得如此簡單:
可以在npm上獲得它:
npm install table-dragger --save
或者引用壓縮的js文件
<script src="../node_modules/table-dragger/dist/table-dragger.min.js"></script>
或者嘗試開發中的不穩定版本
npm install table-dragger@next --save
請看以下代碼:
import tableDragger from 'table-dragger' tableDragger(el, options?)
<table id="table"> <thead> <tr> <th class='handle'>header1</th> <th class='handle'>header2</th> </tr> </thead> <tbody> <tr> <td>conten1</td> <td>conten2</td> </tr> </tbody> </table>
var el = document.getElementById('table'); var dragger = tableDragger(el, { mode: 'row', dragHandler: '.handle', onlyBody: true, }); dragger.on('drop',function(from, to){ console(from); console(to); });
你可以在不設置任何參數的情況下使用默認的拖拽和排序方式,當然以下是你可以配置的選項:
1、將mode設置為column,用戶拖動和排序表的列
2、將mode設置為row,用戶拖動并排序表的行
3、設置mode為free,用戶根據點擊后鼠標移動的方向拖動行或列。注意,必須在自由模式下指定dragHandler。
dragHandler是表中的拖動句柄選擇器默認情況下,在列模式下,dragHandler是表的第一行;在行模式下,則是第一列。
在行模式下將onlyBody設置為true時,用戶只能在tbody中提升行。
下面是返回對象的API
tableDragger(document.querySelector('#event-table'), { mode: 'free', dragHandler: '.handle', onlyBody: true }) .on('drag', () => { console.log('drag'); }) .on('drop', (from, to, el, mode) => { console.log(`drop ${el.nodeName} from ${from} ${mode} to ${to} ${mode}`); }) .on('shadowMove', (from, to, el, mode) => { console.log(`move ${el.nodeName} from ${from} ${mode} to ${to} ${mode}`); }) .on('out', (el, mode) => { console.log(`move out or drop ${el.nodeName} in mode ${mode}`); });
Table-draagger為我們節省了很多手動封裝表格排序和拖拽功能的時間,當然目前很多第三方框架已經實現了類似的功能,這更適用于原生的html表格,你還可以通過一些手段記憶用戶拖拽,這只是其中一種思路,Enjoy it!~
近筆者專注于研究可視化搭建平臺的解決方案, 分析了很多拖拽組件和頁面動態化技術, 也在 H5-Dooring 項目中做了很多技術實現, 包括:
還有很多技術細節這里不一一舉例了, 最近在研究自由布局時發現有這樣一個需求, 我們可以自由拖拽和縮放組件, 并能從組件的不同緯度拖拽, 如下圖所示:
基于react的組件拖拽縮放庫@alex_xu/rc-drag
由于我們的技術棧采用的是 React, 目前還沒有一個成熟庫可以同時支持自由拖拽和縮放, 我們不得不用 react-dragable 和 react-resiable兩個庫來實現拖拽和縮放, 但是這樣我們要維護的數據結構就相當復雜了(當然vue生態有成熟的vue-dragable等來支持自由拖拽和縮放), 所以最后筆者決定自己來實現一個.
我們從可視化搭建平臺的實際業務出發, 可以分析出拖拽縮放有如下幾個功能點:
實現以上四點我們就可以實現一個可用的拖拽縮放組件. 接下來筆者就來介紹一下實現的開源拖拽縮放組件rc-drag.
rc-drag未壓縮的體積只有20多k, 去除注釋核心代碼不到200行, 可以說是一個非常輕量的拖拽縮放組件庫了, 我們要想讓自己的組件能自由拖拽, 只需要使用如下方式:
npm i @alex_xu/rc-drag
# 或
yarn add @alex_xu/rc-drag
<div id="box" style={{position: 'relative', width: '500px', height: '260px'}}>
<Drag container="#box" size={[200, 200]}>
<p>Mr xu</p>
</Drag>
</div>
我們只需要以上幾行代碼就能實現組件的自由拖拽. 效果如下:
基于react的組件拖拽縮放庫@alex_xu/rc-drag
目前在 h5-dooring 是通過橫向擴展來解決組件層級和嵌套的問題, 如果我們采用自由拖拽布局, 層級和嵌套的問題就很好解決了. 在 @alex_xu/rc-drag 這個庫中筆者實現設置層級的功能, 所以我們可以通過給拖拽組件設置不同的層級, 來實現頁面元素疊加和層的概念. 如下設置:
<Drag container="#box" size={[10, 50]} zIndex={10}>
<p>Mr xu</p>
</Drag>
基于react的組件拖拽縮放庫@alex_xu/rc-drag
我們通過給組件設置更高的層級來實現組件堆疊的效果.
我們往往會在編輯頁面時對組件進行拖拽等操作, 但是有些場景我們需要讓組件固定, 比如頭部或者頁腳, 或者鎖定某個元素, 類似于 PS 里圖層鎖定. 另一個場景是我們要實現公共的頁面渲染器, 在編輯狀態下可以自由拖動縮放, 但是在預覽狀態下需要讓元素固定, 不能出現自有拖拽等功能, 類似 h5-dooring 那種模式, 這個時候我們需要讓拖拽組件@alex_xu/rc-drag支持靜態化. 這個時候我們可以設置isStatic屬性為true, 如下圖:
基于react的組件拖拽縮放庫@alex_xu/rc-drag
代碼如下:
<Drag container="#box" isStatic={true}><p>static item</p></Drag>
我們可以利用這個屬性, 寫個頁面渲染器, 用戶在預覽時將組件的isStatic設置為true即可, 源碼的底層實現其實也很簡單, 就是利用react-hoooks的組件編寫方式寫個判斷即可:
{
isStatic ?
<div className="x-drag-item" style={style}>{ children }</div>
:
<div
className="x-drag-item"
style={style}
onMouseDown={(e) => onMouseDown('move', e)}
onMouseUp={onMouseUp} onMouseMove={onMouseMove}
>
</div>
}
我們都知道組件單純只有拖拽縮放能力遠遠不能滿足業務需求, 對于可視化拖拽組件, 更重要的是要能保留拖拽后的數據, 比如寬高,位置,層級等數據, 所以我們需要監控幾個事件, 并將數據傳給對應的事件來讓外層能監聽和獲取. 這里筆者提供了兩個拖拽回傳方法: onDrapStart onDrapStop
后面根據實際情況可以對應添加. 我們可以在父組件中綁定對應的方法, 如下:
<Drag
container="#box"
size={[200, 200]}
zIndex={2}
onDragStart={(item) => console.log('start', item)}
onDragStop={(item) => console.log('stop', item)}
>
<p>Mr xu</p>
</Drag>
這樣我們就能在父層拿到對應的數據并保存下來了, 進而也就能實現我們的預覽頁面的功能了. 具體可以參考H5-Dooring 渲染器的部分.
以上幾個技術點和技術實現是可視化拖拽組件必備的要素, 大家可以使用參考一下.
github地址: 傳送門
如果大家對可視化搭建平臺感興趣, 可以參考 H5-Dooring 相關的技術文章來了解更多lowcode和nocode 的知識.
覺得有用 ?喜歡就收藏,順便點個贊吧,你的支持是我最大的鼓勵!微信搜 “趣談前端”,發現更多有趣的H5游戲, webpack,node,gulp,css3,javascript,nodeJS,canvas數據可視化等前端知識和實戰.
家好,我是大澈!
本文約1900+字,整篇閱讀大約需要5分鐘。
感謝關注微信公眾號:“程序員大澈”,免費領取"面試禮包"一份,然后免費加入問答群,從此讓解決問題的你不再孤單!
*請認真填寫需求信息,我們會在24小時內與您取得聯系。