EMP 版本说明
EMP 参考手册
前端页面组件开发手册
Reference
For Version2.2
© Copyright Yucheng Tech. 2007
第 1页/共 75页
EMP 版本说明
目录
1.
简介 ........................................................................................................................................ 7
1.1.
1.2.
1.3.
1.4.
目的 ............................................................................................................................ 7
摘要 ............................................................................................................................ 7
引用前提 .................................................................................................................... 7
参考文档 .................................................................................................................... 7
标签对象概述 ........................................................................................................................ 8
标签操作对象 ...................................................................................................................... 10
1.
2.
2.1.
2.2.
2.3.
2.4.
概述 .......................................................................................................................... 10
2.1.1. 目的 .................................................................................................................. 10
2.1.2. 实现原理 .......................................................................................................... 10
单数据标签操作对象..............................................................................................12
2.2.1. 基本原理 .......................................................................................................... 12
2.2.2. 对象的控制范围..............................................................................................13
2.2.3. 对象的基本属性和方法 ..................................................................................14
EMP 单数据标签基本属性 ............................................................................. 16
2.2.4.
emp:text 标签 .................................................................................................. 18
2.2.5.
emp:password 标签 ......................................................................................... 19
2.2.6.
2.2.7.
emp:link 标签 ...................................................................................................19
emp:multilink 标签.......................................................................................... 21
2.2.8.
emp:textarea 标签 ........................................................................................... 21
2.2.9.
2.2.10.
emp:select 标签 ............................................................................................... 22
emp:date 标签 ................................................................................................. 23
2.2.11.
emp:pop 标签 .................................................................................................. 24
2.2.12.
2.2.13.
emp:checkbox 标签 ......................................................................................... 25
emp:radio 标签 ................................................................................................ 26
2.2.14.
emp:appendPin 标签 ....................................................................................... 27
2.2.15.
2.2.16.
emp:dynPassword 标签 ................................................................................... 28
emp:textSpace 标签 .........................................................................................30
2.2.17.
emp:dateSpace 标签 ........................................................................................31
2.2.18.
列表数据标签操作对象 ..........................................................................................32
2.3.1. 列表组成 .......................................................................................................... 32
2.3.2. 基本原理 .......................................................................................................... 37
2.3.3. 对象的基本属性和方法 ..................................................................................39
2.3.4. 分页处理对象 ..................................................................................................41
EMP 列表数据标签 ..........................................................................................43
2.3.5.
分组数据标签操作对象 ..........................................................................................44
2.4.1. 基本原理 .......................................................................................................... 45
2.4.2. 对象的基本属性和方法 ..................................................................................45
2.4.3. 配置示例 .......................................................................................................... 46
© Copyright Yucheng Tech. 2007
第 2页/共 75页
EMP 版本说明
2.5.
标签操作对象的访问..............................................................................................46
数据元素对象 ...................................................................................................................... 47
3.
3.1.
3.2.
3.3.
概述 .......................................................................................................................... 47
3.1.1. 目的 .................................................................................................................. 47
3.1.2. 实现原理 .......................................................................................................... 47
3.1.3. 访问方式 .......................................................................................................... 48
Field 数据元素对象 ................................................................................................. 49
3.2.1. 保留属性和方法的名称 ..................................................................................49
IColl 数据元素对象 ..................................................................................................49
3.3.1. 保留属性和方法的名称 ..................................................................................49
3.3.2. 对象结构 .......................................................................................................... 50
KColl 数据元素对象 .................................................................................................50
3.4.1. 保留属性和方法的名称 ..................................................................................50
3.4.2. 对象结构 .......................................................................................................... 51
数据元素对象的访问..............................................................................................51
与数据无关的其它组件 ......................................................................................................53
3.4.
3.5.
4.
4.1.
4.2.
4.3.
4.4.
4.5.
4.6.
布局组件 .................................................................................................................. 53
4.1.1. 基本原理 .......................................................................................................... 53
4.1.2. 属性介绍 .......................................................................................................... 53
4.1.3. 配置示例 .......................................................................................................... 54
数据类型组件 .......................................................................................................... 54
4.2.1. 页面端的实现 ..................................................................................................55
4.2.2. 服务器端的实现..............................................................................................55
4.2.3. 配置示例 .......................................................................................................... 56
联动下拉框组件...................................................................................................... 57
4.3.1. 基本原理 .......................................................................................................... 57
4.3.2. 标签属性 .......................................................................................................... 58
4.3.3. 配置示例 .......................................................................................................... 59
4.3.4. 联动下拉框组件对象......................................................................................59
页签组件 .................................................................................................................. 60
4.4.1. 基本原理 .......................................................................................................... 61
4.4.2. 标签属性 .......................................................................................................... 62
4.4.3. 配置示例 .......................................................................................................... 63
4.4.4. 页签组件对象 ..................................................................................................63
操作按钮组件 .......................................................................................................... 64
4.5.1. 基本原理 .......................................................................................................... 64
4.5.2. 属性介绍 .......................................................................................................... 65
4.5.3. 配置示例 .......................................................................................................... 65
4.5.4. 特殊的 emp:returnButton 标签 ...................................................................... 66
emp:form 表单标签.................................................................................................67
4.6.1. 基本原理 .......................................................................................................... 67
4.6.2. 属性介绍 .......................................................................................................... 67
4.6.3. 配置示例 .......................................................................................................... 68
© Copyright Yucheng Tech. 2007
第 3页/共 75页
EMP 版本说明
4.7.
emp:page 标签 .........................................................................................................68
JS 工具类(EMPTOOLS)......................................................................................................69
5.
5.1.
5.2.
5.3.
5.4.
5.5.
5.6.
5.7.
5.8.
5.9.
5.10.
5.11.
5.12.
5.13.
5.14.
5.15.
5.16.
5.17.
5.18.
5.19.
5.20.
addEvent................................................................................................................... 69
getWindowOpener ...................................................................................................69
openWindow............................................................................................................ 69
trim........................................................................................................................... 70
getByteLength...........................................................................................................70
encodeURI ................................................................................................................ 70
setWait......................................................................................................................70
removeWait.............................................................................................................. 71
ajaxRequest...............................................................................................................71
log............................................................................................................................. 72
message.................................................................................................................... 72
addClass....................................................................................................................73
removeClass..............................................................................................................73
getScrollPos...............................................................................................................73
setInnerText.............................................................................................................. 73
getElementById........................................................................................................ 74
seeObject..................................................................................................................74
getChildrenByTagName............................................................................................ 74
getParam...................................................................................................................74
setParam...................................................................................................................75
© Copyright Yucheng Tech. 2007
第 4页/共 75页
EMP 版本说明
版权说明
本文件系 EMP 前端页面组件的相关说明文档。文档中出现的任何文字叙述、文档格式、
插图、照片、方法、过程等内容,除另有特别注明,版权均属北京宇信易诚科技有限公司所
有,受到有关产权及版权法保护。任何个人、机构未经北京宇信易诚科技有限公司的书面授
权许可,不得复制或引用本文件的任何片断,无论是通过电子形式或非电子形式。
© Copyright Yucheng Tech. 2007
第 5页/共 75页
EMP 版本说明
文档信息
文档版本编号:
起草人:
1.2
刘必强
版本记录
版本编号 版本日期 创建/修改
0.1
1.0
1.1
1.2
2008-11-22 刘必强
2008-12-25 刘必强
2009-02-09 刘必强
2009-02-13 刘必强
文档版本日期:
起草日期:
2009 年 02 月 13 日
2008 年 11 月 22 日
说明
创建提纲
完成文档
更新文档,增加对表单标签、操作按钮组件和
JS 工具类的介绍
更新文档,修改表单标签的介绍,增加 page 标
签的介绍
© Copyright Yucheng Tech. 2007
第 6页/共 75页
EMP 版本说明
1. 简介
1.1. 目的
本文档详细描述了 EMP 前端页面组件的原理、功能以及相应的扩展机制。在此基础上,
面向应用客户,对应用平台功能使用提供的一份详细说明文档。
使用说明主要满足以下三个方面的要求:
1. 系统运行环境要求和说明。
2. 系统安装及初始化应用说明。
3. 系统核心功能组件功能说明和配置说明。
1.2. 摘要
本文档主要从以下几个方面进行详细阐述:
1. 运行平台环境要求和说明
2. 系统安装及初始化说明
3. 核心组件功能及配置说明
1.3. 引用前提
N/A
1.4. 参考文档
文档名称
文件名称
版本号 备注
© Copyright Yucheng Tech. 2007
第 7页/共 75页
EMP 版本说明
1. 标签对象概述
对于 EMP 的大部分标签而言,都会在页面端生成相应的 HTML 代码并将这些 HTML
代码“注册”成一个个的 JS 对象。这样的一个好处是可以通过这些 JS 对象控制、操作相
应的 HTML 内容,实现页面上的灵活展现。并且通过对这些 JS 对象的属性、方法进行统一
的命名可以使得在页面 JS 编码时通过使用相同的接口名称(方法名称)实现类似的功能,这
样的好处是页面编程人员可以不用考虑不同浏览器的兼容性以及不同标签的特殊性,减低对
页面编程人员的要求和开发繁琐性。
页面端所生成的标签对象主要分为两种:
一种称为标签操作对象,该对象是与 EMP 标签是紧密关联的,通过该对象就可以直接
对 EMP 标签所生成的页面内容进行控制。
另外一种称为数据元素对象,该对象是参照于 EMP 服务器端的数据模型的结构进行设
计的。EMP 的数据模型主要包括三种:IndexedCollection、KeyedCollection、DataField,
相应的在页面端也设计了三种数据元素对象:IColl、KColl、Field。
数据元素对象与标签操作对象有着特定的关联关系:根据标签操作对象所要展现的服务
器端的数据模型生成页面端的数据元素对象。如标签操作对象要展现的是 aColl.bField 数据,
该数据在服务器端的数据模型为一个名称为 aColl 的 KeyedCollection 中包含着 bField 数据
域,那么在页面端则会生成一个名称为 aColl 的 KColl 对象以及一个 bField 的 Field 对象,
同时将 Field 对象作为 KColl 对象中的一个属性进行访问,即得到 aColl 对象之后就可以通
过 aColl.bField 得到 bField 对象。当然通过 bField 对象也能够访问到标签操作对象并通过
标签操作对象对页面内容进行操作。也就是说数据元素对象更符合 EMP 的数据模型结构并
且可以在页面端直接调用,同时数据元素对象没有实际的功能实现,需要通过标签操作对
象间接的对标签的相关属性进行操作。另外标签操作对象无法在页面端直接调用,需要通
过数据元素对象才能被页面端所访问
© Copyright Yucheng Tech. 2007
第 8页/共 75页