ecology开发之浏览按钮组件(JS版本)-赫非域

组件

浏览框控件

备注

功能说明

基于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#&param=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版本)

与本文相关的文章