自定义对话框帮助文档

自定义对话框描述

在开发过程中,我们经常需要打开一个对话框来展示某些特定数据,通常是一些要展示一些表或视图的列表或树形数据,然后用户选择后数据后会和前端有一个交互行为。
例子:

特殊属性说明:

数据来源:通常使用的是默认的数据库,但也支持调用远程接口服务来获取列表
数据源(在来源为数据库时):可以选择其他数据源来读取不同数据库的数据(表或者视图),大大增加了开发的灵活性

字段的配置

刚才我们选择了要操作的表(视图),接下来需要配置以下字段信息

  • 显示字段 :对话框界面展示哪些字段
  • 条件字段:配置对话框数据可搜索字段,支持like 等各种过滤条件,支持动态传入参数过滤
  • 返回 字段:配置对话框确认后返回的 JSON 格式,可以重新定义返回字段 key,如数据库中user_id_ 返回值重新定义为 userId
  • 排序 : 设置对话框展示数据的排序规则

如图:

下面用具体的示例图来描述 【显示字段】,【条件字段】,【返回字段】,【排序字段】的含义:

在页面中调用生成好的对话框

js模式(CustUtil.openCustDialog)

/**
* @key 自定义对话框的别名
* @callback 回调函数
* @param 调用动态参数
* @dialogSetting 强行修改key对话框的参数,用这个json数据中有的字段覆盖原有对话框的配置
* @initData 初始化回显的数据
* @closeDialog 确认后是否关闭对话框
*/
CustUtil.openCustDialog(key,param,callBack,initData,dialogSetting,closeDialog);

//例子
CustUtil.openCustDialog("userSelector",function(data,innerWindow){
console.info(data);
$.Dialog.close(innerWindow);
});

angularjs 指令模式(abCustDialog)

自定义对话框指令
指令参数
ab-cust-dialog=对话框key
value-对话框的返回数据中的某个字段key:绑定到某个scope值中
ng-model:如果有这个值(必须是数组),则会返回值拼装成json然后push到ng-model中,对于ngModel只增不减

例子:
<a class="btn btn-sm btn-primary fa-search" href="javascript:void(0)" ab-cust-dialog="busObjectSelect" value-key="data.boKey" value-name="data.boName">选择</a>