DWZ富客户端框架使用手册

概述

DWZ富客户端框架(jQuery RIA framework), 是中国人自己开发的基于jQuery实现的Ajax RIA开源框架.

DWZ富客户端框架设计目标是简单实用、扩展方便、快速开发、RIA思路、轻量级

DWZ框架支持用html扩展的方式来代替javascript代码, 只要懂html语法, 再参考DWZ使用手册就可以做ajax开发.

开发人员不写javascript的情况下, 也能用ajax做项目和使用各种UI组件. 基本可以保证程序员不懂javascript,也能使用各种页面组件和ajax技术. 如果有特定需求也可以扩展DWZ做定制化开发.

做ajax项目时需要写大量的javascript才能达到满意的效果. 国内很多程序员javascript不熟, 大大影响了开发速度. 使用DWZ框架自动邦定javascript效果. 不需要开发人员去关心javascript怎么写, 只要写标准html就可以了. DWZ简单扩展了html标准, 给HTML定义了一些特别的class 和attribute. DWZ框架会找到当前请求结果中的那些特别的class 和attribute, 并自动关联上相应的js处理事件和效果.

DWZ基于jQuery可以非常方便的定制特定需求的UI组件, 并以jQuery插件的形式发布出来. 如有需要也可做定制化开发.

欢迎大家提出建议, 我们将在下一版本中进一步调整和完善功能.

DWZ富客户端框架是开源项目, 可以免费获取源码. 希望有多的开发人员使用, 共同推进国内整体ajax开发水平.

在线演示地址 http://j-ui.com/

在线文档http://j-ui.com/doc/dwz-user-guide.pdf

 Code下载: https://code.csdn.net/dwzteam/

设计思路

第一次打开页面时载入界面到客户端,之后和服务器的交互只是数据交互,不占用界面相关的网络流量.

支持HTML扩展方式来调用DWZ组件.

标准化Ajax开发, 降低Ajax开发成本.

学习DWZ的建议

刚接触DWZ的人可能感觉DWZ文档太少、入门困难,原因都是没有掌握正确的学方法。建议按下面的步骤来学习DWZ框架:

·      通读DWZ文档,很多新手提的问题文档中都写了。

·      看demo每个组件演示效果和代码(留意组件html结构)。

·      建议安装firebug,用firebug看html结构、CSS和调试JS都非常方便。见附录一 firebug介绍。

·      对于初学者不建议看DWZ全部源码,但还是非常有必要看看dwz.ui.jsdwz.ajax.js

·      可以从google code下载dwz_thinkphp版本,结合php后台去理解DWZ和服务器端的交互方式

DWZ区别于其它JS框架,最大的优点

·      完全开源,源码没有做任何混淆处理,方便扩展

·      CSS和js代码彻底分离,修改样式方便

·      简单实用,扩展方便,轻量级框架,快速开发

·      仍然保留了html的页面布局方式

·      支持HTML扩展方式调用UI组件,开发人员不需写js

·      只要懂html语法不需精通js,就可以使用ajax开发后台

·      基于jQuery,UI组件以jQuery插件的形式发布,扩展方便

 

版权声明

·     DWZ框架的源代码完全开放,在Apache License 2.0许可下, 可免费应用于个人或商业目的。

·     欢迎各大网站转载下载版本。

·     禁止把DWZ框架包装成另外一个UI框架出售。

DWZ团队介绍

DWZ团队核心成员目前是3人(杜权、吴平、张慧华)

杜权从事UI设计工作,有10年以上UI设计经验。做过至少1500个网站的UI设计。

吴平主要做Java  web开发,兼ajax开发。一直从事电子商务、企业建站平台开发工作。目前就职于支付宝应用架构师职位。

张慧华主要做Java  web开发,兼ajax开发。以前也是电子商务、企业建站平台开发工作。从2009年4月开始从事建筑能效评估IT解决方案。目前从Java开发转型做HTML5手机APP。

以前我们做的大部份java项目都用了Ajax,项目开发过程中经常自己做一些UI组件和界面效果。我们对RIA非常感兴趣,业余时间就做了DWZ富客户端框架。DWZ框架中的UI组件都是从我们做过的大量web项目中总结出来的,都是一些非常实用的UI组件。


官方微博(欢迎加入) http://weibo.com/dwzui


合作电话:010-52897073    18600055221

技术服务:0571-88517625   17767167745


 

HTML扩展

支持HTML扩展方式来调用DWZ组件

Ajax链接扩展

<a href=”xxx” target=“ajax” [rel=“boxId”]>

示例: <ahref="w_alert.html" target="ajax" rel="container">提示窗口</a>

当前navTab中链接ajax post扩展

<a href="user.do?method=remove"target="ajaxTodo">删除</a>

<a href="user.do?method=remove"target="ajaxTodo"title="确定要删除吗?">删除</a>

Title为可选项,如果设置,点击后将调用alertMsg.confirm与用户交互确认或取消,Title值为提示信息.Target值为ajaxTodo时会自动关联如下JS。

$("a[target=ajaxTodo]", $p).each(function(){

    $(this).click(function(event){

       var $this = $(this);

       var title = $this.attr("title");

       if (title) {

           alertMsg.confirm(title, {

              okCall: function(){

                  ajaxTodo($this.attr("href"));

              }

           });

       } else {

           ajaxTodo($this.attr("href"));

       }

       event.preventDefault();

    });

});

dialog链接扩展

<a href=”xxx” target=“dialog”[rel=“dialogId”]>

A所指向页面将会在dialog 弹出层中打开,rel标识此弹出层的ID,rel为可选项。

Html标签扩展方式示例:

<a href="w_dialog.html" target="dialog"rel="page2">弹出窗口</a>

<a href="demo_page1.html"target="dialog" [max=true, mask=true, maxable=true,minable=true, resizable=true,drawable=true] rel="dlg_page1"title="[自定义标题]" width="800" height="480">打开窗口一</a>

 

Max 属性表示此dialog打开时默认最大化, mask表示打开层后将背景遮盖. maxable: dialog 是否可最大化,

       minable:   dialog 是否可最小化,

       maxable:   dialog 是否可最大化

       resizable: dialog 是否可变大小

       drawable: dialog 是否可拖动

       width:   dialog 打开时的默认宽度

       height:    dialog 打开时默认的高度

width,height分别打开dialog时的宽度与高度.

fresh:   重复打开dialog时是否重新载入数据,默认值true,

close:   关闭dialog时的监听函数,需要有boolean类型的返回值,

param:   close监听函数的参数列表,以json格式表示,例{msg:’message’}

 

 

关闭窗口:

在弹出窗口页面内放置<button class="close" value="关闭"></button>即可。

 

JS调用方式示例:

$.pdialog.open(url, dlgId, title);

$.pdialog.open(url, dlgId, title, options); 

 

options:{width:100px,height:100px,max:true,mask:true,mixable:true,minable:true,resizable:true,drawable:true,fresh:true,close:”function”,param:”{msg:’message’}”}, 所有参数都是可选项。

 

关闭dialog层:

 

$.pdialog.close(dialog); 参数dialog可以是弹出层jQuery对象或者是打开dialog层时的dlgId.

 

或者

 

$.pdialog.closeCurrent(); 关闭当前活动层。

 

$.pdialog.reload(url, {data:{}, dialogId:"",callback:null})

刷新dialogId指定的dialog,url:刷新时可重新指定加载数据的url, data:为加载数据时所需的参数。

navTab链接扩展

<a href=”xxx” target=“navTab”[rel=“tabId”]>

示例:

<a href="url" target="navTab" >默认页面</a>

<a href="url" target="navTab" rel="page1" title="自定义标签名" fresh="false">自定义页面</a>

<a href="url" target="navTab" external="true">iframe方式打开</a>

 

target=navTab: 自动关联调用navTab组件

rel: 为navtab的ID值,后续可以用来重载该页面时使用,如当前页新增或删除数据可以通过该ID进行通知JS重载。注意rel的值区分大小写.

fresh: 表示重复打开navTab时是否重新加载数据

external: 为external="true"或者href是外网连接时,以iframe方式打开navTab页面

Js调用

navTab.openTab(tabid, url, { title:”New Tab”, fresh:false, data:{} });

其中data:{} json格式的数据

Tab组件扩展

开发人员不需写任何javacsript,只要使用下面的html结构就可以.

<div class="tabs">

    <div class="tabsHeader">

       <div class="tabsHeaderContent">

           <ul>

              <li class="selected"><a href="#"><span>标题1</span></a></li>

              <li><a href="#"><span>标题2</span></a></li>

           </ul>

       </div>

    </div>

    <div class="tabsContent"style="height:150px;">

       <div>内容1</div>

       <div>内容2</div>

    </div>

    <div class="tabsFooter">

       <div class="tabsFooterContent"></div>

    </div>

</div>

Accordion组件

<div class="accordion"[fillSpace=”xxxKey”]>

    <div class="accordionHeader">

       <h2><span>icon</span>面板1</h2>

    </div>

    <div class="accordionContent"style="height:200px">

       内容1

    </div>

    <div class="accordionHeader">

       <h2><span>icon</span>面板2</h2>

    </div>

    <div class="accordionContent">

       内容2

    </div>

    <div class="accordionHeader">

       <h2><span>icon</span>面板3</h2>

    </div>

    <div class="accordionContent">

       内容3

    </div>

</div>

容器高度自适应

容器高度自适应, 只要增加扩展属性layoutH=”xx”, 单位是像素.

LayoutH表示容器内工具栏高度.  浏览器窗口大小改变时容器高度自适应, 但容器内工具栏高度是固定的, 需要告诉js工具栏高度来计算出内容的高度.

示例:

<div class=”layoutBox”>

<div layoutH=“150”>内容</div>

</div>

注意: layoutH=“150”的高度是根据含有class=”layoutBox”的父容器div动态更新的

CSS  Table

原生html + CSS实现,无js处理效果、最简单、最基本、性能最高的table。

在table标签上增加class="list", table外面包一个<div layoutH="xx">实现table固定高度

<div layoutH="120">

<table class="list" width="98%">

    <thead>

       <tr>

           <th colspan="2">客户信息</th>

           <th colspan="2">基本信息</th>

           <th colspan="3">资料信息</th>

       </tr>

       <tr>

           <th width="80">客户号</th>

           <th width="100">客户名称</th>

           <th width="100">客户划分</th>

           <th>证件号码</th>

           <th align="right" width="100">信用等级</th>

           <th width="100">企业性质</th>

           <th width="100">建档日期</th>

       </tr>

    </thead>

<tbody>

       <tr>

           <td>iso127309</td>

           <td>北京市政府咿呀哟</td>

           <td>政府单位</td>

           <td>0-0001027766351528</td>

           <td>四等级</td>

           <td>政府单位</td>

           <td>2009-05-21</td>

       </tr>

    </tbody>

</table>

</div>

Table扩展

在table标签上增加class="table"

<table layoutH="170" class="table">

    <thead>

       <tr>

           <th width="80">客户号</th>

           <th width="100">客户名称</th>

           <th align="right">证件号码</th>

           <th width="100">建档日期</th>

       </tr>

    </thead>

    <tbody>

       <tr>

           <td>iso127309</td>

           <td>北京市政府</td>

           <td>0-0001027766351528</td>

           <td>2009-05-21</td>

       </tr>

    </tbody>

</table>

在线编辑器

在textarea标签上增加class="editor"

示例:

<textarea class="editor" name="description" rows="15" cols="80">内容</textarea>

 

分页组件

分页思路服务器返回当前页的数据,总条数,再由js来生成分页标签。分页是配合服务器端来处理的, 不是存js做的分页。

因为如果数据量很大,比如有好几百页,存js分页就是悲剧了,存js分页是必须一次载入所有数据,性能很慢。

分页组件参数要由服务器传过来targetType,totalCount,numPerPage,pageNumShown,currentPage

框架会自动把下面的form中pageNum修改后,ajax重新发请求。下面这个form是用来存查询条件的

<form id="pagerForm" action="xxx" method="post">

    <input type="hidden" name="pageNum"value="1" />/><!--【必须】value=1可以写死-->

    <input type="hidden" name="numPerPage"value="20" /><!--【可选】每页显示多少条-->

    <input type="hidden" name="orderField"value="xxx" /><!--【可选】查询排序-->

    <input type="hidden" name="orderDirection" value="asc" /><!--【可选】升序降序-->

 

    <!--【可选】其它查询条件,业务有关,有什么查询条件就加什么参数。

    也可以在searchForm上设置属性rel=”pagerForm”,js框架会自动把searchForm搜索条件复制到pagerForm中-->

<input type="hidden" name="name" value="xxx" />

    <input type="hidden" name="status" value="active" />

    ……

</form>

分页组件处理分页流程:

1) pagerForm中缓存了当前的查询条件,加上一个pageNum字段

2) 点击分页时动态修改pageNum,重新提交pagerForm

分页组件使用方法:

<divclass="pagination" targetType="navTab"totalCount="200" numPerPage="20"pageNumShown="10" currentPage="1"></div>

测试方法,currentPage从1改为2,就是第2页了,把上面那句改为:

<divclass="pagination" targetType="navTab"totalCount="200" numPerPage="20"pageNumShown="10" currentPage="2"></div>

参数说明:

           targetType: navTab或dialog,用来标记是navTab上的分页还是dialog上的分页

           totalCount: 总条数      

           numPerPage: 每页显示多少条

           pageNumShown: 页标数字多少个

           currentPage: 当前是第几页

注意:

服务器端返回一个页面碎片,其中包括pagerForm, table, 和分页的div。只要把这个页面碎片组装好就行。

 

ajaxTodo扩展

navTab页面上a链接添加target="ajaxTodo" 后框架会自动绑定相应的ajax处理。【参考dwz.ajax.js】

可选a链接扩展属性[title="xxx"] 提示确认信息

示例:

<a href="/news.do?method=remove&id=${item.id}"target="ajaxTodo" title="确定要删除吗?">>删除</a>

<a href="/news.do?method=publish&id=${item.id}"target="ajaxTodo">发表</a>

 

框架自动绑定js

$("a[target=ajaxTodo]", $p).each(function(){

    $(this).click(function(event){

       ajaxTodo($(this).attr("href"));

       event.preventDefault();

    });

});

 

dwzExport列表数据导出

链接添加target="dwzExport" 后框架会自动绑定相应的ajax处理。

targetType="navTab" 根据当期navTab页面中的pagerForm参数导出, 默认

targetType="dialog" 根据当期dialog页面中的pagerForm参数导出

title="实要导出这些记录吗?" 确认提示信息,可选项
示例:

<a href="doc/dwz-team.xls" target="dwzExport"targetType="dialog" title="实要导出这些记录吗?">导出EXCEL</a>

Input alt扩展

示例:

<input name="xxx" alt="请输入客户名称"/>

Tree扩展

<ul class="tree [treeFoldertreeCheck [expand|collapse]]" oncheck="kkk">

<li><a href="#" target="navTab" rel="main" tname="name" tvalue="value" checked="true">第一级菜单项 A</a>

       <ul>

           <li><a href="#" target="dialog" rel="dialog1" tname="name" tvalue="value" checked="true">第二级菜单项 A </a></li>

           <li><a href="#">第二级菜单项 B </a></li>

           <li><a href="#">第二级菜单项 C </a>

              <ul>

                  <li><a href="#">第三级菜单项 A </a></li>

                  <li><a href="#">第三级菜单项 B </a></li>

              </ul>

           </li>

       </ul>

    </li>

    <li><a href="#">第一级菜单项 B</a></li>

</ul>

 

树结构是按<ul>,<li>的嵌套格式构成,将最顶级的<ul>以class=”tree”标识即可。treeFolder, treeCheck, expand|collapse则为可选的。

treeFolder:在所有树节点前加上Icon图标

treeCheck:在所有树节点前加上checkbox,此时需要在<a> 加上三个扩展属性tname=””, tvalue=””, checked, 其中tname与tvalue对应该checkbox的name 与value属性

checked表示checkbox的默认状态是否checked.

expand与collapse:expand表示树的所有第一级节点默认是展开状态,collapse则表示所有第一级节点默认为折叠状态,当expand与collapse都没有时默认则会展开第一个节点。

 扩展属性oncheck是自定义函数, 用来接收点击checkbox时返回值, 当点击非子树节点checkbox时返回数据格式为:{checked:true|false,items:{name:name, value:value}}, 当点击了树节点checkbox时, 此子树节点下所有的checkbox都将选中, 同时返回此子树节点下所有的checkbox的值, 格式为{checked:true|false,items:{{name:name, value:value}, {name:name, value:value}……}}

Panel扩展

<divclass="panel [close collapse]" [defH="200"|minH=”100”]>

<h1>标题</h1>

    <div>

       内容

    </div>

</div>

顶层div 以class=”panel”标识即可, 其中的<h1>为panel的标题,  <h1>后的<div>则是放置内容的容器.

Class 中的close 与collapse为可选项, close表示panel默认为关闭状态, 没有则默认为打开状态.collapse 再表示此panel是否为可折叠的panel, 没有则此panel不可折叠. 扩展属性defH则表示panel 内容部分的固定高度, 没有则panel内容部分的高度为实际内容的高度, minH可以指定panel内容部分的最小高度.

 

日历控件

<input type="text" name="xxx" class="date" [dateFmt="yyyy-MM-dd"] [minDate="{%y-80}"][maxDate="{%y+5}"]/>

日期格式:

 * Field        | Full Form          | Short Form

 * -------------+--------------------+-----------------------

 * Year         | yyyy (4 digits)    | yy (2 digits), y (2 or 4 digits)

 * Month        | MMM (name or abbr.)| MM (2 digits), M (1 or 2 digits)

 *             | NNN(abbr.)        |

 * Day of Month | dd (2 digits)      | d (1 or 2 digits)

 * Day of Week  | EE (name)          | E (abbr)

 * Hour (1-12)  | hh (2 digits)      | h (1 or 2 digits)

 * Hour (0-23)  | HH (2 digits)      | H (1 or 2 digits)

 * Hour (0-11)  | KK (2 digits)      | K (1 or 2 digits)

 * Hour (1-24)  | kk (2 digits)      | k (1 or 2 digits)

 * Minute       | mm (2 digits)     | m(1 or 2 digits)

 * Second       | ss (2 digits)     | s(1 or 2 digits)

 * AM/PM        | a                 |

定义日期范围属性minDate,maxDate静态格式y-M-d或y-M或y,支持以下几种写法:

minDate="2000-01-15"maxDate="2012-12-15"

minDate="2000-01"maxDate="2012-12"

minDate="2000"maxDate="2012"

 

定义日期范围属性minDate,maxDate动态态格式%y-%M-%d或%y-%M或%y,支持以下几种写法:

minDate="{%y-10}-%M-%d"maxDate="{%y}-%M-{%d+1}"

minDate="{%y-10}-%M"maxDate="{%y+10}-%M"

minDate="{%y-10}"maxDate="{%y+10}"

 

示例:

<p>

    <label>默认格式:</label>

    <input type="text" name="date1" class="date" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy-MM-dd</span>

</p>

<p>

    <label>定义日期范围:</label>

    <input type="text" name="date2" value="2000-01-15" class="date" minDate="2000-01-15" maxDate="2012-12-15" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

</p>

<p>

    <label>自定义日期格式:</label>

    <input type="text" name="date3" class="date" dateFmt="yyyy/MM/dd" minDate="2000-01" maxDate="2012-06" readonly="true" />

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy/MM/dd</span>

</p>

<p>

    <label>自定义日期格式:</label>

    <input type="text" name="date4" class="date" dateFmt="dd/MM/yyyy" minDate="2000" maxDate="2012" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">dd/MM/yyyy</span>

</p>

<p>

    <label>动态参数minDate:</label>

    <input type="text" name="date5" class="date" dateFmt="dd/MM/yy" minDate="{%y-10}-%M-%d" maxDate="{%y}-%M-{%d+1}"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">dd/MM/yy</span>

</p>

<p>

    <label>自定义日期格式:</label>

    <input type="text" name="date6" class="date" dateFmt="yyyyMMdd" minDate="2000-01-01" maxDate="2020-12-31"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyyMMdd</span>

</p>

<p>

    <label>自定义日期格式:</label>

    <input type="text" name="date7" class="date" dateFmt="yyyy年MM月dd日" minDate="2000-01-01" maxDate="2020-12-31"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy年MM月dd日</span>

</p>

<p>

    <label>自定义日期格式:</label>

    <input type="text" name="date8" class="date" dateFmt="y年M月d日" minDate="2000-01-01" maxDate="2020-12-31"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">y年M月d日</span>

</p>

 

<div class="divider"></div>

<h3>日期 + 时间</h3>

<div class="unit">

    <label>自定义日期格式:</label>

    <input type="text" name="date10" class="date" dateFmt="yyyy-MM-ddHH:mm:ss" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy-MM-dd HH:mm:ss</span>

</div>

<div class="unit">

    <label>自定义日期格式:</label>

    <input type="text" name="date11" class="date" dateFmt="yyyy-MM-dd HH:mm" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy-MM-dd HH:mm</span>

</div>

<div class="unit">

    <label>自定义日期格式:</label>

    <input type="text" name="date12" class="date" dateFmt="yyyy-MM-dd HH:ss" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">yyyy-MM-dd HH:ss</span>

</div>

   

<div class="unit">

    <label>自定义日期格式:</label>

    <input type="text" name="date13" class="date" dateFmt="y年M月d日 H点" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">y年M月d日 H点</span>

</div>

<div class="unit">

    <label>自定义日期格式:</label>

    <input type="text" name="date14" class="date" dateFmt="EEE HH:mm:ss" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">EEE HH:mm:ss</span>

</div>

<div class="unit">

    <label>自定义只有时间:</label>

    <input type="text" name="date15" class="date" dateFmt="HH:mm:ss" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">HH:mm:ss</span>

</div>

<div class="unit">

    <label>自定义时间:</label>

    <input type="text" name="date16" class="date" dateFmt="HH:mm" mmStep="15" readonly="true"/>

    <a class="inputDateButton" href="javascript:;">选择</a>

    <span class="info">HH:mm</span>

</div>

 

 

url变量替换

HTML扩展方式navTab, dialog, ajaxTodo 的url支持变量替换。例如:__URL__/edit/id/{xxx}

大括号内的xxx就是变量名,主要功能是结合table组件一起使用,下面是dwz_thinkphp中用户列表的示例:

下图中的删除、编辑、修改密码都是用了url变量替换:

 

删除、编辑、修改密码使用了变量{sid_user}

<tbody>中<tr target="sid_user"rel="{$vo['id']}">

当选中一行时,tr上的rel值会自动替换到url变量中.

注意url变量名{sid_user}和tr的target="sid_user"保持一致.

 

代码示例:

   

<aclass="delete" href="__URL__/foreverdelete/id/{sid_user}/navTabId/__MODULE__"target="ajaxTodo" title="你确定要删除吗?" warn="请选择用户"><span>删除</span></a>

 

<aclass="edit" href="__URL__/edit/id/{sid_user}"target="dialog" mask="true"warn="请选择用户"><span>编辑</span></a>

 

<aclass="icon" href="__URL__/password/id/{sid_user}"target="dialog" mask="true"warn="请选择用户"><span>修改密码</span></a>

 

<tableclass="list" width="100%"layoutH="116">

    <thead>

    <tr>

       <th width="60">编号</th>

       <th width="100">用户名</th>

       <th>昵称</th>

       <th>Email</th>

       <th width="100">添加时间</th>

       <th width="120">上次登录</th>

       <th width="80">登录次数</th>

       <th width="80">状态</th>

    </tr>

    </thead>

    <tbody>

    <volist id="vo" name="list">

       <tr target="sid_user"rel="{$vo['id']}">

           <td>{$vo['id']}</td>

           <td>{$vo['account']}</td>

           <td>{$vo['nickname']}</td>

           <td>{$vo['email']}</td>

           <td>{$vo['create_time']|date="Y-m-d",###}</td>

           <td>{$vo['last_login_time']|date="Y-m-dH:i:s",###}</td>

           <td>{$vo['login_count']}</td>

           <td>{$vo['status']|showStatus=$vo['id']}</td>

       </tr>

    </volist>

    </tbody>

</table>

checkbox全选、反选

checkbox全选、反选。(demo à 表单组件 à多选框/单选框)

<label><input type="checkbox"name="c1" value="1" />选择1</label>

<label><input type="checkbox"name="c1" value="2" />选择2</label>

<label><input type="checkbox"name="c1" value="3" />选择3</label>

 

<input type="checkbox"class="checkboxCtrl" group="c1" />全选

<button type="button" class="checkboxCtrl" group="c1" selectType="invert">反选</button>

uploadify多文件上传

<div id="fileQueue"class="fileQueue"></div>

 

<input id="testFileInput" type="file" name="image"

   uploader="uploadify/scripts/uploadify.swf"

   cancelImg="uploadify/cancel.png"

   script="ajaxDone.html"

   scriptData="{PHPSESSID:'xxx', ajax:1}"

   folder="/folder"

   fileQueue="fileQueue"

   [onComplete="uploadifyComplete"]

   [onAllComplete="uploadifyAllComplete"] />

参数说明:

uploader: flash组件uploadify.swf的访问路径

cancelImg:取消按钮使用的图片路径

script:    服务器端处理上传文件的路径

scriptData:上传文件时需要传递给服务器的其他参数,是json格式

folder:    是服务器存储文件的目录

fileQueue:是上传进度显示区域

onAllComplete:可选参数,单个文件上传完时触发,参数有:

      event: event 事件对象

      Id:     上传进度队列的id

      fileObj: 是一个包含上传文件信息的对象,包括的信息有:

                            name: 文件名

                            filePath: 上传文件在服务器端的路径

                      size:     文件的大小     

                            creationDate:文件创建的时间

                      modificationDate:文件最后更改的时间

                      type:是以"."开始的文件扩展名

     response:服务器端处理完上传文件后返回的文本

      data:    包含有两个参数的对象,

                            fileCount:上传队列中还剩下的文件数

                            speed:以KB/s为单位的文件上传平均速度

uploadifyAllComplete:可选参数,全部文件上传完成时调用的函数,参数有:

      event:event事件对象

      data:是一个包含以下信息的对象,

                     filesUploaded: 已经上传的文件总数

                      errors:       上传出错的文件总数

                      allBytesLoaded:已经上传文件的总大小

                      speed:         以KB/s为单位的上传文件的平均速度

以下3个方法是dwz.ajax.js中定义的用于文件上传的会调函数:

function uploadifyAllComplete(event, data){

    if (data.errors) {

       var msg = "The totalnumber of files uploaded: "+data.filesUploaded+"\n"

           + "The totalnumber of errors while uploading: "+data.errors+"\n"

           + "The totalnumber of bytes uploaded: "+data.allBytesLoaded+"\n"

           + "The averagespeed of all uploaded files: "+data.speed;

       alert("event:" +event + "\n" +msg);

    }

}

 

function uploadifyComplete(event, queueId, fileObj, response, data){

    DWZ.ajaxDone(DWZ.jsonEval(response));

}

 

function uploadifyError(event, queueId, fileObj, errorObj){

    alert("event:" +event + "\nqueueId:" +queueId + "\nfileObj.name:"

       + fileObj.name + "\nerrorObj.type:"+ errorObj.type + "\nerrorObj.info:"+ errorObj.info);

}

 

combox组件

在传统的select 用class 定义:class=”combox”, html 扩展:保留原有属性name,  增加了属性:ref。

ref 属性则是为了做级联定义的,ref所指向的则是当前combox值改变成引起联动的下一级combox,ref用下一级combox的id属性来赋值。

注意:一般combox没必要设置id属性,只要级联时需要设置子级id等于父级ref,不同navTab和dialog中combox组件id必须唯一

以下是级联示例:

<select class="combox" name="province" ref="combox_city"refUrl="city.do?code={value}">

    <option value="all">所有省市</option>

    <option value="bj">北京</option>

    <option value="sh">上海</option>

</select>

<select class="combox" name="city" id="combox_city"ref="combox_area" refUrl=" area.do?code={value}">

    <option value="all">所有城市</option>

</select>

<select class="combox" name="area" id="combox_area">

    <option value="all">所有区县</option>

</select>

服务器端返回json格式:

[

    ["all", "所有城市"],

    ["bj", "北京市"]

]

 

suggest+lookup+主从结构

dwz.database.js主要功能是数据库操作相关的界面组件。主要分为2部分,分别是查找带回和主从结构。

·      查找带回:lookup、suggest、lookup附件(文件上传带回)、多选查找带回multLookup几个jQuery插件,以及$.bringBack、$.bringBackSuggest两个配套查找带回工具方法

·      主从结构:itemDetail

suggest+lookup+主从结构 请参照demo:界面组件 à 常用组件 à suggest+lookup+主从结构

查找带回

lookup、suggest都支持联动效果,比如类似选省份、城市联动效果。支持自定义查找带回主键lookupPk, 可选项默认为id。

 

lookup 通过复选框选择多个值查找回带示例:

请参照dwz-ria中 demo/database/ db_widge.html和demo/database/dwzOrgLookup2.html页面

<button type="button" multLookup="orgId" warn="请选择部门">选择带回</button>

 

<input type="checkbox" name="orgId" value="{id:'1', orgName:'技术部', orgNum:'1001'}"/>

<input type="checkbox" name="orgId" value="{id:'2', orgName:'人事部', orgNum:'1002'}"/>

<input type="checkbox" name="orgId" value="{id:'3', orgName:'销售部', orgNum:'1003'}"/>

主从结构

针对主表和从表的数据库结构设计,实现主从结构复合表单,动态添加、删除从表字段。

请参照dwz-ria中 demo/database/ db_widge.html

<table class="list nowrapitemDetail" addButton="新建从表1条目" width="100%">

<thead>

<tr>

    <th type="text" name="items.itemString" size="12" fieldClass="required">从字符串</th>

    <th type="text" name="items.itemInt" size="12" fieldClass="digits">从整数</th>

    <th type="text" name="items.itemFloat" size="12" fieldClass="number">从浮点</th>

    <th type="date" name="items.itemDate" size="12">从日期</th>

    <th type="date" format="yyyy-MM-dd HH:mm:ss" name="items.itemDataTime" size="16">从日期时间</th>

    <th type="lookup" name="dwz.items.org.orgName" lookupGroup="items.org" lookupUrl="xxxUrl" suggestUrl="xxxUrl" suggestFields="orgName"size="12">部门名称</th>

    <th type="enum" name="items.itemEnum" enumUrl="xxxUrl" size="12">从枚举</th>

    <th type="attach" name="dwz.items.attachment.fileName" lookupGroup="items.attachment" lookupUrl="xxxUrl" size="12">从附件</th>

    <th type="del" width="60">操作</th>

</tr>

</thead>

<tbody></tbody>

</table>

 

<table>标签中class=”itemDetail” 必须用于关联主从结构js效果。addButton=”xxx”可选默认为”Add New”用来定义添加从表按钮的文字。

 

<th>标签中:type必填项,type类型有text、date、lookup、enum、attach、del

name必填项,定义子表字段名称

size可选项,默认size=”12”,定义从表input字段的长度

fieldClass可选项,用来定义表input字段的class

lookupGroup当type=”lookup” 或type=”attach”时必填

lookupUrl当type=”lookup”时lookupUrl和suggesUrl至少填一项,当type=”attach”时必填

suggestUrl当type=”lookup”时lookupUrl和suggesUrl至少填一项

suggestFields当type=”lookup”并且有suggestUrl时必填

enumUrl当type=”enum”时必填

 Ajax表单

Ajax表单相关的操作封装在dwz.ajax.js中。表单查询、分页、表单提交js方法都已经封装在里面了。开发人员自己不需写js,按标准使用就可以了。

表单查询

DWZ中定义表单查询和分页都是用这个pagerForm来临时存查询条件。所以需要在查询页面上放下面的form

<formid="pagerForm" action="xxx" method="post">

    <input type="hidden" name="pageNum"value="1" /><!--【必须】value=1可以写死-->

    <input type="hidden" name="numPerPage"value="20" /><!--【可选】每页显示多少条-->

    <input type="hidden" name="orderField"value="xxx" /><!--【可选】查询排序-->

    <!--【可选】其它查询条件,业务有关,有什么查询条件就加什么参数-->

    <input type="hidden" name="status" value="active" />

</form>

ajax表单查询

<form action="xxx" method="post" onsubmit="returnnavTabSearch(this)">

<form action="xxx" method="post" onsubmit="returndialogSearch(this)">

修改每页显示行数

<select class="combox" 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>

 

/**

 * 处理navTab弹出层上的查询, 会重新载入当前navTab

 * @param{Object} form

 */

function navTabSearch(form){

    navTab.reload(form.action, $(form).serializeArray());

    return false;

}

/**

 * 处理dialog弹出层上的查询, 会重新载入当前dialog

 * @param{Object} form

 */

function dialogSearch(form){

    $.pdialog.reload(form.action, $(form).serializeArray());

    return false;

}

 

/**

 * 处理navTab中的分页和排序

 * @paramargs {pageNum:"n",numPerPage:"n", orderField:"xxx"}

 */

function navTabPageBreak(args){

    var form = _getPagerForm(navTab.getCurrentPanel(), args);

    if (form) navTab.reload(form.action, $(form).serializeArray());

}

/**

 * 处理dialog中的分页和排序

 * @paramargs {pageNum:"n",numPerPage:"n", orderField:"xxx"}

 */

function dialogPageBreak(args){

    var form = _getPagerForm($.pdialog.getCurrent(), args);

    if (form) $.pdialog.reload(form.action, $(form).serializeArray());

}

ajax表单查询完整示例:

<div class="pageHeader">

    <form action="/render.do?method=search"method="post" onsubmit="returnnavTabSearch(this)">

    <input type="hidden" name="resourceStatus" value="${param.resourceStatus}"/>

    <input type="hidden" name="pageNum" value="1" />

    <input type="hidden" name="orderField" value="${param.orderField}"/>

    <div class="searchBar">

       <div class="searchContent">

           <select name="resourceType">

              <option value="">全部栏目</option>

              <c:forEach var="item" items="${model.resourceTypes}">

              <option value="${item.id}"${param.resourceType eq item.id?"selected":"" }>${item.name}</option>

              </c:forEach>

           </select>

           <input name="keywords"type="text" size="25" value="${param.keywords}"/>

       </div>

       <div class="subBar">

           <ul>

              <li><div class="buttonActive"><div class="buttonContent"><button type="submit">检索</button></div></div></li>

           </ul>

       </div>

    </div>

    </form>

</div>

 

普通Ajax表单提交

DWZ框架Ajax无刷新表单提交处理流程是:

1.    ajax表单提交给服务器

2.    服务器返回一个固定格式json结构

3.    js会调函数根据这个json数据做相应的处理

注意:

DWZ框架默认的ajax表单提交都是返回json数据,告诉客户端操作是否成功,成功或失败提示信息,以及成功后的处理方式(刷新某个navTab或关闭某个navTab或navTab页面跳转)。

表单提交后服务器操作失败了,客户端接收statusCode和message后给出错误提示,表单页面是不动的。这样可以方便用户看到出错原因后直接修改表单数据再次提交,而不用重填整个表单数据。当然如果你还是喜欢表单提交后直接载入html页面也是没有问题的,参照dwz.ajax.js自己扩展一下也是没问题的。

DWZ 表单提交dwz.ajax.js

·      Ajax 表单提交后自动调用默认回调函数, 操作成功或失败提示.

Form标签上增加onsubmit="return validateCallback(this);

·      Ajax 表单提交后如果需要重新加载某个navTab或关闭dialog,可以使用dwz.ajax.js中事先定义的方法navTabAjaxDone/dialogAjaxDone

注意:如果表单在navTab页面上使用navTabAjaxDone,表单在dialog页面上使用dialogAjaxDone

Form标签上增加onsubmit="return validateCallback(this, navTabAjaxDone)"

或onsubmit="return validateCallback(this, dialogAjaxDone)"

 

·      Ajax 表单提交后如果需要做一些其它处理也可以自定义一个回调函数xxxAjaxDone。例如下面表单提交成功后关闭当前navTab, 或者重新载入某个tab.

Form标签上增加onsubmit="return validateCallback(this, xxxAjaxDone)"

服务器端响应

Ajax表单提交后服务器端需要返回以下json代码:

{

    "statusCode":"200",

    "message":"操作成功",

    "navTabId":"",

    "rel":"",

    "callbackType":"closeCurrent",

    "forwardUrl":""

}

 

以下是dwz.ajax.js中定义的navTabAjaxDone和dialogAjaxDone代码片段:

 

/**

 * navTabAjaxDone是DWZ框架中预定义的表单提交回调函数.

 * 服务器转回navTabId可以把那个navTab标记为reloadFlag=1, 下次切换到那个navTab时会重新载入内容.

 * callbackType如果是closeCurrent就会关闭当前tab

 * 只有callbackType="forward"时需要forwardUrl值

 * navTabAjaxDone这个回调函数基本可以通用了,如果还有特殊需要也可以自定义回调函数.

 * 如果表单提交只提示操作是否成功, 就可以不指定回调函数. 框架会默认调用DWZ.ajaxDone()

 * <form action="/user.do?method=save" onsubmit="return validateCallback(this,navTabAjaxDone)">

 *

 * form提交后返回json数据结构statusCode=DWZ.statusCode.ok表示操作成功, 做页面跳转等操作. statusCode=DWZ.statusCode.error表示操作失败, 提示错误原因.

 * statusCode=DWZ.statusCode.timeout表示session超时,下次点击时跳转到DWZ.loginUrl

 * {"statusCode":"200","message":"操作成功","navTabId":"navNewsLi","forwardUrl":"","callbackType":"closeCurrent"}

 * {"statusCode":"300","message":"操作失败"}

 * {"statusCode":"301","message":"会话超时"}

 *

 */

function navTabAjaxDone(json){

    DWZ.ajaxDone(json);

    if (json.statusCode == DWZ.statusCode.ok){

       if (json.navTabId){ //把指定navTab页面标记为需要“重新载入”。注意navTabId不能是当前navTab页面的

           navTab.reloadFlag(json.navTabId);

       } else { //重新载入当前navTab页面

           navTabPageBreak();

       }

      

       if ("closeCurrent" ==json.callbackType) {

           setTimeout(function(){navTab.closeCurrentTab();}, 100);

       } else if ("forward" ==json.callbackType) {

           navTab.reload(json.forwardUrl);

       }

    }

}

 

/**

 * dialog上的表单提交回调函数

 * 服务器转回navTabId,可以重新载入指定的navTab. statusCode=DWZ.statusCode.ok表示操作成功, 自动关闭当前dialog

 *

 * form提交后返回json数据结构,json格式和navTabAjaxDone一致

 */

function dialogAjaxDone(json){

    DWZ.ajaxDone(json);

    if (json.statusCode == DWZ.statusCode.ok){

       if (json.navTabId){

           navTab.reload(json.forwardUrl, {}, json.navTabId);

       }

       $.pdialog.closeCurrent();

    }

}

 

示例:

<form method="post" action="url" class="pageFormrequired-validate" onsubmit="returnvalidateCallback(this);">

<div class="pageFormContent"layoutH="56">

    <p>

       <label>E-Mail:</label>

       <input class="required email"name="email" type="text" size="30" />

    </p>

    <p>

       <label>客户名称:</label>

       <input class="required"name="name" type="text" size="30" />

    </p>

</div>

<div class="formBar">

    <ul>

       <li>

           <div class="buttonActive"><div class="buttonContent"><button type="submit">保存</button></div></div>

       </li>

       <li>

           <div class="button"><div class="buttonContent"><button type="Button" class="close">取消</button></div></div>

       </li>

    </ul>

</div>

</form>

文件上传表单提交

因为Ajax不支持enctype="multipart/form-data" 所以用隐藏iframe来处理无刷新表单提交. 

<form method="post" action="url" class="pageFormrequired-validate" enctype="multipart/form-data" onsubmit="return iframeCallback(this);">

<form method="post" action="url" class="pageFormrequired-validate" enctype="multipart/form-data"onsubmit="return iframeCallback(this, [navTabAjaxDone/dialogAjaxDone]);">

 

服务器端响应

DWZ-v1.2版本开始服务器返回和validateCallback格式保持一致:

 

{

    "statusCode":"200",

    "message":"操作成功",

    "navTabId":"",

"rel":"",

    "callbackType":"closeCurrent",

    "forwardUrl":""

}

 

DWZ-v1.2以前版本使用隐藏iframe来处理无刷新表单提交时,服务器端需要返回以下js代码:

<script type="text/javascript">

    var statusCode="200";

    var message="操作成功";

    var navTabId="";

    var forwardUrl="";

    var callbackType="closeCurrent"

 

    var response = {statusCode:statusCode,

       message:message,

       navTabId:navTabId,

       forwardUrl:forwardUrl,

       callbackType:callbackType

    };

    if(window.parent.donecallback) window.parent.donecallback(response);

</script>

 

Java服务器端表单处理示例

public class NewsAction extends BaseAction {

 

    private NewsManager manager = bf.getManager(BeanManagerKey.newsManager);

    private News news = manager.newNews();

    private Collection<News> newsList;

 

    public String add() {

       return INPUT;

    }

 

    public String insert() {

       manager.createNews(news);

       return ajaxForwardSuccess(getText("msg.operation.success"));

    }

 

    public String edit() {

       news = manager.getNews(this.getNewsId());

       return INPUT;

    }

 

    public String update() {

       News m = manager.getNews(newsId);

       m.copyProperties(news);

       manager.updateNews(m);

       return ajaxForwardSuccess(getText("msg.operation.success"));

    }

 

    public String publish() {

       manager.publishNews(newsId);

       return ajaxForwardSuccess(getText("msg.operation.success"));

    }

 

    public String disable() {

       manager.disableNews(newsId);

       return ajaxForwardSuccess(getText("msg.operation.success"));

    }

 

    public String delete() {

       manager.removeNews(newsId);

       return ajaxForwardSuccess(getText("msg.operation.success"));

    }

}

 

// BaseAction 代码片段

public class BaseAction extends ActionSupport {

    private int statusCode = 200;

    private String message = null;

    private String forwardUrl = null;

    private String ajaxForward(int statusCode) {

       this.statusCode = statusCode;

       return OPERATION_DONE;

    }

    protectedString ajaxForwardSuccess(String message) {

       this.message = message;

       return ajaxForward(200);

    }

    protectedString ajaxForwardError(String message) {

       this.message = message;

       return ajaxForward(300);

    }

    public int getStatusCode() {

       return statusCode;

    }

   

    public String getMessage() {

       return message;

    }

 

    public String getForwardUrl() {

       return forwardUrl;

    }

 

    public void setForwardUrl(String forwardUrl) {

       this.forwardUrl = forwardUrl;

    }

}

 

// 工具类判断是否ajax请求

public class ServerInfo {

    public static boolean isAjax(HttpServletRequest request) {

       if (request != null

              && "XMLHttpRequest".equalsIgnoreCase(request

                     .getHeader("X-Requested-With")))

           return true;

       return false;

}

}


 

DWZ js库介绍

DWZ框架初始化

在<head> 引入必要的js库

DWZ框架初始化会自动读取dwz.frag.xml中的页面组件碎片代码.

dwz.frag.xml中定义了一些dwz组件碎片和提示信息, 需要初始化到DWZ环境中.

注意dwz.frag.xml路径问题.

 

假设dwz.frag.xml放在根目录下, 在<head>标签中调用DWZ.init("dwz.frag.xml")

<script type="text/javascript">

$(function(){

    DWZ.init("dwz.frag.xml",{

       loginUrl:"login.html",

       callback:function(){

           initEnv();

           $("#themeList").theme({themeBase:"themes"});

       }

    });

});

</script>

 

dwz.core.js

DWZ核心库主要功能是DWZ初始化, Javascript String增加了一些扩展方法.

定义dwz ajax 加载扩展loadUrl(url, data, callback)和ajaxUrl(options)

dwz.ui.js

页面效果初始化,html扩展绑定js效果

dwz.ajax.js

ajax表单提交封装

dwz.alertMsg.js

Ø  确认提示框

alertMsg.confirm("您修改的资料未保存,请选择保存或取消!", {

      okCall:function(){

                 $.post(url,{accountId: accountId}, DWZ.ajaxDone, "json");

      }

});

Ø  成功提示框      alertMsg.correct('您的数据提交成功!')

Ø  错误提示框       alertMsg.error('您提交的数据有误,请检查后重新提交!')

Ø  警告提示框       alertMsg.warn('您提交的数据有误,请检查后重新提交!')

Ø  信息提示框       alertMsg.info('您提交的数据有误,请检查后重新提交!')

dwz.jDialog.js

弹出层组件库

dwz.accordion.js

滑动面板组件库

dwz.barDrag.js

DWZ左边的活动面板

dwz.navTab.js

导航tab组件库

navTab API

打开一个标签页  navTab.openTab(tabid, title,url, [data])

重新载入标签页,如果无tabid参数,就载入当前标签页navTab.reload(url,data, [tabid])

获取当前标签页容器 navTab.getCurrentPanel()

关闭一个标签页navTab.closeTab(tabid)

关闭当前标签页navTab.closeCurrentTab()

关闭全部标签页navTab.closeAllTab()

dwz.scrollCenter.js

页面容器自动居中组件

dwz.stable.js

table组件库

dwz.cssTable.js

简单table组件库

dwz.tree.js

tree组件库

dwz.theme.js

切换界面主题风格

dwz.validate.method.js

这是jquery.validate.js表单验证扩展方法

dwz.validate.zh.js

表单验证本地化

dwz.contextmenu.js

自定义鼠标右键菜单, 先在dwz.frag.xml加入菜单项定义,下面是navTab和dialog两个组件的菜单项定义:

<_PAGE_ id="navTabCM"><![CDATA[

<ulid="navTabCM">

    <li rel="closeCurrent">关闭标签页</li>

    <li rel="closeOther">关闭其它标签页</li>

    <li rel="closeAll">关闭全部标签页</li>

</ul>

]]></_PAGE_>

 

<_PAGE_ id="dialogCM"><![CDATA[

<ulid="dialogCM">

    <li rel="closeCurrent">关闭弹出窗口</li>

    <li rel="closeOther">关闭其它弹出窗口</li>

    <li rel="closeAll">关闭全部弹出窗口</li>

</ul>

]]></_PAGE_>

示例:

$("body").contextMenu('navTabCM', {

    bindings:{

       closeCurrent:function(t){

           // TODO

       },

       closeOther:function(t){

           // TODO

       },

       closeAll:function(t){

           // TODO

       }

    },

    ctrSub:function(t,m){

       var mCur = m.find("[rel='closeCurrent']");

       var mOther = m.find("[rel='closeOther']");

       var mAll = m.find("[rel='closeAll']");

       // TODO

    }

});

dwz.pagination.js

分页组件库

<divclass="pagination" targetType="navTab"totalCount="200" numPerPage="20"pageNumShown="10" currentPage="1"></div>

开发人员只要用程序动态生成这个<div>,不用写js, 框架自动绑定处理事件。

dwz.database.js

suggest自动完成的提示框组件

lookup查找带回组件

itemDetail 主从结构组件

selectedTodo批量选择操作组件(批量删除, 批量审核…)

dwz.datepicker.js

DWZ日历控件库

dwz.combox.js

combox下拉菜单组件,支持多级联动

dwz.checkbox.js

checkbox全选、反选。(demo à 表单组件à多选框/单选框)

dwz.uitl.date.js

日期处理工具类

dwz. regional.zh.js

DWZ本地化

dwz.validate.method.js

jquery.validate.js 扩展

class:

  required        <inputtype="text" name="name" class=”required”/>

  email        <input type="text" name="name" class=”email”/>

  url              <input type="text"name="name" class=”url”/>

  date          <input type="text"name="name" class=”date”/>

  number  <input type="text" name="name" class=”number”/>

  digits      <input type="text" name="name" class=”digits”/>

  creditcard <input type="text" name="name" class=”creditcard”/>

attribute:

  equalTo:selector <input type="text" name="name"equalTo="#name"/>

  maxlength: <input type="text"name="name" maxlength="20"/>

  minlength: <input type="text"name="name" minlength="2"/>

  实现长度范围时是同时写上minlength 与 maxlength,此时的提示将是rangelength的提示。

  max: <input type="text"name="name" max="2"/>

  min: <input type="text"name="name" min="2"/>

实现值范围时是同时写上min与 max,此时提示将是range的提示。

提示内容更改在文件dwz.regional.zh.js。

参考文档 http://docs.jquery.com/Plugins/Validation

 

Javascript混淆和压缩

Javascript混淆并用gzip压缩后,可以把300K的js压缩到40K左右.

DWZ混淆和压缩方法:

1)    打开bin/gzjs.bat修改第一行路径为本地文件系统绝对路径

2)    执行批处理文件bin/gzjs.bat

Javascript混淆

DWZ混淆工具 bin/ESC.wsf

压缩级别分为5种,从0到4

Level 0 :: No compression

Level 1 :: Comment removal

Level 2 :: Whitespace removal

Level 3 :: Newline removal

Level 4 :: Variable substitution

在WINDOWS命令行下执行

cscript ESC.wsf -ow menu2.jsmenu.js将会把menu.js按照js压缩级别2来压缩(默认js压缩级别为2)为menu2.js

cscript ESC.wsf -l 3 -owmenu3.js menu.js将会把menu.js按照js压缩级别3来压缩为menu3.js

需要注意的是,js压缩级别4会把变量名修改,如果你的js中用到了全局变量或者类的话,就不能使用该压缩级别了,否则其它使用你的js的文件可能会无法正常运行。

Javascript 用gzip压缩

动态的压缩会导致服务器CPU占用率过高,现在我想到的解决辨法是通过提供静态压缩(就是将js预先通过gzip.exe压缩好)

传统的JS压缩(删除注释,删除多余空格等)提供的压缩率有时还是不尽不意,幸亏现在的浏览器都支持压缩传输(通过设置http header的Content-Encoding=gzip), 可以通过服务器的配置(如apache)为你的js提供压缩传输 .

Apache配制

在httpd.conf中加入配制,这样浏览器可以自动解压缩.gzjs

LoadModule mime_modulemodules/mod_mime.so

AddEncoding x-gzip .gzjs  .gzcss

 

DWZ如何中使用打包的js

在index.html中移除全部dwz.*.js,引入下面2个js库

<script src="bin/dwz.min.js"type="text/javascript"></script>

<script src="javascripts/dwz.regional.zh.js" type="text/javascript"></script>

 

dwz.*.js打包到dwz.min.js步骤:

1)    打开bin/gzjs.bat 修改第一行路径为本地文件系统绝对路径

2)    执行批处理文件bin/gzjs.bat

 

使用时引入以下js:

javascripts/speedup.js         【可选】js加速

javascripts/jquery-1.4.4.js    【必须】jQuery库

javascripts/jquery.cookie.js   【可选】js操作cookie, 目前用于记住用户选择的theme风格

javascripts/jquery.validate.js 【必须】表单验证

javascripts/jquery.bgiframe.js 【可选】用于IE6弹出层不能盖住select问题

xheditor/xheditor-zh-cn.min.js 【可选】xheditor在线编辑器

uploadify/scripts/swfobject.js 【可选】用于文件批量上传

uploadify/scripts/jquery.uploadify.v2.1.0.js  【可选】用于文件批量上传

 

bin/dwz.min.js 【必须】 DWZ框架js压缩包

javascripts/dwz.regional.zh.js【可选】 用于国际化


 

常见问题及解决

DWZ中如何整合第三方jQuery插件

jQuery插件一般是$(document).ready()中初始化

$(document).ready(function(){

// 文档就绪,初始化jQuery插件

});

//或者或缩写形式

$(function(){

           // 文档就绪,初始化jQuery插件

});

 

因为DWZ RIA是富客户端思路,第一次打开时加载界面到浏览器端,之后和服务器的交互是存数据交互,不占用界面相关的网络流量。

也就是说,只需要在一个完整的页面(通常是起始页,如index.aspx/index.php/index.jsp等),只有这个页面包含完整的html结构(<head><body>),<head>中引入全部css、js 。其它的页面只需要页面碎片,就是<body></body>中的部分。

因为ajax加载基本原理是:ajax加载一段html代码片段放到当前页面的某个容器中(通常是一个div)。当然也可以是xml结构、json结构,只是在插入到当前页面之前也要转化成html代码片段。如果你ajax加载一个完整的页面(就是包括<head><body>标签的),插入的当前document就有问题了,因为一个document不可能有多个<head><body>标签。

理解了富客户端思路你也就明白了为什么DWZ框架中整合第三方jQuery插件不能在<head>中通过$(document).ready()初始化。

DWZ1.5.2之后版本初始化第三方jQuery插件方式:

V1.5.2版本调整DWZ插件注册和初始化机制。方便DWZ和其它第三方jQuery插件整合,不需要修改dwz.ui.js源码,可以按照DWZ插件注册机制引入外部js。建议把第三方jQuery插件注册相关代码放到外部js文件中,方便以后DWZ版本升级。

第三方jQuery插件注册示例:

DWZ.regPlugins.push(function($p){

// $p 是作用域, jQuery选择器从$p这个父容器中选择,如果没写会引起第三方插件被重复初始化问题
$("img.lazy",  $p).lazyload({effect : "fadeIn"});

 

// $("xxxSeletor",  $p).xxxPlugin();

});

Error loading XML document:dwz.frag.xml

直接用IE打开index.html弹出一个对话框:Error loading XML document: dwz.frag.xml

原因:dwz.frag.xml是一个核心文件,需要加载才可以正常使用。IE ajax laod本地文件有限制, 是ie安全级别的问题, 不是框架的问题.

解决方法:放到apache或iis下就可以了. 如果不想安装apache或iis用firefox打开就正常了。

IIS不能用Ajax访问*.html后缀的页面

Ajax访问*.html后缀的页面在Apache很好的工作,但在IIS不行,IIS下firebug调试报错ajax 405Method Not Allowed。

Http405原因是IIS不允许ajax  post方式访问*.html后缀的页。

IIS在使用Ajax  post方式请求页面时,一定要动态网页后缀的或者用改用get方式!这是IIS的问题,不是框架bug。

也可以试试修改IIS配置,添加扩展名(.html)的脚本映射。

多个navTab页面或dialog页面ID冲突,解决方法

如果多个navTab页面或dialog页面有相同的ID,假设这个ID为:xxxId

$("#xxxId",navTab.getCurrentPanel());               //获取当前navTab中的xxxId

$("#xxxId",$.pdialog.getCurrent());              // 获取当前dialog中的xxxId

jQuery1.4.2和jquery.validate.js在IE的兼容问题

jQuery1.4.2和jquery.validate.js在IE有兼容问题,ajax表单提交在IE不能触发formonsubmit事件。

导致form提交后跳转到了一个白页面。

升级jQuery1.4.2注意事项

jQuery1.4.2对json要求非常严格key、value都要用引号抱起来,否则就无法解析。jQuery1.3.2以前版本没有这种限制。

{"statusCode":"200","message":"操作成功"}

 

$.ajax()发送ajax请求成功后调用success方法,success根据dataType来解析返回的内容httpData()。

分析jQuery1.4.2源码发现dataType=”json”的处理方式完全不一样了。1.3.2之前版本是用window.eval()来解析JSON结构,1.4.2版本添加了paseJSON()方法来解析。

估计是window.eval()存在安全漏洞,1.4.2版本进行了改进,对JSON格式也要求更严格了。

 

ECMAScript 5发布有段时间了,其中就包括了解析JSON的原生API-JSON.parse。许多浏览器已经支持了。

主流js库如JQuery,Ext,Prototype都优先使用JSON.parse,不支持该方法的浏览器则使用newFunction或eval。

为何优先使用JSON.parse,我想一个就是性能,原生的总是要快一些吧。此外JSON.parse较eval也更安全。

这里也当然不能落后了,优先使用JSON.parse,不行再用newFunction方式。最后失败了会给failure的第二个参数msg赋值为"parsejson error"

 

 

parseJSON: function( data ) {

    if ( typeof data !== "string"|| !data ) {

       return null;

    }

 

    data = jQuery.trim( data );

 

    if ( /^[\],:{}\s]*$/.test(data.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, "@")

       .replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, "]")

       .replace(/(?:^|:|,)(?:\s*\[)+/g, "")) ) {

 

       return window.JSON && window.JSON.parse ?

           window.JSON.parse( data ) :

           (new Function("return " +data))();

 

    } else {

       jQuery.error( "Invalid JSON: " + data );

    }

}

weblogic访问xml问题

weblogic访问xml文件,需要在web.xml中加入下面的声明

 <mime-mapping>

 <extension>xml</extension>

 <mime-type>text/xml</mime-type>

 </mime-mapping>

这时再次访问时weblgoic就给加上contentType了

如何自定义DWZ分页参数参数

pagerForm默认使用的当前页参数是pageNum, 每页显示条数numPerPage,查询排序字段名orderField, 升序降序orderDirection,  更改其它参数需要设置DWZ.init(pageFrag,options)的options[“pageInfo”]:

<form id="pagerForm" action="xxx" method="post">

      <input type="hidden" name="pageNum"value="1" />/><!--【必须】value=1可以写死-->

      <input type="hidden" name="numPerPage"value="20" /><!--【可选】每页显示多少条-->

      <input type="hidden" name="orderField"value="xxx" /><!--【可选】查询排序字段-->

      <input type="hidden" name="orderDirection" value="asc|desc" />/><!--【可选】升序|降序-->

 

</form>

<script type="text/javascript">

$(function(){

    DWZ.init("dwz.frag.xml",{

       loginUrl:"login.html",   // 跳到登录页面

       statusCode:{ok:200, error:300, timeout:301}, //【可选】

       pageInfo:{pageNum:"pageNum", numPerPage:"numPerPage",orderField:"orderField",orderDirection:"orderDirection"}, //【可选,这里自定义分页参数】

       debug:false,  // 调试模式 【true|false】

       callback:function(){

           initEnv();

           $("#themeList").theme({themeBase:"themes"});

       }

    });

});

</script>

 

如何关闭loading

dwz的ajax方法每次调用都会出现读取数据的loading,怎么修改可选的?我自己写了一个局部更新的ajax函数,结果loading太烦人怎么关掉好?

dwz.ui.js中注册了ajax全局事件:

    var ajaxbg = $("#background,#progressBar");

    ajaxbg.hide();

    $(document).ajaxStart(function(){

       ajaxbg.show();

    }).ajaxStop(function(){

       ajaxbg.hide();

    });

$.ajax() 有个参数global (Boolean) : (默认: true) 是否触发全局 AJAX 事件.设置为 false 将不会触发全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用于控制不同的 Ajax 事件。

DWZ局部刷新怎样做?

API调用方式:

$("#xxxId").loadUrl(url,data, callback);

html扩展链接方式:

<a href="url" target="ajax"rel="xxxId"></a>

DWZ版本升级

版本升级如果无特殊说明只要把高版本中的dwz.*.js全部覆盖、还有dwz.frag.xml和theme目录下的css就可完成升级。

如果新添加了js库,需要在index.html页面head标签中引入。

 

V1.5.3

1)       Tree组件叶子节点添加自定义图标

2)       添加栅格系统(参照Bootstrap)

3)       添加initEnvAfter 自定义事件,框架initEnv() 完成时执行

V1.5.2

1)调整DWZ插件注册和初始化机制。方便DWZ和其它第三方jQuery插件整合,不需要修改dwz.ui.js源码,可以按照DWZ插件注册机制引入外部js。建议把第三方jQuery插件注册相关代码放到外部js文件中,方便以后DWZ版本升级。

第三方jQuery插件注册示例:

DWZ.regPlugins.push(function($p){

//$p 是作用域, jQuery选择器从$p这个父容器中选择,如果没写会引起第三方插件被重复初始化问题
$("img.lazy",  $p).lazyload({ effect : "fadeIn" });

});

 

2)修复dwz export插件bug

3)添加百度地图示例

4)升级注意事项:如果修改过dwz.ui.js需要仔细比对一下

V1.5.1

jQuery更新到1.9.1,xheditor更新到1.2.2

V1.4.7

解决dwz.tree.js 那个选中父节点下单个子节点获取不到值问题

V1.4.6

解决sortDrag 排序出现滚动条的话滚动出现的部分拖动 一点就跑上面去了

解决DWZ IE10 表单验证页面兼容问题,删除index页面<meta http-equiv="X-UA-Compatible"content="IE=7" />

升级xheditor 到v1.2.1版

V1.4.5

uploadify 从2.1版本升级到v3.2版本, 调整dwz中uploadify 2种demo(自动上传方式;选择文件后再点击Upload按钮上传方式)

修正navTab, dialog组件session超时处理流程,自动关闭当前navTab或dialog

解决speedup.js(用于IE加速)IE10中报错问题

修正dwz.database.js主从结构中含有日期控件时,dateFmt格式不一致问题

修正dwz.database.js主从结构上传附件,弹出的窗口上传文件之后,带回的文件名不显示出来,原因是该控件中的items[#index#]中的#index#没有被替换,导致js找不到控件,而无从替换

V1.4.4

修复使用xheditor插件IE下兼容问题:IE下打开一个含有编辑器的页面,然后关闭,再打开不能录入问题

修复多文件上传插件uploadify的html扩展方式,java读取不到数据流问题:原因是以前没有把input="file" 的name属性填充到插件uploadify的fileDataName中

保持navTab有pagerForm的列表页面reload查询条件(比如第5页上要修改一条记录 修改完了 刷新 页数还在第五页)

 

日历控件添加动态参数 (具体细节请参考本手册:HTML扩展 -> 日历控件)

添加图表示例

V1.4.3

修复表单验证插件jquery.validate.js1.9版本, 在IE下重复提交2次问题。

V1.4.2

升级表单验证插件jquery.validate.js到最新1.9版本,解决上jUI上一版本中jQuery1.7.1和jquery.valiate1.7 在IE下兼容问题

V1.4.1

 调整suggest+lookup,见文档: HTML扩展à suggest+lookup+主从结构

添加拖动排序组件sortDrag

升级注意更新dwz.frag.xml、js、css和表单提交返回的json结构添加confirmMsg这是navTabAjaxDone中 forwardConfirm时的提示信息,具体细节可以看dwz.ajax.js源码和里面的注释

V1.3 Final

升级注意:

·      index页面中<div class="navTab-panel tabsPageContent">添加class“layoutBox”改成<div class="navTab-panel tabsPageContent layoutBox">

·      然后更新js、css、dwz.frag.xml

Changelist:

1.    修复combox联动菜单重复发送ajax请求问题s

2.    调整layoutH=“xx”的高度根据含有class=”layoutBox”的父容器div动态更新

3.    修复navTab 打开外部页面和iframe方式打开时,浏览器前进后退问题

a.    <a target="navTab"href="http://www.baidu.com">外部页面</a>

b.    <a target="navTab"href="url" external=”true”>iframe 方式打开</a>

4.    调整Lookup、suggest,添加联动效果。自定义查找带回主键lookupPk, 可选项默认为id。

5.    添加多选查找带回multLookup

V1.3 RC4

1.     修改combox代码还原onchane事件写法,不用change param分开写了,修改级联菜单。(请参考本手册“HTML扩展  à combox组件”)

2.    修改dwz.ajax.js 中ajax分页、局部刷新相关接口

3.    添加 jUI组件组合应用 局部刷新分页demo

V1.3 RC3

1.    修复当左边菜单折叠,然后再展开时,table的纵向滚动条会消失问题

2.    taskBar弹出框任务栏添加hover加亮效果

3.    添加dwzExport列表数据导出html扩展,具体介绍请参见本手册html扩展部分

<a href="doc/dwz-team.xls" target="dwzExport">导出EXCEL</a>

 

4.    简化index.html页面,以下代码片段移入dwz.frag.xml中

o   taskBar

o   resizable

o   Shadow (阴影层)

o   <div id="alertBackground"class="alertBackground"></div>

o   <div id="dialogBackground" class="dialogBackground"></div>

o   <div id='background' class='background'></div>

o   <div id='progressBar' class='progressBar'>数据加载中,请稍等...</div>

V1.3 RC2

1.    解决loadUrl插件IIS不能用Ajax访问*.htm或是*.html后缀的页面

2.    日历组件class="date"并且自定义pattern 时和验证冲突问题,pattern 改成 format

3.    session超时,弹出登录框,登录后还能保存当前操作到的状态

 

 

V1.3 RC1

1.    添加横向导航栏, 参考示例index_menu.html

2.    添加主从结构组件 , 参考示例db_widget.html和dwz.database.js

 

3.    添加suggest自动完成的提示框组件

 

4.    修复table组件当把左边栏收缩后拖动下边的滚动条,内容和题错位问题

5.    高级table扩展的拖动有BUG,单击一下就直接往前缩小了一部分

6.    修复nav Tab组件关于[页面一(外部页面)],在tab标签上右键刷新,就会出现[数据加载中,请稍等...]的loading的效果,但不会自动关掉。所有运用iframe的页面同样出现此问题的bug

V1.2 Final

1.    添加新主题风格azure

2.    添加lookup调用的dialog设置resizable和maxable

3.    green和purple主题的tree和formBar样式不正确

4.    一个页面多个combox,在加载的时有几率使两个combox变为相同问题

5.    combox不能用validation验证问题

6.    解决在form表单的<p></p>中使用如果使用combox会造成位置不正确

 

V1.2 RC1

1.    使用隐藏iframe来处理无刷新表单提交时,服务器端返回json格式和普通DWZ 普通ajax 表单提交保持一致(即validateCallbackiframeCallback服务器端返回json格式一致)。具体细节请参考“文件上传表单提交”部分

2.    新增关联对象查找带回组件lookup

3.    修改了dwz.stable.js解决了table表格组件的标题,拉动后,会和下面的记录错位问题。

4.    新增表格组件多选批量删除功能

5.    新增表格组件点击表头数据库排序功能

6.    调整table表格组件默认宽进和普通的html table保持一致。

7.    table表格组件添加TD内容超大时是否多行显示控制, nowrapTD="false" 时TD可以自动换行

<table class="table" layoutH="138" nowrapTD="false"width="100%">

8.    解决切换主题后,左边的菜单,左右拉动IE下失效问题。

9.    修复日历控件当日期格式不匹配时初始化失败问题,格式错误时默认为当前日期。

10.  解决在ie下页面有xheditor编辑器时,经过多次编辑后,文本框失效,不能输入问题。

V1.1.6 Final

DWZ中jQuery版本从1.4.2升级到1.4.4

navTab组件重复打开同一个页面时是否重新加载数据控制: navTab.openTab(tabid, url,{ title:”New Tab”, fresh:false, data:{} });

解决dwz.combox.js中的select把jquery中的select冲突问题

V1.1.6 RC3

日历控件添加自定义选择时间控制功能。

组件navTab支持打开外部连接,navTab组件自动判断如果是外部连接就用iframe方式打开。

修复tab组件和inputAlert组件冲突问题。

xhEditor升级到最新版本。

V1.1.6 RC2

解决Input alt扩展和必填字段class=”required”冲突问题

修复uploadify打开多个navTab时出现多个upload按钮

修复table组件数据量多的时候 调整这个列宽时, IE下提示“是否停止脚本运行”

checkbox全选、反选示例。(demo à 表单组件 à多选框/单选框)

Tree组件优化,增加checkbox属性checked,表示checkbox默认状态是否checked,

修改select combox组件的默认样式

V1.1.6RC1

此版本对应的dwz_thinkphp-1.0RC1,可以结合dwz_thinkphp版本去理解DWZ和服务器端的交互方式

DWZ.init() 方法添加debug状态,用于DWZ.debug()

添加jquery.uploadify文件上传HTML扩展

HTML扩展方式navTab, dialog, ajaxTodo 的url支持变量替换。例如:__URL__/edit/id/{sid_user}

Table组件修复切换navTab延时问题

添加dwz.checkbox.js用于checkbox全选、反选

添加combox下拉菜单组件(支持多级联动)

V1.1.5 Final

解决jQuery1.4.2与jquery.validate.js在IE6下兼容问题,jQuery版本升级到1.4.2

修复dialog内容无法复制问题

dialog弹出后默认居中

添加session超时控制选择,跳转到“登录页面”或弹出带屏蔽层的“登录对话框”

navTab的openTab(tabid, title, url, [data])接口添加data参数,并调换title和url位置

V1.1.5 RC3

navTab右键菜单添加“刷新标签页”

修复google浏览器中日历控件icon错位问题,和button字体错位问题

修复在弹出窗口 再弹出一个窗口是,新弹出的窗口被遮住问题

V1.1.5 RC2

修复IE6下ajaxTodo 成功后关闭当前navTab时js出错问题

添加CSS  Table:原生html + CSS实现,无js处理效果、最简单、最基本、性能最高的table。

添加国际化dwz.regional.zh.js,删除dwz.validate.zh.js

DWZ打包JS,dwz.min.js

V1.1.5 RC1

修复panel折叠效果IE下错位问题

修复DWZ日历控件IE6下被input和select覆盖问题

V1.1.5 Beta1

添加panel折叠效果

添加DWZ日历控件

V1.1.4 Final

Tree添加控制默认展开/收缩控制。

jQuery1.4.2和jquery.validate.js在IE有兼容问题,ajax表单提交在IE不能触发form onsubmit事件。导致form提交后跳转到了一个白页面,还原到jQuery1.3.2

解决v1.1.3 dialog上的分页问题。

V1.1.3

修复了一些v1.1.2版本ajax载入bug

添加了分页组件

V1.1.2

修改框架初始化方法,添加回调函数来保证,在初始化UI组件之前先载入dwz.frag.xml

DWZ.init("dwz.frag.xml", function(){

    initEnv();

    $("#themeList").theme({themeBase:"themes"});

});

 

修复IE6下alertMsg问题

当前dialog添加reload方法:$.pdialog.reload(url,params)

V1.1.1

增加当前navTab中链接ajax post扩展功能ajaxTodo

修复dialog在IE下托动,dialog中内容自动全选问题

修复tree组件折叠图标bug

修复当前navTab上分页通用方法navTabPageBreak问题

修复当前navTab上分页跳转通用方法navTabPageJump问题

修复navTab中的table HTML扩展问题

v1.1.0

增加自定义鼠标右键菜单库dwz.contextment.js

右键菜单定义在dwz.frag.xml文件中

navTab 右键菜单功能

<_PAGE_ id="navTabCM"><![CDATA[

<ulid="navTabCM">

    <li rel="closeCurrent">关闭标签页</li>

    <li rel="closeOther">关闭其它标签页</li>

    <li rel="closeAll">关闭全部标签页</li>

</ul>

]]></_PAGE_>

taskbar右键菜单功能

<_PAGE_ id="dialogCM"><![CDATA[

<ulid="dialogCM">

    <li rel="closeCurrent">关闭弹出窗口</li>

    <li rel="closeOther">关闭其它弹出窗口</li>

    <li rel="closeAll">关闭全部弹出窗口</li>

</ul>

]]></_PAGE_>

v1.0.6

增加Javascript混淆和gzip压缩

增加银灰色主题风格

修复左边活动面板滑动问题

v1.0.5

增加Dialog 默认大小设置功能.

Html标签扩展方式

<a class="button" href="demo_page1.html" target="dialog" rel="dlg_page1" title="[自定义标题]" width="800" height="480">打开窗口一</a>

 

JS调用方式

$.pdialog.open(url, dlgId, title, {width: 500, height: 300});

 

navTab浏览器前进后退按钮控制

ajax前进后退控制,DWZ navTab浏览器前进后退功能控制.

增加文件上传表单提交方式演示页面

典型页面 à文件上传表单提交示例
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号

意见反馈
返回顶部