整合營銷服務(wù)商

          電腦端+手機(jī)端+微信端=數(shù)據(jù)同步管理

          免費咨詢熱線:

          HTML5 進(jìn)階系列:拖放 API 實現(xiàn)拖放排序

          HTML5 中提供了直接拖放的 API,極大的方便我們實現(xiàn)拖放效果,不需要去寫一大堆的 js,只需要通過監(jiān)聽元素的拖放事件就能實現(xiàn)各種拖放功能。

          想要拖放某個元素,必須設(shè)置該元素的 draggable 屬性為 true,當(dāng)該屬性為 false 時,將不允許拖放。而 img 元素和 a 元素都默認(rèn)設(shè)置了 draggable 屬性為 true,可直接拖放,如果不想拖放這兩個元素,把屬性設(shè)為 false 即可。

          拖放事件

          拖放事件由不同的元素產(chǎn)生。一個元素被拖放,他可能會經(jīng)過很多個元素上,最終到達(dá)想要放置的元素內(nèi)。這里,我暫時把被拖放的元素稱為源對象,被經(jīng)過的元素稱為過程對象,到達(dá)的元素我稱為目標(biāo)對象。不同的對象產(chǎn)生不同的拖放事件。

          源對象:

          • dragstart:源對象開始拖放。
          • drag:源對象拖放過程中。
          • dragend:源對象拖放結(jié)束。

          過程對象:

          • dragenter:源對象開始進(jìn)入過程對象范圍內(nèi)。
          • dragover:源對象在過程對象范圍內(nèi)移動。
          • dragleave:源對象離開過程對象的范圍。

          目標(biāo)對象:

          • drop:源對象被拖放到目標(biāo)對象內(nèi)。
          <div id="source" draggable="true">a元素</div>
          <div id="process">b元素</div>
          <div id="target">c元素</div>
          <script>
           var source = document.getElementById('source'), // a元素
           process = document.getElementById('process'), // b元素
           target = document.getElementById('target'); // c元素
           
           source.addEventListener('dragstart',function(ev){ // dragstart事件由a元素產(chǎn)生
           console.log('a元素開始被拖動');
           },false)
           process.addEventListener('dragenter',function(ev){ // dragenter事件由b元素產(chǎn)生
           console.log('a元素開始進(jìn)入b元素');
           },false)
           process.addEventListener('dragleave',function(ev){ // dragleave事件由b元素產(chǎn)生
           console.log('a元素離開b元素');
           },false)
           target.addEventListener('drop',function(ev){ // drop事件由c元素產(chǎn)生
           console.log('a元素拖放到c元素了');
           ev.preventDefault();
           },false)
           document.ondragover = function(e){e.preventDefault();}
          </script>
          

          dataTransfer 對象

          在所有拖放事件中提供了一個數(shù)據(jù)傳遞對象 dataTransfer,用于在源對象和目標(biāo)對象間傳遞數(shù)據(jù)。接下來認(rèn)識一下這個對象的方法和屬性,來了解它是如何傳遞數(shù)據(jù)的。

          setData()

          該方法向 dataTransfer 對象中存入數(shù)據(jù)。接收兩個參數(shù),第一個表示要存入數(shù)據(jù)種類的字符串,現(xiàn)在支持有以下幾種:

          • text/plain:文本文字。
          • text/html:HTML文字。
          • text/xml:XML文字。
          • text/uri-list:URL列表,每個URL為一行。

          第二個參數(shù)為要存入的數(shù)據(jù)。例如:

          event.dataTransfer.setData('text/plain','Hello World');
          

          getData()

          該方法從 dataTransfer 對象中讀取數(shù)據(jù)。參數(shù)為在 setData 中指定的數(shù)據(jù)種類。例如:

          event.dataTransfer.getData('text/plain');
          

          clearData()

          該方法清除 dataTransfer 對象中存放的數(shù)據(jù)。參數(shù)可選,為數(shù)據(jù)種類。若參數(shù)為空,則清空所有種類的數(shù)據(jù)。例如:

          event.dataTransfer.clearData();
          

          setDragImage()

          該方法通過用img元素來設(shè)置拖放圖標(biāo)。接收三個參數(shù),第一個為圖標(biāo)元素,第二個為圖標(biāo)元素離鼠標(biāo)指針的X軸位移量,第三個為圖標(biāo)元素離鼠標(biāo)指針的Y軸位移量。例如:

          var source = document.getElementById('source'),
           icon = document.createElement('img');
          icon.src = 'img.png';
          source.addEventListener('dragstart',function(ev){
           ev.dataTransfer.setDragImage(icon,-10,-10)
          },false)
          

          effectAllowed 和 dropEffect 屬性

          這兩個屬性結(jié)合起來設(shè)置拖放的視覺效果。

          值得注意的是:dataTransfer 對象不支持IE。對,不支持IE。

          實現(xiàn)拖放排序

          上面已經(jīng)熟悉了拖放 API 的使用,我們來實現(xiàn)個簡單的拖放排序,這也是在項目中比較常見的。先來理一下思路:

          • 在一個列表中,每個元素都可以被拖放,那首先要給每個元素設(shè)置 draggable 屬性為 true。
          • 監(jiān)聽每個元素的 dragstart 事件,對源對象做樣式處理來區(qū)分。
          • 監(jiān)聽每個元素的 dragenter 事件,當(dāng)源對象進(jìn)入到當(dāng)前元素里,就把源對象添加到該元素之前。這樣子后面的元素就會被源對象擠下去了,實現(xiàn)了排序的效果。
          • 但是會發(fā)現(xiàn),源對象無法排到最后一個去,只能在倒數(shù)第二。這時就要監(jiān)聽 dragleave 事件,當(dāng)過程對象是最后一個元素時,源對象離開了過程對象,這時就把源對象添加到最后去。

          主要代碼如下:

          var source = document.querySelectorAll('.list'),
           dragElement = null;
          for(var i = 0; i < source.length; i++){
           source[i].addEventListener('dragstart',function(ev){
           dragElement = this;
           },false);
           source[i].addEventListener('dragenter', function(ev){
           if(dragElement != this){
           this.parentNode.insertBefore(dragElement,this);
           }
           }, false)
           source[i].addEventListener('dragleave', function(ev){
           if(dragElement != this){
           if(this == this.parentNode.lastElementChild || this == this.parentNode.lastChild){
           this.parentNode.appendChild(dragElement);
           }
           }
           }, false)
          };
          document.ondragover = function(e){e.preventDefault();}
          document.ondrop = function(e){e.preventDefault();}
          

          兼容

          主要是在IE中的兼容不太好,不過至少在IE10中能兼容上面的拖動排序。

          而且在我簡單的試驗中發(fā)現(xiàn),就是在 IE 中元素不設(shè)置 height 的時候,不會觸發(fā) dragleave 事件。

          更重要的一點是在 ios 和安卓上,完全不兼容。不過還好,有一個插件能讓它在移動端完美兼容。

          插件地址:ios-html5-drag-drop-shim

          只需要在原有的代碼中引入該插件,即可在移動端上實現(xiàn)拖動了。

          <script>
          var iosDragDropShim = { enableEnterLeave: true }
          </script>
          <script src="vendor/ios-drag-drop.js"></script>
          

          https://zhuanlan.zhihu.com/p/26666141

          到拖拽,我們都很熟悉,那么拖放呢?一字之差,代表的意義是不一樣的,拖拽就是拉著走,拖放就是有拖,有放,我們都知道原生 JS 拖拽效果的缺點:1. 代碼相對復(fù)雜與冗余2. 僅限于在瀏覽器內(nèi)的元素間拖放3、不能實現(xiàn)跨頁面的拖放

          所以H5就出現(xiàn)了拖放技術(shù),與 JS 原生相比 HTML5 拖放的優(yōu)勢:

          H5拖放技術(shù),drag&drop,對于瀏覽器的支持性:

          Internet Explorer 9、Firefox、Opera 12、Chrome 以及 Safari 5 支持拖放。注:在 Safari 5.1.2 中不支持拖放。

          那么它有哪些api語法,我們來看一下:

          1、 draggable 屬性

          通過 draggable 告訴瀏覽器哪些元素需要實現(xiàn)拖拽功能。有三個可選值:

          true: 元素可以被拖拽

          false:元素不能被拖拽

          auto:瀏覽器自己判斷元素是否能被拖拽 ( 默認(rèn) )

          2、對象拖放事件

          dragstart:按下鼠標(biāo)鍵并開始移動時觸發(fā)

          drag:在元素拖拽過程中持續(xù)觸發(fā)----相似與mousemove

          dragend:元素拖拽停止時觸發(fā)

          3、投放區(qū)事件流程

          元素被拖動到有效的放置目標(biāo)時,下列事件會依次發(fā)生:

          1. dragenter:當(dāng)拖拽對象進(jìn)入投放區(qū)時觸發(fā)

          2. dragover :拖拽對象在投放區(qū)內(nèi)移動時持續(xù)觸發(fā)

          3. dragleave:元素被拖出了投放區(qū)時觸發(fā)

          4. drop :拖拽對象投放在投放區(qū)時觸發(fā)

          雖然所有元素都支持放置目標(biāo)事件,但這些元素默認(rèn)是不允許放置的,需要重寫事件的默認(rèn)行為,例如:

          在ondragover中一定要執(zhí)行 preventDefault()否則ondrop事件不會被觸發(fā)

          4、 dataTransfer 對象--常用方法

          setDragImage (圖標(biāo),圖標(biāo)距指針X軸偏移值,Y軸偏移值 )

          指定一個圖標(biāo),當(dāng)拖動發(fā)生時,顯示在光標(biāo)下方

          5、dataTransfer 對象--常用屬性:

          dropEffect 表示被拖動的元素能夠執(zhí)行哪種放置行為

          可能的值:

          "none" : 不能把拖動的元素放在這里

          "move": 把拖動的元素移動到放置目標(biāo)

          "copy": 把拖動的元素復(fù)制到放置目標(biāo)

          "link": 放置目標(biāo)會打開拖動的元素(有URL)

          effectAllowed 允許拖動元素的哪種dropEffect

          允許值:

          "copyLink" : 允許值為 copy 和 link 的 dropEffect

          "copyMove": 允許值為 copy 和 move 的 dropEffect

          "linkMove" : 允許值為 link和 move 的 dropEffect

          "all" : 允許任意的 dropEffect

          注意:dropEffect屬性搭配effectAllowed屬性使用

          在dragstart事件處理程序中設(shè)置effectAllowed屬性

          在dragover事件處理程序中設(shè)置dropEffect屬性

          dropEffect 的每個可能值都會導(dǎo)致光標(biāo)顯示為不同的符號

          6、files 文件

          dataTransfer.files:如果是拖放文件,則返回正在拖放的文件列表FileList

          FileReader:專門用于讀取文件,F(xiàn)ileReader 接口提供一些讀取文件的方法與一個包含讀取結(jié)果的事件模型

          FileReader.readAsDataURL方法:參數(shù)為要讀取的文件對象,將文件讀取為DataUrl

          FileReader.onload事件:當(dāng)讀取文件成功完成的時候觸發(fā)此事件,在事件觸發(fā)后,你可以通過this.result來獲取讀取的文件數(shù)據(jù),如果是圖片,將返回base64格式的圖片數(shù)據(jù)。

          以上就是拖放提供的api,非常多,可以任意設(shè)置拖放的效果,拖拽事件以及投放事件,我們比較常見的垃圾桶效果,拖動排序,使用h5拖放技術(shù)實現(xiàn)就會非常簡單。

          求簡介

          最近接了一個需求,需要實現(xiàn)不同登錄人員可以自定義首頁模塊卡片。簡單來說,就是實現(xiàn)首頁看板模塊的增添拖拉拽,效果如下:

          技術(shù)選型

          原生js是支持拖拉拽的,只需要將拖拽的元素的 draggable 屬性設(shè)置成 "true"即可,然后就是調(diào)用相應(yīng)的函數(shù)即可。

          拖拽操作 - Web API 接口參考 | MDN

          但是,原生js功能不夠完善,使用起來需要改造的地方很多,因此,選用成熟的第三方插件比較好。

          我們的主項目采用的是vue3,,經(jīng)過一系列對比,最終選擇了 vue-draggable-next這個插件。

          vue-draggable-next

          vue-draggable-next的周下載量月3萬左右,可以看出是一個比較靠譜的插件。

          它的使用方式npmj上也介紹的很詳細(xì):

          vue-draggable-next

          如果英文的使用Api看起來比較難受,網(wǎng)上還有中文的使用文檔:

          vue.draggable.next 中文文檔 - itxst.com

          這個插件也有vue2版本和純js版本,其他框架也是也是可以完美使用的。

          實現(xiàn)思路

          需求與技術(shù)簡析

          根據(jù)我們的需求,我們應(yīng)該實現(xiàn)的是分組拖拽,假設(shè)我們有三列,那我們要實現(xiàn)的就是這A、B、C三列數(shù)據(jù)相互拖拽。

          我們看看中文官網(wǎng)給的示例:

          vue.draggable.next group 例子

          看起來很容易,我們只需要寫多個draggable標(biāo)簽,每個draggable標(biāo)簽寫入相同的組名即可。

          實現(xiàn)方案

          框架實現(xiàn)

          回到代碼中,要想實現(xiàn)一個三列可拖拉拽的模塊列表,我們首先需要引入組件

          <script lang="ts" setup>
          import { VueDraggableNext } from 'vue-draggable-next'
          // ....
          </script>
          


          然后定義一個數(shù)組儲存數(shù)據(jù):

          <script lang="ts" setup>
              import { VueDraggableNext } from 'vue-draggable-next'
              const moduleList = ref([
                {
                  "columnIndex": 1,
                  "moduleDetail": [
                    { "moduleCode": "deviation", "moduleName": "控制失調(diào)空間",},
                    { "moduleCode": "meeting_pending", "moduleName": "會議待辦",},
                    { "moduleCode": "abnormal_events", "moduleName": "異常事件", },
                    { "moduleCode": "audit_matters", "moduleName": "事項審批",}
                  ],
                },
                {
                  "columnIndex": 2,
                  "moduleDetail": [
                    { "moduleCode": "air_conditioning_terminal", "moduleName": "空調(diào)末端", }
                  ],
                },
                {
                  "columnIndex": 3,
                  "moduleDetail": [
                    { "moduleCode": "run_broadcast", "moduleName": "運行播報",},
                    {"moduleCode": "my_schedule", "moduleName": "我的日程", },
                    { "moduleCode": "cold_station", "moduleName": "冷站",}
                  ],
                }
              ])
          </script>
          


          最后,在代碼中我們使用v-for循環(huán)渲染即可

          <div v-for="moduleColumn in  moduleList " :key="moduleColumn.columnIndex" class="box">
            <VueDraggableNext :list="moduleColumn.moduleDetail" group="column" >
              <div v-for="(item, index) in  moduleColumn.moduleDetail " :key="item.moduleCode" class="drag-item">
                <!-- 模塊內(nèi)容 -->
              </div>
            </VueDraggableNext>
          </div>
          


          注意上面的html結(jié)構(gòu),我們循環(huán)渲染了三列VueDraggableNext標(biāo)簽,每個VueDraggableNext標(biāo)簽內(nèi)部又通過v-for="(item, index) in moduleColumn.moduleDetail渲染了這個拖拽列內(nèi)部的所有模塊。我們通過group="column" 讓每個VueDraggableNext組件的組名相同,實現(xiàn)了三個拖拽標(biāo)簽之間的模塊互相拖拉拽。

          拖拽點設(shè)置

          正常情況小,我們肯定是希望在某個組件的固定位置才能拖動組件,因此我們需要使用到拖拽組件的handle屬性。

          vue.draggable.next屬性說明:

          handle

          :handle=".mover" 只有當(dāng)鼠標(biāo)在class為mover類的元素上才能觸發(fā)拖到事件

          根據(jù)屬性說明,我們的代碼實現(xiàn)起來也非常容易了。

            <div v-for="moduleColumn in  moduleList " :key="moduleColumn.columnIndex" class="box">
                <VueDraggableNext :list="moduleColumn.moduleDetail" handle=".move" group="column">
                  <div v-for="(item, index) in  moduleColumn.moduleDetail " :key="item.moduleCode" class="drag-item">
                    <div class="move">
                      拖拽區(qū)域
                    </div>
                    <!-- 模塊內(nèi)容 -->
                  </div>
                </VueDraggableNext>
            </div>
          


          數(shù)據(jù)的增刪改

          實際開發(fā)中,我么一定會根據(jù)接口或者操作動態(tài)的更改列表,代碼層也就是更改moduleList的值。非常幸運的是,如果你按照上面的方式寫代碼,當(dāng)你拖拉拽完畢后,上面的moduleList值會自動更改,我們不用做任何處理!!!這么看,數(shù)據(jù)的增刪改根本不是問題。

          如何動態(tài)渲染組件

          實際開發(fā)中,我們可能會遇到一個問題,就是如何動態(tài)的去渲染組件,如果你熟悉vue,使用動態(tài)組件component就可以實現(xiàn)。

          首先,我們需要定義一個模塊列表

          import MeetingPending from '../components/meetingPending.vue'
          import AbnormalEvents from '../components/abnormalEvents/index.vue'
          import MySchedule from '../components/mySchedule.vue'
          import TransactionApproval from '../components/transactionApproval.vue'
          import RunningBroadcast from '../components/runningBroadcast.vue'
          import CodeSite from '../components/codeSite/index.vue'
          import MismatchSpace from '../components/mismatchSpace/index.vue'
          import AirDevice from '../components/airDevice/index.vue'
          
          // !全量模塊選擇列表
          export const allModuleList = [
            { moduleCode: 'meeting_pending', label: '會議待辦', component: MeetingPending },
            { moduleCode: 'my_schedule', label: '我的日程', component: MySchedule },
            { moduleCode: 'audit_matters', label: '事項審批', component: TransactionApproval },
            { moduleCode: 'abnormal_events', label: '異常事件', component: AbnormalEvents },
            { moduleCode: 'deviation', label: '控制失調(diào)空間', component: MismatchSpace },
            { moduleCode: 'run_broadcast', label: '運行播報', component: RunningBroadcast },
            { moduleCode: 'cold_station', label: '冷站', component: CodeSite },
            { moduleCode: 'air_conditioning_terminal', label: '空調(diào)末端', component: AirDevice }
          ]
          


          然后根據(jù)moduleCode做匹配,動態(tài)渲染即可

            <div v-for="moduleColumn in  moduleList " :key="moduleColumn.columnIndex" class="box">
                <VueDraggableNext :list="moduleColumn.moduleDetail" handle=".move" group="column">
                  <div v-for="(item, index) in  moduleColumn.moduleDetail " :key="item.moduleCode" class="drag-item">
                    <div class="move">
                      拖拽區(qū)域
                    </div>
                    <component :is="getComponentsByCode(item.moduleCode)" ></component>
                  </div>
                </VueDraggableNext>
            </div>
          


          更多定制化需求

          如果上面的功能不滿足你的需求,我們可以使用這個組件的其他屬性,完成更多意想不到的效果

          如果下面的屬性說明未能完全看明,可以看左邊的對應(yīng)的菜單查看詳細(xì)說明和例子。

          屬性名稱

          說明

          group

          如果一個頁面有多個拖拽區(qū)域,通過設(shè)置group名稱可以實現(xiàn)多個區(qū)域之間相互拖拽 或者 { name: "...", pull: [true, false, 'clone', array , function], put: [true, false, array , function] }

          sort

          是否開啟排序,如果設(shè)置為false,它所在組無法排序

          delay

          鼠標(biāo)按下多少秒之后可以拖拽元素

          touchStartThreshold

          鼠標(biāo)按下移動多少px才能拖動元素

          disabled

          :disabled= "true",是否啟用拖拽組件

          animation

          拖動時的動畫效果,如設(shè)置animation=1000表示1秒過渡動畫效果

          handle

          :handle=".mover" 只有當(dāng)鼠標(biāo)在class為mover類的元素上才能觸發(fā)拖到事件

          filter

          :filter=".unmover" 設(shè)置了unmover樣式的元素不允許拖動

          draggable

          :draggable=".item" 樣式類為item的元素才能被拖動

          ghost-class

          :ghost-class="ghostClass" 設(shè)置拖動元素的占位符類名,你的自定義樣式可能需要加!important才能生效,并把forceFallback屬性設(shè)置成true

          chosen-class

          :ghost-class="hostClass" 被選中目標(biāo)的樣式,你的自定義樣式可能需要加!important才能生效,并把forceFallback屬性設(shè)置成true

          drag-class

          :drag-class="dragClass"拖動元素的樣式,你的自定義樣式可能需要加!important才能生效,并把forceFallback屬性設(shè)置成true

          force-fallback

          默認(rèn)false,忽略HTML5的拖拽行為,因為h5里有個屬性也是可以拖動,你要自定義ghostClass chosenClass dragClass樣式時,建議forceFallback設(shè)置為true

          fallback-class

          默認(rèn)false,克隆選中元素的樣式到跟隨鼠標(biāo)的樣式

          fallback-on-body

          默認(rèn)false,克隆的元素添加到文檔的body中

          fallback-tolerance

          按下鼠標(biāo)移動多少個像素才能拖動元素,:fallback-tolerance="8"

          scroll

          默認(rèn)true,有滾動區(qū)域是否允許拖拽

          scroll-fn

          滾動回調(diào)函數(shù)

          scroll-fensitivity

          距離滾動區(qū)域多遠(yuǎn)時,滾動滾動條

          scroll-speed

          滾動速度

          傳送門:vue.draggable.next 中文文檔 - itxst.com

          寫在最后

          關(guān)聯(lián)文章:如何實現(xiàn)模塊的錨點定位及閃爍提示:juejin.cn/post/734622…


          作者:石小石Orz
          鏈接:https://juejin.cn/post/7346121373112811583


          主站蜘蛛池模板: 日本一区二区三区四区视频| 亚洲国产成人久久综合一区| 日韩视频一区二区在线观看| 日本一区频道在线视频| 精彩视频一区二区三区| 国产熟女一区二区三区五月婷| 亚洲变态另类一区二区三区| 无码丰满熟妇浪潮一区二区AV| 3d动漫精品啪啪一区二区中| 无码少妇A片一区二区三区| av无码一区二区三区| 国偷自产av一区二区三区| 国产91大片精品一区在线观看| 波多野结衣一区二区三区88| 黑巨人与欧美精品一区| 亚洲午夜一区二区电影院| 亚洲日韩精品一区二区三区无码| 国产成人一区二区三区高清| 冲田杏梨AV一区二区三区| 无码人妻啪啪一区二区| 中文字幕一区二区人妻| 国产精品亚洲不卡一区二区三区 | 亚洲丶国产丶欧美一区二区三区| 免费一区二区视频| 97av麻豆蜜桃一区二区| 性无码免费一区二区三区在线 | 国产一区二区电影| 一区二区三区视频网站| 无码精品人妻一区二区三区免费| 尤物精品视频一区二区三区 | 搜日本一区二区三区免费高清视频 | 武侠古典一区二区三区中文| 国产一区二区三区精品视频| 精品人妻无码一区二区三区蜜桃一| 成人免费观看一区二区| 亚洲av无码一区二区三区天堂| 波多野结衣中文一区二区免费| 国产精品小黄鸭一区二区三区| 久久精品一区二区影院| 一区二区三区视频免费观看| 亚洲一区二区中文|