数据列表组件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 |
对应的条件字段中的运算符,必须是有几个条件字段,就对应几个运算符。具体的运算符号如下: |
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,以金额为排序。则参数设置如下: 如过页面上有文本框text1、text2为条件,则请求为: |
|
带*标记的为必选参数,不需要的参数则不要列出,该配置参数也适用于弹出式下拉列表的配置文件(dropdownlists.xml)。 |