DWZ分页、排序失效小结

1. 在视图文件中与分页相关的代码段

<form id="pagerForm" method="post" action="w_list.html">
    <input type="hidden" name="pageNum" value="1" />
    <input type="hidden" name="numPerPage" value="<%= Model.numPerPage %>" />
    <input type="hidden" name="orderField" value="<%= param.orderField %>" />
    <input type="hidden" name="orderDirection" value="<%= param.orderDirection %>" />
</form>

<div class="panelBar" >
        <div class="pages">
            <span>显示</span>
            <select name="numPerPage" onchange="navTabPageBreak({numPerPage:this.value})">
                <option value="20">20</option>
                <option value="50">50</option>
                <option value="100">100</option>
                <option value="200">200</option>
            </select>
            <span>条，共200条</span>
        </div>
        
        <div class="pagination" targetType="navTab" totalCount="200" numPerPage="20" pageNumShown="10" currentPage="2"></div>

    </div>

</div>

页面如下图所示：

分页或排序动作会调用到 dwz.ajax.js 中的两个关键脚本方法：

/**
 * 处理navTab中的分页和排序
 * targetType: navTab 或 dialog
 * rel: 可选 用于局部刷新div id号
 * data: pagerForm参数 {pageNum:"n", numPerPage:"n", orderField:"xxx", orderDirection:""}
 * callback: 加载完成回调函数
 */

function dwzPageBreak(options){
    var op = $.extend({ targetType:"navTab", rel:"", data:{pageNum:"", numPerPage:"", orderField:"", orderDirection:""}, callback:null}, options);　　　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　　　// 参数rel来自于上面第二段代码13行的一个可选属性，用于指定当一个页面内存在有多个表单时，分页操作作用的对象

    var $parent = op.targetType == "dialog" ? $.pdialog.getCurrent() : navTab.getCurrentPanel(); 
　　　　　　　　　　　　　　　　　　　　// 获取到的 $parent 对象为包含 id=“pagerForm” 的 Form 表单

    if (op.rel) {
        var $box = $parent.find("#" + op.rel);
        var form = _getPagerForm($box, op.data);
        if (form) {
            $box.ajaxUrl({
                type:"POST", url:$(form).attr("action"), data: $(form).serializeArray(), callback:function(){
                    $box.find("[layoutH]").layoutH();
                }
            });
        }
    } else {
        var form = _getPagerForm($parent, op.data);
        var params = $(form).serializeArray();
        
        if (op.targetType == "dialog") {
            if (form) $.pdialog.reload($(form).attr("action"), {data: params, callback: op.callback});
        } else {
            if (form) navTab.reload($(form).attr("action"), {data: params, callback: op.callback});
        }
    }
}

/**
 * 
 * @param {Object} args {pageNum:"",numPerPage:"",orderField:"",orderDirection:""}
 * @param String formId 分页表单选择器，非必填项默认值是 "pagerForm"
 */
function _getPagerForm($parent, args) {
    var form = $("#pagerForm", $parent).get(0);

    if (form) {
        if (args["pageNum"]) form[DWZ.pageInfo.pageNum].value = args["pageNum"];
        if (args["numPerPage"]) form[DWZ.pageInfo.numPerPage].value = args["numPerPage"];
        if (args["orderField"]) form[DWZ.pageInfo.orderField].value = args["orderField"];
        if (args["orderDirection"] && form[DWZ.pageInfo.orderDirection]) form[DWZ.pageInfo.orderDirection].value = args["orderDirection"];
    }
    
    return form;
}

这次在工作中，分页失效的主要原因就是没有将分页排序的几个相关的隐藏表单元素放在 id="pagerForm" ，导致在第一个脚本方法中并没有获取到正确的 Jquery 对象 $parent ，从而传递到第二个方法时获取到的 form 变量值为 undefined