组件 | 浏览框控件 | 备注 | ||||
功能说明 | 基于jQuery生成浏览按钮的组件,功能与【浏览按钮组件】相同,其主要特点如下: 1、常用于需要通过弹出窗口选择数据的情形; 2、统一维护按钮及其显示区样式; 3、支持快速输入匹配(联想数据)功能; 4、联想输入支持拼音首字母查找; 5、支持浏览按钮和新建按钮两种按钮并存; 6、支持为选择的内容添加链接; 7、支持自定义弹出窗口的大小; 8、支持浏览和新建后的回调机制; 9、支持数据必填验证 |
|||||
使用说明 | 1.引入如下js: <script language=javascript src=”/js/ecology8/request/e8.browser_wev8.js”></script> 2、调用如下方法: $(“#docLastModUser”).e8Browser({ name:”doclastmoduserid”, viewType:”0″, browserValue:”0″, isMustInput:”1″, browserSpanValue:””, hasInput:true, linkUrl:”#”, isSingle:true, completeUrl:”/data.jsp”, browserUrl:”/systeminfo/BrowserMain.jsp?url=/docs/docs/MutiDocBrowser.jsp”, width:”150px”, hasAdd:false, isSingle:true }); |
#docLastModUser是一个容器 | ||||
3.运行后的效果图如下: | ||||||
|
||||||
例子 | 例子:http://192.168.4.44:8080/web/webmagazine/WebMagazineEdit.jsp?_fromURL=3&id=21 | |||||
组件初始化参数 | 是否必须 | 类型 | 描述 | |||
name | 是 | string | 浏览按钮的名称,在表单中是字段的ID | |||
viewType | 是 | string | 字段类型(0:主表字段,1:明细表字段) | |||
type | 否 | string | 字段的类型,对应workflow_billfield表中的type字段 | |||
isBrowser | 否 | string | 是否是浏览框(默认是true),该属性一般不用 | |||
hasBrowser | 否 | string | 是否显示浏览按钮,默认为true true:显示 false:不显示 |
|||
browserUrl | 否 | string | 浏览按钮的URL 要携带原有参数,有两种方式: 1、在url后面直接跟上key=即可;如/systeminfo/BrowserMain.jsp?url=/hrm/resource/MultiResource.jsp?resourceids= 2、使用#id#占位符;如/systeminfo/BrowserMain.jsp?url=/hrm/resource/MultiResource.jsp?resourceids=#id#¶m=123 |
首选该属性替代browserOnClick | ||
getBrowserUrlFn | 否 | string | 动态获取browserUrl的javascript函数名,不需要括号 | |||
getBrowserUrlFnParams | 否 | string | getBrowserUrlFn的参数 | |||
browserOnClick | 否 | string | 单击浏览按钮触发的onclick事件 | |||
_callback | 否 | string | 执行完browserOnclick事件后的回调方法,该方法默认传递四个参数(event,datas,name,_callbackParams) | |||
_callbackParams | 否 | string | _callback的自定义参数 | |||
isMustInput | 否 | string | 字段是否必填(默认是0) 0:只读 1:可编辑 2:必填 |
|||
browserValue | 否 | string | 浏览按钮对应的隐藏域的默认值 | |||
browserSpanValue | 否 | string | 浏览按钮的显示值 | |||
onPropertyChange | 否 | string | 浏览按钮对应的隐藏域的触发的onpropertychange事件调用的方法 | |||
tempTitle | 否 | string | 浏览按钮的中文描述 | |||
isSingle | 否 | string | 浏览按钮是否是单选按钮 true:单选 false:多选 |
|||
linkUrl | 否 | string | 浏览按钮显示值对应的链接地址 | |||
index | 否 | string | 针对明细字段设置的,为明细的序号 | |||
hasInput | 否 | string | 是否显示搜索框 true:显示 false:不显示 |
|||
isAutoComplete | 否 | string | 是否启用自动检索,默认为true,该属性建议设置为true | |||
completeUrl | 否 | string | 如果isAutoComplete设置为true,那么该属性必填,自动提示的url地址 | /data.jsp?type= | ||
hasAdd | 否 | string | 是否显示快捷添加的按钮,默认为false true:显示 false:不显示 |
|||
addUrl | 否 | string | 添加按钮对应的链接地址 | |||
dialogWidth | 否 | String | 新建弹出窗口的宽度 | |||
dialogHeight | 否 | string | 新建弹出窗口的高度 | |||
addOnClick | 否 | string | 单击添加按钮时触发的onclick事件 | |||
_callbackForAdd | 否 | string | 执行完addOnclick事件后的回调方法,该方法默认传递三个参数(event,datas,_callbackForAddParams) | |||
_callbackForAddParams | 否 | string | _callbackForAdd的自定义参数 | |||
browserDialogWidth | 否 | String | 浏览弹出窗口的宽度 | |||
browserDialogHeight | 否 | string | 浏览弹出窗口的高度 | |||
zDialog | 否 | string | 是否使用zDialog弹出框,默认为false true:使用zDialog false:使用浏览器自带的弹出窗 |
|||
beforeDelCallback | 否 | string | 按回退键或者点击x按钮删除对象时的前置回调函数 | 会传送3个参数,被删除对象的text,被删除对象的隐藏域ID(fieldid),自定义参数 function test(text,fieldid,params) 返回true和false,如果返回false,则不会执行删除动作。 |
||
beforeDelParams | 否 | String | beforeDelCallback的自定义参数,格式为{a:’a’,b:1} | |||
afterDelCallback | 否 | string | 按回退键或者点击x按钮删除对象时的后置回调函数 | 会传送3个参数,被删除对象的text,被删除对象的隐藏域ID(fieldid),自定义参数 function test(text,fieldid,params) |
||
afterDelParams | 否 | String | afterDelCallback的自定义参数,格式为{a:’a’,b:1} | |||
needHidden | 否 | String | 是否生成隐藏域,默认为true true:生成 false:不生成 |
设置为false时,需要程序员自己生成input隐藏域。 | ||
defaultRow | 否 | string | 多选按钮显示的行数,默认为3行 | 该属性只有当isSingle=false时方有效 | ||
idKey | 否 | string | 浏览框返回值中作为ID的key值 | 如:idKey=”id” | ||
nameKey | 否 | String | 浏览框返回值中作为NAME的key值 | 如:nameKey=”name” | ||
language | 否 | String | 用户当前语言 | |||
addBtnID | 否 | String | 添加按钮的ID | |||
addBtnLabel | 否 | String | 添加按钮显示的文字,默认为“新建” | |||
browserBtnID | 否 | String | 浏览按钮的ID | |||
display | 否 | string | 浏览按钮默认状态,设置为none则默认隐藏 | |||
idSplitFlag | 否 | string | browserValue的分隔符,默认为, | |||
nameSplitFlag | 否 | string | browserSpanValue的分隔符,默认为, | |||
browBtnDisabled | 否 | string | 默认为空字符串,如果设置为none,则禁用隐藏浏览按钮,其他值则禁用浏览按钮 | |||
addBtnDisabled | 否 | string | 默认为空字符串,如果设置为none,则禁用隐藏新建按钮,其他值则禁用新建按钮 | |||
addBtnClass | 否 | string | 新建按钮的class | |||
parentContainer | 否 | string | 浏览框的父容器 | |||
对浏览框组件提供了以下1个功能函数 | ||||||
方法1 | 返回类型 | 描述 | ||||
__browserNamespace__._writeBackData | 无 | 用于更新指定浏览框的值 | ||||
方法参数 | 是否必须 | 类型 | 描述 | |||
fieldid | 是 | string | 浏览框隐藏域的ID | |||
isMustInput | 是 | string | 字段是否必填 0:只读 1:可编辑 2:必填 |
|||
data | 是 | json | json格式数据,格式如下: data = {id:”1,2″,name:”<a href=’#1′>张三</a>,<a href=’javascript:openhrm(2)’>李四</a>”} |
|||
_options | 否 | json | json格式数据,格式如下: options = {hasInput:false,replace:false,isSingle:true,isedit:false} 说明: 1、hasInput:是否有联想输入框,默认为false; 2、replace:是否替换原值,默认为false; 3、isSingle:是否是单选,默认值为true; 4、isedit:当前操作是否是更新其中某个字段,当isSingle=false时生效; 5、e8os:当前fieldid查找范围对象,默认为null |
|||
关于 浏览框组件 应用强调几点: | ||||||
1、尽量使用组件提供的弹出框行为,即尽量使用browserUrl和_callback属性完成功能,尽量不使用browserOnClick属性,以为后期维护提供便利。当组件提供的功能实在无法完成时,才考虑使用browserOnClick属性定制自己的弹出框; | ||||||
2、关于completeUrl,该参数固定为/data.jsp,后面跟浏览框类型的参数,如联想部门:completeUrl=”/data.jsp?type=4″;data.jsp中提供了各种类型浏览框数据的数据源。 |
转载请注明:赫非域 » ecology开发之浏览按钮组件(JS版本)