最近做的一個 EasyUI 專案需要顯示多級菜單,而且菜單是配置在資料庫裡的,每個層級都得回資料庫取一次。這種場合用 jQuery EasyUI 的 tree 元件會輕鬆很多——它把「撈資料、畫階層、展開收合」三件事都包好了。
效果體驗:https://hovertree.com/texiao/jeasyui/2/
下載:hovertree.com/h/bjaf/kbtdmn5u.htm
HTML 主體是一個空的 <ul>,資料來源與載入方式寫在 data-options 裡:
<ul id="tt" class="easyui-tree"
data-options="url:'tree_data1.json', method:'get', animate:true"></ul>
url 指向 JSON 檔,method 指定用 GET 取,animate:true 讓展開收合有動畫。實際的階層結構完全由後端回傳的 JSON 決定,前端不需要預先寫死任何節點——這正是「菜單存資料庫」時最方便的地方。
function collapseAll(){ $('#tt').tree('collapseAll'); }
function expandAll(){ $('#tt').tree('expandAll'); }
function expandTo(){
var node = $('#tt').tree('find', 113);
$('#tt').tree('expandTo', node.target).tree('select', node.target);
}
function getSelected(){
var node = $('#tt').tree('getSelected');
if (node){
var s = node.text;
if (node.attributes){
s += "," + node.attributes.p1 + "," + node.attributes.p2;
}
alert(s);
}
}
值得注意的有兩點。第一,find 是依 id 查找節點,回傳的物件帶有 target,而 expandTo 與 select 要傳的是 target 而非節點本身——這是 EasyUI 常見的誤用點。第二,attributes 可以塞入自訂屬性(示例中的 p1、p2),取回選中節點時一併讀出,等於讓每個選項都能攜帶自己的附加資料。
資料格式是標準的父子巢狀:每個節點有 id、text,有子節點時放 children 陣列,想預先收合則加 "state":"closed",想預設勾選則加 "checked":true。範例資料裡的 text 甚至直接寫了 <a> 連結,所以節點文字本身就是可點的。
要留意這一點的風險:text 會被當成 HTML 渲染,若內容來自使用者輸入或外部來源,就必須先消毒,否則等於開了一個 XSS 的門。
樣式需要 themes/default/easyui.css(主題)、themes/icon.css(圖示)與 demo/demo.css;腳本需要 jQuery 1.12.0 與 jquery.easyui.min.js,順序不可顛倒。官方範例:checkbox 範例/拖曳排序範例