先前為了「不能選父節點」這件事翻半天文件,看到不少文章在講怎麼判斷子節點,繞了一大圈。其實結論很簡單:一個設定項就够了。
onlyLeafCheck: true,
$('#artReason').combotree({
width: 200,
method: 'GET',
data: DicEtilolgy_data,
idField: 'id',
textFiled: 'name',
parentField: 'pid',
animate: true,
mode: 'local',
multiple: true,
onlyLeafCheck: true, // 關鍵:只允許勾選葉節點
onLoadSuccess: function(node, data){
// 需要預設值時在這裡設定,例如:
// $("#artReason").combotree('setValue', ['11','12']);
},
onChange: function(newValue, oldValue){
// 值變動時的處理
}
});
開啟之後,樹上的非葉節點會變成「只能展開、不能勾選」的狀態。使用者在父節點上打勾不會生效,也就不會把整棵子樹一起帶進值裡。這正是多數「病因分類」「地區」「產品目錄」這類有層級的欄位想要的行為——真正要存進資料庫的是最末端的那一項。
常見的錯誤方向是去改 easyui 的原始 js,例如在 onClick 裡判斷 node.state 再呼叫 unselect:
// 不建議的做法:事後清除,畫面會閃一下且體驗差
onClick: function(node){
if (node.state !== 'open' && node.isLeaf === false) {
$(this).tree('unselect');
}
}
這種寫法有兩個問題:一是父節點其實已經被選中了,只是又即時取消,畫面上容易出現閃動;二是它沒有真正阻止勾選行為,在 multiple 模式下父子關係的連動仍然會發生。用 onlyLeafCheck 是從源頭限制,乾淨得多。
1. 屬性名稱別打錯。範例中我寫成 textFiled,正確拼法是
2. 單選與多選的差異。onlyLeafCheck 主要在 multiple: true 時發揮作用;單選模式下本來就只能選一個節點,這個設定意義不大。
3. 後端仍要驗證。前端限制只是引導,有心人士還是可以直接送出父節點 id。伺服器端應該檢查收到的 id 是否為合法的葉節點,再決定要不要寫入。
結論:先查設定項,再考慮改程式碼。多數「外掛行為不如預期」的狀況,其實都是某個沒被發現的選項。