Dwz手册的补充说明和常见问题

1、我如何在项目中使用dwz?

手册中有如下说明:

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

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

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

也就是说,只需要在一个页面(通常是起始页,如index.aspx/index.php)包含框架,这里的框架是指demo中index.html页面的所有元素(<div class=”page”可自定义),完整的html结构。其它的页面只需要页面碎片,就是<body></body>中的部分。

2、怎样初始化dwz?

Dwz是通过init函数初始化,index.html的初始化函数如下:

DWZ.init("dwz.frag.xml", {
//        loginUrl:"loginsub.html", loginTitle:"登录",    // 弹出登录对话框
        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"});
        }
    });

Dwz.init(pathToDwz_frag_xml, options);

pathToDwz_frag_xml: js方式能访问到的dwz.frag.xml,一定要保证通过这个地址能访问到dwz.frag.xml文件,最好用serverPath+dwz.frag.xml的绝对路径方式。

Options是一个对象方式的参数:

loginUrl:当ajax 的json返回timeout的时候会跳转到此页面

statusCode:自定义的json错误代码,如果不指定将使用图片所示的默认规则。

pageInfo:这里可以为pagerForm指定别名,比如pageNum:”currentPage”。

Callback:指定初始化完成后的回调函数。有人问如何在打开dwz的时候在我的主页加载另一个页面或者打开一个navTab,就可以在callback里使用navTab.open(“main”), $.pdialog.open等等。

3、我如何解析json数据来重绘表格/页面?

很多人不明白dwz的工作方式,认为dwz的navTab的页面看起来是ajax方式解析的,那就要从服务器传回json再手动解析。Dwz事实上就是这样工作的,只是他传回的不是一部分数据,而是整个页面,然后通过loadUrl加载到navTab上,这个过程对使用者是透明的,也即你不需要关心页面的数据处理,以前怎么写的页面,现在还是怎么写页面。Dwz会将普通请求转换为ajax方式(前提是正确使用dwz提供的接口)。

4、如果不是传输数据,dwz的json是用于哪里?

Dwz的服务器端响应上提到一个服务器端响应json,很多初学者问这个json如何传递数据,用于自己拼接页面等。如第3点所说,dwz的页面是不需要手动处理ajax的,这个json结构是对打开navTab,dialog, ajax表单提交、ajax post链接(ajaxTodo)状态的响应,而不涉及具体的页面数据。

5、提交表单或者ajax post链接后,如何刷新本navTab?

一定要记住在返回的json中加上要刷新的navTabId。

6、如何在ajax连接扩展中使用回调函数?

手册上没有写,其实从1.2RC1开始,ajax link就有了callback属性,用于指定回调函数,如<a target=”ajaxTodo” callback=”MyOwnFunction”。

7、如何使用table和css table的排序功能?

Table的排序功能是手册中没有提到的,其实dwz的排序功能相当强大,这里我简单介绍一下流程:

1、      给要排序的表格<table中加上asc=”asc” desc=”desc”,指定排序别名。

2、      给要排序的表格表头th加上orderField=”fieldName”属性,这样点击该表头才能出发提交事件。Th的class=”asc”/class=”desc”会分别显示向上和向下的箭头,这个不是只显示这么简单,往下看。

3、      在pageForm加上orderField和orderDirection,点击排序后提交的依然是pagerForm,orderField会绑定点击的th的orderField,而orderDirection则会反向绑定th的class,这是dwz智能的地方,也就是你不用手动记住状态来反向(感谢细心的作者),class=”asc”就会提交orderDirection = desc。注意每次要将orderDirection绑定回th的class。

8、如何使用table和css table的分页功能?

分页功能是大家用得比较多,也是不容易理解的一点。这里我凭着自己的理解给初学者讲讲。

手册上讲得很清楚,dwz不是客户端分页,而是服务器端分页,结合本文第3点可以知道dwz的分页就是每次将分页数据提交回后台,后台生成分页数据显示到页面上。需要注意的是以下几点:

1、 分页只需要pagerForm与pagination两个dwz组件,点击分页提交的是pagerForm。

2、 pagerForm用于带查询的分页数据的缓存,说缓存是因为这里的参数都需要自己手动从后台读取绑定(pageNum除外)。

3、 Pagination可以理解为一个页码生成器,他需要totalCount="200" numPerPage="20" pageNumShown="10" currentPage="1"几个参数来显示,每次后台需要绑定这几个参数,dwz不会帮你做什么事情,也就是你想他显示第几页就是第几页。

4、 点击分页,dwz将pagination的currentPage绑定到pagerForm的pagerNum,然后提交pagerForm到后台。

5、 初学者可以做这件事情来帮助理解:页面只放pagerForm和一个div和pagination,div每次显示当前的pageNum和pagination,点击分页来好好体验以下这个过程,这对第三点的理解也有帮助。

9、如何使用输入表单客户端验证?

客户端表单验证也是手册上的js库介绍中的dwz.regional.zh.js一节有介绍。结合demo中的demo_page4.html,简单明了。

10、如何使用combox的ajax联动?

手册上提及的联动方式,稍微扩展一下就可以达到ajax联动的目的。在select的change时间中,根据当前选择请求下一级的数据就可以了。注意要使用同步ajax方式。

11、如何做局部刷新?

1.3版中已经具有局部刷新功能,手册解释如下:

DWZ局部刷新怎样做?
API调用方式:

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

html扩展链接方式:

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

1.2版可用loadUrl方式。

12、如何去掉dwz调用ajax方法出现的等待图片

这是作者给出的解决方式:

dwz.ui.js

var ajaxbg = $("#background,#progressBar");
ajaxbg.hide();
$(document).ajaxStart(function(){
ajaxbg.show();
}).ajaxStop(function(){
ajaxbg.hide();
});

也可以把自己的$.ajax的globle设置为false来屏蔽ajaxStart方法。

13、最后谈谈我的看法

Dwz作为一个开源的ajax前端框架,为广大的web开发者提供了极大的方便,这点对初学者可能还没有这么深刻,不过一些老程序员可是感动得一塌糊涂。可以看出,这个框架倾注了作者极大的心血,而大家的热情就是对这种奉献精神的最好回报。本人接触dwz不过区区1个月,但是一直坚持和大家一起讨论问题,就是希望有越来越多的人能够使用dwz,这样才能使其具有长久的生命力。

对于web开发老手来说,dwz很容易上手,对于新手,我想提几条建议:

1、 先要有基础的web知识,手上常备js手册和dwz手册。

2、 遇到问题先试着从手册和demo里寻找解决办法,尽量不要问手册中已经存在的问题,相信没有人会喜欢一遍一遍回答诸如navTab是什么,navTabId是什么之类的问题。

3、 相信dwz能够用于项目,现在已经有人成功了。所以放手去做吧。

4、 尽量使用最新版本,作为一个开源项目,dwz更新是平凡的,通过这种更新来消除bug,同时引入新的特性。所以请升级你的版本到最新稳定版本或RC版本。

坚持下去,你就会成功。

转自官方文档。

时间: 2024-11-10 12:17:34

Dwz手册的补充说明和常见问题的相关文章

云桌面用户常见问题手册

云桌面用户常见问题手册 目录 云桌面用户常见问题手册... 1 1       登陆方式... 3 1.1        浏览器要求... 3 1.2        云桌面登陆... 3 1.2.1         外网登录... 3 1.2.2         内网登录... 4 2       Windows系统访问云桌面... 5 2.1        准备工作(外网)... 5 2.1.1         安装Windows平台客户端(外网)... 6 2.1.2         安装W

OD调试程序常用断点大全

常用断点 拦截窗口: bp CreateWindow 创建窗口 bp CreateWindowEx(A) 创建窗口 bp ShowWindow 显示窗口 bp UpdateWindow 更新窗口 bp GetWindowText(A) 获取窗口文本 拦截消息框: bp MessageBox(A) 创建消息框 bp MessageBoxExA 创建消息框 bp MessageBoxIndirect(A) 创建定制消息框 bp IsDialogMessageW 拦截警告声: bp MessageBe

Ember.js入门教程、博文汇总

第一章 对象模型 Ember.js 入门指南——类的定义.初始化.继承 Ember.js 入门指南——类的扩展(reopen) Ember.js 入门指南——计算属性(compute properties) Ember.js 入门指南——观察者(observer) Ember.js 入门指南——绑定(bingding) Ember.js 入门指南——枚举(enumerables) Ember.js 入门指南之七第一章对象模型小结 第二章 模板 Ember.js 入门指南——handlebars基

sigaction 函数

本文主要参考<unix环境高级编程> sigaction函数的功能是检查或修改与指定信号相关联的处理动作(可同时两种操作). int sigaction(int signo,const struct sigaction *restrict act,               struct sigaction *restrict oact); 结构sigaction定义如下: struct sigaction{  void (*sa_handler)(int);  sigset_t sa_ma

给你一个清晰的C++了解

在31年前(1979年),一名刚获得博士学位的研究员,为了开发一个软件项目发明了一门新编程语言,该研究员名为Bjarne Stroustrup,该门语言则命名为——C with classes,四年后改称为C++.C++是一门通用编程语言,支持多种编程范式,包括过程式.面向对象(object-oriented programming, OP).泛型(generic programming, GP),后来为泛型而设计的模版,被发现及证明是图灵完备的,因此使C++亦可支持模版元编程范式(templa

Android常见面试题(一)

总结了一些常见的Android面试题,内容会随着不断学习陆续增加.答案有误地方希望大家可以指正 ,同时希望大家一起补充总结更多常见问题,谢谢^_^ 1. 简述Activity的生命周期 2. 请简单说下对广播接收者有哪些了解 3. view如何刷新?简述什么是双缓冲? 4.AIDL的全称是什么?如何工作?能处理哪些类型的数据? 5.java中如何引用本地语言 6.谈谈Android的IPC(进程间通信)机制 7.NDK 是什么 8.如何将SQLite数据库(xxx.db文件)与apk文件一起发布

mysql5.6错误代码

版本5.6  MySQL 5.6参考手册  /  错误,错误代码和常见问题  /服务器错误代码和消息 B.3服务器错误代码和消息 当服务器返回错误时,MySQL程序可以访问多种类型的错误信息.例如, mysql客户端程序使用以下格式显示错误: shell> SELECT * FROM no_such_table; ERROR 1146 (42S02): Table 'test.no_such_table' doesn't exist 显示的信息包含三种信息: 数字错误代码(1146).这个数字是

汇编命令及OD常用命令及断点设置

汇编32位CPU所含有的寄存器有: 4个数据寄存器(EAX.EBX.ECX和EDX)对低16位数据的存取,不会影响高16位的数据.这些低16位寄存器分别命名为:AX.BX.CX和DX,它和先前的CPU中的寄存器相一致.4个16位寄存器又可分割成8个独立的8位寄存器(AX:AH-AL.BX:BH-BL.CX:CH-CL.DX:DH-DL),每个寄存器都有自己的名称,可独立存取. 寄存器EAX通常称为累加器(Accumulator)     用累加器进行的操作可能需要更少时间.可用于乘. 除.输入/

阿里巴巴Java开发手册———个人追加的见解和补充(一)

先上干货,<阿里巴巴Java开发手册>的下载地址 https://yq.aliyun.com/articles/69327?spm=5176.100239.blogcont69327.158.xUUgiz 下面分几个部分对这个手册进行说明,都是个人的见解,本人技术一般,如果有错误或者不妥,请评论指出,虚心接受,提前感谢了. 建议边看手册,边食用以下说明,效果比较好. 前言 首先当我第一次看见这个的手册的时候或许和和你们是一样激动的,因为在java行业内我还没有看见有中文的规范,也可能是我读书少