DIV CSS 佈局教程網

把 jQuery UI Dialog 與 zTree 結合:彈窗裡放一棵樹
編輯:JavaScript綜合知識     

需求是這樣的:點一個按鈕,跳出一個 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 等選項調整)。直接回傳裸陣列在某些版本會解析失敗。

這整串下來其實就是一個標準的「前端元件 + 後端資料 + 設定檔註冊」三層結構。理解每一層各自的責任,換成別的樹元件或別的後端框架時,思路完全一樣。

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