需求是這樣的:點一個按鈕,跳出一個 dialog 對話框,裡面是一棵 asynchronously 載入的樹形選單(例如地區、部門、商品分類)。以下記錄整個串接過程。
先把 jQuery UI 與 zTree 的 js 和 css 檔都引入頁面。zTree 的樣式是靠自己那組 css 撐起來的,少了它樹會長得完全不像樹,這一步很容易漏。
<body>
<button value="點擊彈出樹的 dialog 對話框" onclick="getTree()">點擊彈出樹</button>
<div id="ztree" class="ztree"></div>
</body>
<script type="text/javascript">
function getTree() {
var url = "<c:url value='/zone_ajaxtree'/>";
var setting = {};
var zNodes = [];
var option = { width: 200, height: 300 };
$.ajax({
url: url,
success: function(data) {
$.each(data, function(n, d) {
zNodes.push({ id: d.id, name: d.name, pId: d.pId });
});
$.fn.init.ztree($('#ztree'), setting, zNodes);
$('#ztree').dialog(option);
}
});
}
</script>
流程是「抓資料 → 轉成 zTree 的節點格式 → 初始化樹 → 把容器變成 dialog」。順序很重要:樹必須先長好,再包成 dialog,否則 dialog 打開時會看到一棵空的樹。
<c:url> 是 JSTL 的標籤,作用是自動補上 context path,避免部署到不同名稱的 war 時路徑寫死出錯。用它的同時也要注意 jQuery 的 $ 可能與 JSTL 的 $ 混淆,必要時改用 jQuery 或包 IIFE。
@RequestMapping("/zone_ajaxtree")
@ResponseBody
public List<ZoneBody> zone_ajaxtree() {
List<ZoneBody> zones = zoneBodyService.getZone_ajax();
return zones;
}
@ResponseBody 讓 Spring MVC 直接把回傳物件序列化成 JSON 寫入 response,不必再走 view resolver。
要用它,需要引入 Jackson 的 jar:jackson-core-asl-1.8.7.jar 與 jackson-mapper-asl-1.8.7.jar。並在 mvc.xml 中註冊訊息轉換器:
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
<property name="webBindingInitializer">
<bean class="com.building.controller.BindingInitializer" />
</property>
<property name="messageConverters">
<ref bean="jsonHttpMessageConverter" />
</property>
</bean>
<bean id="jsonHttpMessageConverter"
class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter" />
BindingInitializer 是專案自訂的類別,負責全域的資料綁定設定(例如日期格式)。MappingJacksonHttpMessageConverter 則是負責把 Java 物件轉成 JSON 的那個角色。少了這一段,@ResponseBody 會回傳一團看不懂的東西或直接報 406。
原範例的拼寫錯誤。原文中的 $.each(data, funtion(n,d){...}) 少了 n 是 f-u-n-c-t-i-o-n,zNode.push 與宣告的 zNodes 不一致,$.fn.init.ztree 也不是正確的呼叫方式(應該是 $.fn.zTree.init(obj, setting, zNodes))。這些都是動手實作時會立刻撞到的,照抄前先看清楚。
dialog 選項的拼字。jQuery UI 的選項是 height,不是 hight。寫錯不會報錯,只是選項被安靜忽略,然後你會疑惑「為什麼高度沒作用」。
重複點擊會疊 dialog。每次呼叫 dialog() 都會再初始化一次。實務上會先判斷是否已存在,或改用 $('#ztree').dialog('open') 只切換顯示狀態,資料則視需要重新抓。
資料量大時改用非同步載入。zTree 支援 setting.async,點開節點時才向後端要子節點。若整棵樹一次載入,節點上千時前端會明顯卡頓。
記得回傳正確的 JSON 結構。zTree 預設期待 {code: 0, msg: "", data: [...]} 這種包裝格式(可用 setting.async.contentType 等選項調整)。直接回傳裸陣列在某些版本會解析失敗。
這整串下來其實就是一個標準的「前端元件 + 後端資料 + 設定檔註冊」三層結構。理解每一層各自的責任,換成別的樹元件或別的後端框架時,思路完全一樣。