DWZ富客户端框架使用手册.docx

DWZ富客户端框架使用手册.docx

《DWZ富客户端框架使用手册.docx》由会员分享，可在线阅读，更多相关《DWZ富客户端框架使用手册.docx（53页珍藏版）》请在冰豆网上搜索。

DWZ富客户端框架使用手册

DWZ富客户端框架使用手册

目录

概述...5

设计思路...5

学习DWZ的建议...5

DWZ区别于其它JS框架，最大的优点...5

版权声明...6

DWZ团队介绍...6

HTML扩展...7

Ajax链接扩展...7

当前navTab中链接ajaxpost扩展...7

dialog链接扩展...7

navTab链接扩展...8

Tab组件扩展...9

Accordion组件...9

容器高度自适应...9

CSSTable.10

Table扩展...10

在线编辑器...11

分页组件...11

ajaxTodo扩展...12

dwzExport列表数据导出...12

Inputalt扩展...12

Tree扩展...13

Panel扩展...13

日历控件...13

url变量替换...14

checkbox全选、反选...15

uploadify多文件上传...16

combox组件...17

suggest+lookup+主从结构...17

查找带回...18

主从结构...18

Ajax表单...19

表单查询...19

普通Ajax表单提交...21

服务器端响应...21

文件上传表单提交...23

服务器端响应...23

Java服务器端表单处理示例...23

DWZjs库介绍...25

DWZ框架初始化...25

dwz.core.js.25

dwz.ui.js.25

dwz.ajax.js.25

dwz.alertMsg.js.25

dwz.jDialog.js.25

dwz.accordion.js.25

dwz.barDrag.js.25

dwz.navTab.js.26

dwz.scrollCenter.js.26

dwz.stable.js.26

dwz.cssTable.js.26

dwz.tree.js.26

dwz.theme.js.26

dwz.validate.method.js.26

dwz.validate.zh.js.26

dwz.contextmenu.js.26

dwz.pagination.js.27

dwz.database.js.27

dwz.datepicker.js.27

box.js.27

dwz.checkbox.js.27

dwz.uitl.date.js.27

dwz.regional.zh.js.27

dwz.validate.method.js.27

Javascript混淆和压缩...28

Javascript混淆...28

Javascript用gzip压缩...29

DWZ如何中使用打包的js.29

常见问题及解决...30

ErrorloadingXMLdocument:

dwz.frag.xml30

IIS不能用Ajax访问*.htm或是*.html后缀的页面...30

多个navTab页面或dialog页面ID冲突，解决方法...30

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

升级jQuery1.4.2注意事项...30

weblogic访问xml问题...31

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

如何关闭loading.31

DWZ局部刷新怎样做?

.32

DWZ版本升级...32

版本命名规则...32

V1.3Final32

V1.3RC4.33

V1.3RC3.33

V1.3RC2.33

V1.3RC1.34

V1.2Final35

V1.2RC1.35

V1.1.6Final36

V1.1.6RC3.36

V1.1.6RC2.36

V1.1.6RC1.36

V1.1.5Final36

V1.1.5RC3.37

V1.1.5RC2.37

V1.1.5RC1.37

V1.1.5Beta1.37

V1.1.4Final37

V1.1.3.37

V1.1.2.37

V1.1.1.38

v1.1.0.38

v1.0.6.38

v1.0.5.38

附录...40

附录一Firebug介绍...40

补充说明和常见问题（xiaosuiba）.41

概述

DWZ富客户端框架（jQueryRIAframework）,是中国人自己开发的基于jQuery实现的AjaxRIA开源框架.

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开发水平.

在线演示地址

在线文档

GoogleCode下载:

设计思路

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

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

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

学习DWZ的建议

刚接触DWZ的人可能感觉DWZ文档太少、入门困难，原因都是没有掌握正确的学方法。

建议按下面的步骤来学习DWZ框架：

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

∙看demo每个组件演示效果和代码（留意组件html结构）。

∙建议安装firebug，用firebug看html结构、CSS和调试JS都非常方便。

见附录一firebug介绍。

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

∙可以从googlecode下载dwz_thinkphp版本，结合php后台去理解DWZ和服务器端的交互方式

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

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

∙CSS和js代码彻底分离，修改样式方便

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

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

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

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

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

版权声明

∙DWZ框架的源代码完全开放，在ApacheLicense2.0许可下,可免费应用于个人或商业目的。

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

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

DWZ团队介绍

DWZ研发组开发人员目前是3人（兼职）

杜权从事UI设计工作，有10年以上UI设计经验。

做过至少1500个网站的UI设计。

吴平主要做Javaweb开发，兼ajax开发。

一直从事电子商务、企业建站平台开发工作。

张慧华主要做Javaweb开发，兼ajax开发。

以前也是电子商务、企业建站平台开发工作。

从2009年4月开始从事建筑能效评估IT解决方案。

以前我们做的大部份java项目都用了Ajax，项目开发过程中经常自己做一些UI组件和界面效果。

我们对RIA非常感兴趣，业余时间就做了DWZ富客户端框架。

DWZ框架中的UI组件都是从我们做过的大量web项目中总结出来的，都是一些非常实用的UI组件。

联系方式

杜权（UI设计）msn:

duqn@QQ:

8560685

吴平（Ajax开发）msn:

wupinggone@QQ:

465046815

张慧华（Ajax开发）msn:

zhanghuihua@QQ:

350863780

官方微博（欢迎加入）

jQuery.DWZ-UI-1群（满员）107983317

jQuery.DWZ-UI-2群（满员）69611933

jQuery.DWZ-UI-3群（满员）20866231

jQuery.DWZ-UI-4群（满员）369203

HTML扩展

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

Ajax链接扩展

示例:

提示窗口

当前navTab中链接ajaxpost扩展

method=remove"target="ajaxTodo">删除

或

method=remove"target="ajaxTodo"title="确定要删除吗?

">删除

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

$（"a[target=ajaxTodo]",$p）.each（function（）{

$（this）.click（function（event）{

var$this=$（this）;

vartitle=$this.attr（"title"）;

if（title）{

alertMsg.confirm（title,{

okCall:

function（）{

ajaxTodo（$this.attr（"href"））;

}

}）;

}else{

ajaxTodo（$this.attr（"href"））;

}

event.preventDefault（）;

}）;

}）;

dialog链接扩展

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

Html标签扩展方式示例:

弹出窗口

或

打开窗口一

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

dialog是否可最大化，

minable:

dialog是否可最小化，

mixable:

dialog是否可最大化

resizable:

dialog是否可变大小

drawable:

dialog是否可拖动

width:

dialog打开时的默认宽度

height:

dialog打开时默认的高度

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

fresh:

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

close:

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

param:

close监听函数的参数列表，以json格式表示，例{msg:

’message’}

关闭窗口：

在弹出窗口页面内放置即可。

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,dlid）刷新dlid指定的dialog，url：

刷新时可重新指定加载数据的url,data：

为加载数据时所需的参数。

navTab链接扩展

示例:

默认页面

自定义页面

iframe方式打开

target=navTab:

自动关联调用navTab组件

rel:

为navtab的ID值，后续可以用来重载该页面时使用，如当前页新增或删除数据可以通过该ID进行通知JS重载。

注意rel的值区分大小写.

fresh:

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

external:

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

Js调用

navTab.openTab（tabid,url,{title:

”NewTab”,fresh:

false,data:

{}}）;

其中data:

{}json格式的数据

Tab组件扩展

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

标题1

• 标题2