DIV CSS 佈局教程網

zTree 異步加載實作入門:點開節點才向後端要資料
編輯:JQuery特效代碼     

官方網站:https://www.ztree.me。zTree 是一套以 jQuery 實作的樹狀元件,常用於組織架構、功能選單、分類目錄等情境。本文示範如何用「異步」模式,在展開父節點時才向後端請求子節點(版本為 zTree 3.5.01)。

一、頁面

<!DOCTYPE html>
<html>
<head>
<title>simple.html</title>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="css/zTreeStyle.css">
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript" src="js/jquery.ztree.core-3.5.js"></script>
<script type="text/javascript" src="js/jquery.ztree.excheck-3.5.min.js"></script>
<script type="text/javascript" src="js/1.js"></script>
</head>
<body>
<div class="zTreeDemoBackground left"><ul id="treeDemo" class="ztree"></ul></div>
</body>
</html>

二、設定檔

var setting = {
  data: {
    simpleData: {
      enable: true
      // idKey:"id",
      // pIdKey:"pId",
    }
  },
  async: {
    enable: true,
    url: "/Java_Solr/servlet/ZTreeSerlvet",
    autoParam: ["id", "name"],                 // 點擊父節點時自動把 id、name 送出去
    otherParam: {"otherParam":"zTreeAsyncTest"}, // 額外的固定參數
    // dataType: "text",                        // 預設 text
    // type: "get",                             // 預設 post
    dataFilter: filter                         // 異步回傳後先經過 filter 處理
  },
  callback: {
    // beforeAsync: zTreeBeforeAsync,          // 異步加載前的回呼
    asyncSuccess: zTreeOnAsyncSuccess,         // 加載成功
    asyncError:   zTreeOnAsyncError,           // 加載失敗
    beforeClick:  beforeClick                  // 單擊節點前的回呼
  }
};

// treeId 為 treeDemo;可在這裡統一整理回傳的節點資料
function filter(treeId, parentNode, childNodes) {
  if (!childNodes) return null;
  for (var i = 0, l = childNodes.length; i < l; i++) {
    childNodes[i].name = childNodes[i].name.replace('','');
  }
  return childNodes;
}

// 只允許點選父節點
function beforeClick(treeId, treeNode){
  if (!treeNode.isParent) {
    alert("請選擇父節點");
    return false;
  } else {
    return true;
  }
}

function zTreeOnAsyncError(event, treeId, treeNode){
  alert("異步加載失敗!");
}
function zTreeOnAsyncSuccess(event, treeId, treeNode, msg){}

var zNodes = [];   // 若關掉 async,可直接在這裡寫死節點資料
$(document).ready(function(){
  $.fn.zTree.init($("#treeDemo"), setting, zNodes);
});

需要取得 zTree 物件時:var zTree = $.fn.zTree.getZTreeObj("treeDemo");

三、後端 Servlet

回傳格式必須是 zTree 認得的 JSON 陣列,每個節點帶 id、pId、name,並以 isParent 標示是否還有子節點(決定要不要顯示展開的加號)。

package org.hzy.servlets;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.ArrayList;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.*;
import org.hzy.bean.ZtreeBean;
import com.alibaba.fastjson.JSON;

public class ZTreeSerlvet extends HttpServlet {
  public void doGet(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    System.out.println(request.getParameter("id") + " " + request.getParameter("name")
        + " " + request.getParameter("otherParam"));
    response.setCharacterEncoding("UTF-8");
    PrintWriter out = response.getWriter();

    ZtreeBean zb  = new ZtreeBean(0, -1, "zb", true);
    ZtreeBean zb1 = new ZtreeBean(1,  0, "zb1", true);
    ZtreeBean zb2 = new ZtreeBean(2,  1, "zb2", false);
    ZtreeBean zb3 = new ZtreeBean(2,  0, "zbss", true);

    List<ZtreeBean> list = new ArrayList<ZtreeBean>();
    list.add(zb); list.add(zb1); list.add(zb2); list.add(zb3);

    out.print(JSON.toJSONString(list));
  }

  public void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    doGet(request, response);
  }
}

四、要點整理

  • 異步模式下,zNodes 可以是空陣列,資料完全由後端供應;節點多的時候首屏載入會快很多。
  • autoParam 決定了「點哪個節點時送什麼參數過去」,是串接後端查詢的關鍵。
  • dataFilter 是快取與整理資料的好位置,例如清掉 HTML 標籤、補上預設值。
  • 務必在每個節點上正確標記 isParent,否則展開後抓不到子節點會讓使用者誤以為是 bug。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved