数据列表组件dbgrids.xml配置说明

数据列表组件dbgrids.xml配置说明

参数 使用说明
grid-name* 标识dbgrid,其为唯一,大小写敏感。调用时以此为参数
grid-table* 列表中数据的来源。如果有多个表,以逗号隔开。如table1 tb1,table2 tb2  其中tb1为table1的别名,tb2为table2的别名。
grid-cols* 列表的数据项。字段以逗号隔开。 如果字段来自不同的表,则表示如下:tb1.col1,tb2.col2
grid-label* 列表的标题,如果没有,则以字段名作为标题。标题以逗号隔开。如果不显示出,可在标题后加$h,如 列表中的“个人序号”不显示,则表示为:个人序号$h
如果字段值为日期型:
   如果字段 “notice_date”显示格式为yyyy-mm-dd,列表标题为“通知日期”,则其grid-label 为: 委托日期$d1;如果字段“modidy_time”显示格式为yyyy-mm-dd hh:mm:ss,列表标题为“修改时间”,则其grid-label 为:修改时间$d2。
如果字段值为数字型:
   如果字段“expense”显示格式为"#,###.##",列表标题为“费用金额”,其grid-label 为:费用金额$n2;如果字段“expense”值显示格式为"#,###.###",列表标题为“费用金额”,其grid-label 为:费用金额$n3,以此类推。
grid-relation 如果列表来自两个表,则此参数表示两个表之间的关系,多个条件以and 或 or 连接,如tb1.consign_no=tb2.consign_no and tb1.col1=tb2.col2
grid-condCols 列表中所要求的条件字段,如果字段类型为数字型的,则在字段后增加“$n";如果字段类型为日期类型,则在字段后增加"$d"
grid-param 每个字段对应的请求参数名,如果条件涉及两个参数(between 参数1 and 参数2),则表示如下:参数1+参数2。
grid-operation

对应的条件字段中的运算符,必须是有几个条件字段,就对应几个运算符。具体的运算符号如下:
1:=
2:!=
3:>
4:>=
5:< 
6:<=
7 :between and
8 :'*%'
9 :'%*'
10 :'%*%'

grid-where 列表的初始条件,如expense=1000,或person_no=@person_no,其中@person_no表示person_no是由页面上传递过来的参数名
grid-queryType

查询的连接逻辑,只能为'and' 或'or';如果没有此项,系统默认为'and'

grid-orderBy 列表的初始排序条件,例以金额降序排序,则表示为 expense desc,升序排序则表示为expense asc,多个字段以逗号隔开。
grid-groupBy 列表的分组条件。
grid-test 配合grid-color使用,指明需要加亮显示的字段名称
grid-color 突出显示符合特定条件的某一行或几行数据,格式为value1,value2=color1,color2结合grid-test,如果grid-test指定的字段的值=value1,则该行数据的显示颜色为color1
grid-rowsPerPage 分页显示,每页的记录数(行数)
grid-type 列表的类型:0-普通列表(默认类型); 1-带有复选框的列表 ;2-带有单选框的列表
grid-handler* 处理列表中的”单击“、”双击“事件的个性化函数集。其中处理”单击“事件的函数必须为handleClick(),处理”双击“事件的函数必须为handleDblClick().

例:列表中标题为”字段1“、”字段2“、”字段3“、”字段4“,其相应的信息类型为“隐藏字段”、“#,###.##”、“yyyy-mm-dd”、“yyyy-mm-dd hh:mm:ss”,列表来源于表tab1,tab2,表tab1与表tab2的关系为tab1.col1=tab2.col1,以金额为排序。则参数设置如下: 

<grid-name>DemoList</grid-name> 
<grid-table>tab1 t1,tab2 t2</grid-table> 
<grid-label>字段1$h,字段2$n2,字段3$d1,字段4$d2</grid-label>
<grid-cols>t1.col1,t1.col2,tb2.col3 ,tb2.col4</grid-cols>
<grid-relation>t1.col1=t2.col1</grid-relation> 
<grid-condCols>t1.col2,t2.col3</grid-condCols>
<grid-param>lparam1,lparam2</grid-param>
<grid-operation>1,3</grid-operation>
<grid-orderBy>t1.col2</grid-orderBy>
<grid-handler>/hr/baseinfo/eventHandler.js</grid-handler>

如过页面上有文本框text1、text2为条件,则请求为:
window.navigate("demo.list?dbgrid=DemoList&lparam1="+text1.value+"&lparam2="+text2.value);

*标记的为必选参数,不需要的参数则不要列出,该配置参数也适用于弹出式下拉列表的配置文件(dropdownlists.xml)。

posted on 2012-03-10 23:30  _安静  阅读(445)  评论(0编辑  收藏  举报

导航