1. 功能

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

  2. 参数

    参数名 参数类型 是否必须 默认值 描述
    name java.lang.String input 元素 id 和 name 属性的值
    textName java.lang.String 'POP_控件名' 描述值的名称
    text java.lang.String 描述值,也就是显示的值
    value java.lang.String 该组件的实际值
    source java.lang.Object 将指定的数据源生成url串传递到下页
    columns java.lang.String和java.lang.String[] 指定需要传递的列数据,如果指定该属性并且为source属性为数组,必须保持该属性也为数组
    afterAction java.lang.String 弹出窗口后执行的javascript方法,一般需要setPopupReturnValue(...)后执行的方法
    enterAction java.lang.String 绑定回车事件,一般需要editable="true"时,在输入框输入值回车后触发的事件,如enterAction="alert('keydown')"
    subsys java.lang.String 跳转子系统
    disabled boolean 如果是true,则不能修改,不能修改,如果是false,则可以修改
    showButton boolean false 判断是否显示按钮
    popupPage java.lang.String 弹出框对应的page名
    listener java.lang.String 弹出框page对应的listener
    title java.lang.String 弹出框标题
    width java.lang.String 弹出框宽度,默认自适应
    height java.lang.String 弹出框高度,默认自适应
    frameName java.lang.String 弹出框要在frameName对应的iframe中弹出
    showFlush boolean false 是否显示刷新按钮,默认不显示
    showClose boolean true 是否显示关闭按钮,默认显示
    cond java.lang.String 根据区域获取页面上的数据,在弹出页面时将 cond 内的数据座位参数拼装到 url 上
    beforeAction java.lang.String 在页面弹出前执行的方法,根据该方法的返回值(true/false)判断是否执行后续的打开弹出框操作
    readOnly java.lang.String true 弹出框对应的输入框是否为 readonly 状态
  3. 注意事项

    弹出窗口组件的按钮触发事件在 button onclick 中,结合 popupPage 方法打开弹出页面 ,如:popupPage ('troop.TroopQry','qryTroops','&m1=value1&m2=value2&refresh=true&closeable=false', '目标客户群', '620', '400',’popupFlow’);最后一个参数为 Popup 组件 name(供调用 afterAction 使用)

    弹出窗口组件实际上生成了隐藏域存储值,而显示的文本框存储名称,如弹出窗口组件存储的员工工号和员工名称

  4. 代码片段

    1. HTML 写法

      <span class="e_elements">
      	<input jwcid="@Popup" readOnly="true" value="ognl:edit.custId" 
      		text="ognl:edit.custName"  
      		name="popupFlow" afterAction="afterPopupAction()" textName="testPopup1" cond="popupFlow"
      		showButton="true" popupPage="CustDemo" title="选择关联客户" 
      		beforeAction="popupBeforeAction()"
      		width="500" height="200"  showFlush="true" />
      </span> 
      
    2. 弹出页面回调方法js函数

      setPopupReturnValue(val,desc,close)
      

      val:页面提交的真实数据
      desc:页面展示的数据
      close:是否关闭弹出层

      注意:该方法应用于通过 Popup 组件弹出的页面调用

    3. 弹出本页面中 Div js 函数

      popupDiv(divid,width,title);
      

      divid:放置到弹出层的中DIV ID
      width:弹出层宽度,为整数,单位px或者使用百分比
      title:弹出层标题

      注意:该 DIV 的位置需要位于 body 节点之下,初始默认不显示,如:

      <body>
      	...
      	...
      	<div id="needpopup" style="display:none" >
      		展示内容
      	</div>
      </body>
      <script>
      	popupDiv('needpopup',300,'弹出DIV测试');
      </script>
      
  5. 图示

    这是一个弹窗
    表格 表格 表格 表格
    表格 表格 表格 表格
    表格 表格 表格 表格
    表格 表格 表格 表格
    表格 表格 表格 表格