DIV CSS 佈局教程網

用 Bootstrap TreeView 打造可彈性設定的運費模板
編輯:關於JavaScript     

bootstrap-treeview 是一款基於 jQuery 與 Twitter Bootstrap 的多層級樹狀列表插件,能用相當簡潔優雅的方式呈現繼承結構,例如檢視樹、列表樹等。本文記錄一次用它實作「快遞運費模板」的過程。

需求拆解

要達成的功能有四項:

一個模板可指定多個子模板,每個子模板包含自己的地區與價格。編輯子模板的地區時,樹狀結構要即時反應——其他子模板已選的地區要 disabled,本子模板先前選的地區則預設勾選。樹的勾選要父子聯動:勾父節點則子節點全選,取消任一子節點則父節點也跟著取消。最後要把資料正確維護起來,例如顯示成「安徽、北京(昌平 回龍觀)」這樣的格式,並存下選中節點。

資料格式

資料源長這樣:

 [{text:'展示名稱1', nodes:[{text:'子級'}]}, {text:'展示名稱2'}]

bootstrap-treeview 會動態為資料源補上 nodeId 與 parentId 兩個屬性,這兩個是後續所有操作的基礎,也可以自行加上其他屬性用來標記節點。

需要維護的狀態

 var templates = [];        // 最終要儲存的資料
var selectedNodeId = [];   // 單個模板選中的 nodeId,用於展示
var editingTemplate = null; // 標記目前處理的是第幾個地區模板
var selectedAreaId = [];   // 目前選中的地區 id
var selectedAreaName = []; // 目前選中的地區名稱,用於展示
var defaultData = [];      // 資料源

其中 templates 每個元素要裝三種資訊:模板名稱、各子模板對應的價格/件數/排序,以及子模板的地區 Id、節點 id 與展示名稱。

功能一:一個模板帶多個子模板

本質上就是維護 templates 陣列,把多個 template 物件 push 進去即可,細節在後面的功能四一起說明。

功能二:動態改寫樹的狀態

原理是靠 templates 與 editingTemplate 取出「目前編輯的子模板資料」和「其他子模板的資料」,前者設為預設勾選,後者設為 disabled。三個 API 就夠用:

 // 全部取消勾選
$('#tree').treeview('uncheckAll', { silent: true });

// 停用節點
$('#tree').treeview('disableNode', [ nodeId, { silent: true } ]);

// 預設勾選
$('#tree').treeview('checkNode', [ template.nodeIds[i], { silent: true } ]);

silent: true 是必要的。少了它,程式化操作會觸發勾選事件,進而啟動父子聯動邏輯,最後變成互相觸發的迴圈。

功能三:父子節點聯動

勾選時:選中的是父節點,就從它回傳的 nodes 取出所有子節點全部勾上,這段可以包成 selectAllChildren();選中的是子節點,則檢查同層是否已全數勾選,若是就把父節點也勾上。

取消時:取消的是父節點,所有子節點一起取消;取消的是子節點,則只要父節點底下還有沒勾的,父節點就跟著取消。

 // 勾選
$('#tree').treeview('checkNode', [ nodeId, { silent: true } ]);

// 取消
$('#tree').treeview('uncheckNode', [ nodeId, { silent: true } ]);

// 查詢是否已選
$('#tree').treeview('selectNode', [ nodeId, { silent: true } ]);

功能四:維護 template 資料

需要準備四份東西:正在編輯的 editingTemplate、當前層級選中的所有 selectedNodeId、展示用的 selectedNodeName,以及對應資料庫 areaId 的 selectedAreaId。遍歷完之後把這幾份併進 template,再 push 進 templates。

遍歷邏輯分兩種情況處理。節點帶有 nodes(也就是有子元素)時,直接把名稱收進 areaNames,例如「安徽」,然後改變 index 跳過它底下所有子元素。節點沒有子元素時,取出父級名稱如「北京」,把當前節點接在後面成為「北京(昌平區」,再判斷下一個元素的父節點是否改變;一旦改變就收尾成「北京(昌平區)」並加入 areaNames,繼續下一輪。

成果

主頁面展示:

樹狀結構:

小結

本文提供的是一個可行的思路,實際程式碼仍要依業務細節調整。不足之處在於資料源的動態處理做得比較陽春;優點是 bootstrap 開放的 API 夠多,很多行為可以自行組裝出來。真正花時間的地方其實不是呼叫 API,而是把「父子聯動」與「跨模板互斥」這兩套規則的優先順序想清楚——先想清楚狀態怎麼擺,程式自然就寫得出來。

以上就是這篇的分享,希望對你有幫助。有疑問歡迎留言。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved