DIV CSS 佈局教程網

easyUI datagrid 實戰筆記:搜索框與表格的整合思路
編輯:JQuery特效代碼     

用 easyUI 的 searchbox 搭配 datagrid:一次完整的整合記錄

起點:為什麼想把這兩個元件湊在一起

這是一篇業餘性質的練習筆記。前陣子在玩 easyUI,順手把它的搜索框(searchbox)與數據表格(datagrid)放在一起使用,讓「輸入條件」與「呈現結果」能連成一氣。過程中遇到幾個容易忽略的細節,也順便把 datagrid 載入資料的兩條路徑摸清楚了,於是記錄下來,之後回頭翻會省下不少摸索的時間。

使用前提:先把需要的檔案引入

easyUI 的元件本質上是 jQuery 外掛,因此載入順序不能馬虎:必須先載入 jQuery 本體,再載入 easyUI 主程式,最後才是中文語系檔。語系檔放在最後,分頁、篩選、載入中等介面文字才會正確顯示為中文。

<link rel="stylesheet" type="text/css" href="./css/easyui.css">
<link rel="stylesheet" type="text/css" href="./css/icon.css">
<link rel="stylesheet" type="text/css" href="./css/demo.css">
<script type="text/javascript" src="./js/jquery.min.js"></script>
<script type="text/javascript" src="./js/jquery.easyui.min.js"></script>
<script type="text/javascript" src="./js/easyui-lang-zh_CN.js"></script>

效果展示

完成後的樣子大致如下:上方是搜索區,可切換查詢類型並輸入關鍵字;下方表格會依查詢結果重新渲染。

遇到的問題:datagrid 的兩種資料來源

datagrid 的 data-options 裡有個 url 屬性,而它對應的資料載入方式其實有兩條路:

第一條是 遠程載入:直接把 url 指向後端一個固定端點,datagrid 會自行發出請求、自行處理分頁與排序參數。這種做法最省事,但查詢條件變動時,需要透過 options 的 queryParams 去追加參數再 reload。

第二條是 本地資料載入:先由自己取得 JSON,再用 loadData 方法把資料灌進表格。

我這次要實作的情境是:使用者先選擇查詢類型,輸入關鍵字後按 Enter,透過 Ajax 呼叫 Spring MVC 的 controller 做業務處理,再把渲染用的資料取回來。這種「條件由前端決定、流程由後端掌控」的互動,用第二種方式(loadData)來得最直接,也不必為了每次查詢去改寫 url。

具體實現

後端的部分很單純:在 controller 的方法上加 @ResponseBody,方法的回傳值就會被序列化成 JSON,而不是被當成視圖名稱去解析。

前端則在 Ajax 的回呼函式裡,把回傳的陣列包裝成 datagrid 認得的結構——total 是總筆數、rows 是資料列——再交給 loadData。

function doSearch(value, name) {
    $.post("search/getSearchResult", { "value": value, "name": name }, function (data) {
        if (data == null || data == "") {
            alert("輸入名字有誤,請重新輸入");
            $("#input1").val("");
            window.location.reload();
        } else {
            $("#dataTables").css('display', 'block');

            if (name == 'teacher') {
                initTeacherDataGrid();
            } else if (name == 'student') {
                initStudentDataGrid();
            }

            var jsdata = { 'total': data.length, 'rows': data };
            $("#magazineGrid1").datagrid('loadData', jsdata);
        }
    });
}

幾個實作時值得留意的細節

表格要先初始化,再餵資料。 loadData 是 datagrid 的例項方法,如果表格還沒被 $('#magazineGrid1').datagrid({...}) 初始化過就呼叫,是拿不到資料的。所以程式碼裡先依查詢類型決定要初始化哪一份表格(老師或學生),再載入資料,這個順序不能顛倒。

選擇器要對得上。 上面那段程式裡,顯示容器用的是 #dataTables,實際灌資料的卻是 #magazineGrid1。如果兩者指向的元素不一致,畫面就會出現「查詢成功但什麼都沒顯示」的狀況。建議把表格的 id 統一管理,避免這類低Level 的失誤。

JSON 結構要符合 datagrid 期待。 除了 total 與 rows,如果列的欄位名稱與 columns 定義裡的 field 對不上,該欄就會是空白。後端回傳前值得先確認欄位命名一致。

空結果的處理方式可以更細緻。 原範例在查無資料時直接 reload 整個頁面,體驗上略顯粗暴。實務上比較好的做法是把表格清空並顯示提示訊息,讓使用者可以留在原頁面調整關鍵字再試一次。

整體來說,easyUI 的 datagrid 在「後端決定資料、前端負責呈現」這種模式下相當順手;只要掌握初始化時機、選擇器一致性與 JSON 結構這三件事,整合起來並不複雜。

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