6.分页
6.1 分页方案
Supcan Treelist有二种分页方案:依赖外部Freeform Pager(自由表头的分页器)的方案、垂直滚动条即滚即刷新的内部分页方案.6.2 总行数
分页显示时,通常需要先取得数据的总行数,硕正提供二种获取总行数的方法:<root> <resultSet totalRows="12000"> <record> ... </record> <record> ... </record> ... </resultSet> </root>该XML包表明了总行数是12000行,或者这样写也可以:
<root> <totalRows>12000</totalRows> <resultSet> <record> ... </record> <record> ... </record> ... </resultSet> </root>对于JSON格式,可以是:
{"totalRows": 12000, "Record": [ {"Country":"France", "OrderID":"10248", "CustomerID":"VINET"}, {"Country":"Germany", "OrderID":"10249", "CustomerID":"TOMSP"}, {"Country":"Brazil", "OrderID":"10250", "CustomerID":"HANAR"} ]}或:
{"Record": [ {"Country":"France", "OrderID":"10248", "CustomerID":"VINET"}, {"Country":"Germany", "OrderID":"10249", "CustomerID":"TOMSP"}, {"Country":"Brazil", "OrderID":"10250", "CustomerID":"HANAR"} ], "totalRows": 12000}方法二:在XML中定义 "totalRows" 属性(或在页面中通过SetProp函数动态设置),这是一个独立的普通URL,例如:totalRows = "../stock/search1.aspx?tag=23",服务器只要返回总行数即可。 但这种方案的缺点显而易见:需要访问二遍服务器,影响性能.
6.3 其它功能
6.3.1 全部打印
在企业应用中,有这么一种常见的需求:以分页显示,但是调用菜单的“打印”、“转换输出”时,却要求得到全部的数据。6.3.2 服务端排序
默认情况下,排序操作是在客户端进行的,如果要在服务器端实现排序,那么需要在<Properties>中定义IsRemoteSort="true"。function OnReady(id) { if(id=='AF1') { bReadyAF1 = true; AF1.func("Build", "treelist/t1.xml"); //这行指定要求服务端排序 AF1.func("SetProp", "IsRemoteSort \r\n1"); } ...(略) } function OnEvent(id, Event, p1, p2, p3, p4) { if(id=='AF1' && Event=='Sort' && p1=='1') { //取得当前的排序串 var sort=AF1.func("GetProp", "sort"); //修改取数URL, 它会立即刷新的 AF2.func("SetObjectProp", "ID0 \r\n dataURL \r\n http://localhost/DotNet/rcds.aspx?startRow=@startRow&rows=@rows&sort="+sort); } ...(略) }在源码的第18行,sort=? 的条件子句,已包含了排序串,诸如"date a,custid d,price d",需要你后端去解析.
6.4 ajax取数
含有分页器的分页数据流转过程是:分页器负责从后端取数,并把数据交给绑定的Treelist显示。function OnReady(id) { ... //前面部分略 if(bReadyAF1 && bReadyAF2) { //绑定 var h = AF1.func("GetHandle", ""); AF2.func("BindPager", h + "\r\n ID0"); //取得分页器的 "每页行数" 属性 var pgrows = AF2.func("GetObjProp", "ID0 \r\n PageRows"); //拼装出取第一页数据的URL var url = "http://www.supcan.cn/DotNet/access.aspx?sleep=1&startRow=0&rows=" + pgrows; //通过ajax取得数据串(注:这里是通过download全局函数模拟ajax的) var xml = AF1.func("download", url + "\r\n toString=1;isEcho=0"); //把XML数据串交给分页器 AF2.func("SetObjectProp", "ID0\r\n dataURL \r\n" +xml); } }上述代码仅仅是取得第一页的数据,当用户点击分页器的页码时,会触发"Pager"事件,所以还需要解决"Pager"事件:
function OnEvent(id, Event, p1, p2, p3, p4) { if(id=='AF2') { if(Event=="Pager") { //p2,p3参数分别为开始行和每页行数 var url = "http://www.supcan.cn/DotNet/access.aspx?sleep=1&startRow=" +p2+ "&rows=" + p3; //通过ajax取得数据串(注:这里是通过download全局函数模拟ajax的) var xml = AF1.func("download", url + "\r\n toString=1;isEcho=0"); //有如下2种方法转交数据: //方法一:把数据给分页器 AF2.func("SetObjectProp", "ID0\r\n dataURL \r\n" +xml); //方法二:也可以直接把数据给Treelist AF1.func("load", xml); return; } ...(其它事件:略) }