1. 功能介绍

    实现弹出一个窗口,一般弹出窗口为一个模拟的弹出方式,并不是浏览器的模态窗口,弹出窗口要结合popupPage才能完整的实现一个弹出功能,一般用于弹出一个查询窗口,然后选择一个查询结果返回给原页面。

  2. 参数说明

    参数名 参数类型 是否必须 默认值 描述
    text java.lang.String类型     描述值,也就是显示的值
    textName java.lang.String   POP_控件名 描述值的名称
    source Object     将指定的数据源生成url串传递到下页
    columns java.lang.String和java.lang.String[]     指定需要传递的列数据,如果指定该属性并且为source属性为数组,必须保持该属性也为数组
    value java.lang.String     该组件的实际值
    action java.lang.String     响应的js事件,这个事件一般为popupPage或popupDialog,格式类似:popupDialog('troop.TroopQry', 'qryTroops', '¶m1=value1¶m2=value2&refresh=true&closeable=false', '目标客户群', '620', '400');" 打开一个页面,在popupPage或popupDialog的params参数中传递refresh=true,则在每次打开弹出窗口的时候都会进行刷新,传递closeable=false,则打开的弹出窗口右上角不会有关闭按钮
    afterAction java.lang.String     弹出窗口后执行的javascript方法,一般需要setReturnValue(...)后执行的方法
    subsys java.lang.String     跳转子系统
    readOnly boolean     如果是true,则为只读,不能修改,如果是false,则可以修改
    disabled boolean     如果是true,则不能修改,不能修改,如果是false,则可以修改
    fieldName java.lang.String     自定义控件名,若设置了该参数,jwcid=name@..的名称不生效,适合在foreach自定义名称或重名组件使用
    skin java.lang.String     风格定义,默认通过统一配置风格
    editable boolean     是否可编辑,默认控件的显示框是只读的,虽然是可编辑,但该组件还是会有隐藏框和显示框
    enterAction java.lang.String     绑定回车事件,一般需要editable="true"时,在输入框输入值回车后触发的事件,如enterAction="alert('keydown')"
    showImg boolean   true 是否加载图标
    holdAction boolean   false 是否保留图标的动作,通过点击输入框触发
  3. 注意事项

    1. 弹出窗口组件的按钮触发事件名为action,而不是onclick,并结合popupPage方法打开弹出页面
    2. 弹出窗口组件实际上生成了隐藏域存储值,而显示的文本框存储名称,如弹出窗口组件存储的员工工号和员工名称
  4. 代码片段

    1. HTML写法

      <input
      	type="text"
      	jwcid="TROOP_ID@wade:PopupField" 
      	value="ognl:info.TROOP_ID" 
      	text="ognl:info.TROOP_NAME" 
      	action="popupDialog('troop.TroopQry', 'qryTroops', '&listbox_height=150px', '目标客户群', '620', '400');"  
      	desc="目标客户群"
      />