Skip to content

弹窗

弹窗控件用于打开子页面进行选择或数据录入,支持页面传参、自动选择等功能。

属性

sg-title

  • 说明:弹窗标题
  • 类型string

示例

json
"sg-title":"这是标题"

sg-width

  • 说明:窗口宽度(支持 px 和百分比)
  • 类型string

示例

json
"sg-width":"800px"

sg-height

  • 说明:窗口高度(支持 px 和百分比)
  • 类型string

示例

json
"sg-height":"480px"

sg-top

  • 说明:将弹框页面置顶
  • 类型boolean
  • 默认值false

可选值

说明
true开启
false关闭

示例

json
"sg-top": true

sg-hide

  • 说明:为 true 时窗口隐藏,需要调用显示方法 showWin() 才能显示
  • 类型boolean
  • 默认值false

可选值

说明
true隐藏
false不隐藏

示例

json
"sg-hide":true

sg-caption

  • 说明:控件前面的文字
  • 类型string

示例

json
"sg-caption":"请选择:"

sg-captionclass

  • 说明:控件前面的文字的样式,w1-w7 文字宽度 1-7 个字符,more 省略掉超过的字符(写法:w5 more)
  • 类型string

示例

json
"sg-captionclass":"w5"

sg-text

  • 说明:默认显示的文字
  • 类型string

示例

json
"sg-text":"默认文字"

sg-require

  • 说明:必填项
  • 类型boolean
  • 默认值false

可选值

说明
true
false

示例

json
"sg-require":true

sg-clear

  • 说明:弹窗清除按钮(true 显示,false 或不传不显示)
  • 类型boolean
  • 默认值false

可选值

说明
true显示
false不显示

示例

json
"sg-clear":true

sg-url

  • 说明:弹窗控件的页面 URL
  • 类型string

示例

json
"sg-url":"https://www.grn.cn/"

sg-pageid

  • 说明:弹窗控件的页面 id
  • 类型string

示例

json
"sg-pageid":"10"

sg-pkey

  • 说明:启用输入框,并且在弹窗时传参给页面(按回车键可以自动弹窗),如果放空,则关闭输入框和输入完回车自动弹窗功能
  • 类型string

示例

json
"sg-pkey":"user"

sg-pval

  • 说明:弹窗后把值带过去的参数,子页面可以用 getQueryVariable("id") 来获取。例如:pval 设置成 id,控件的值是 123,弹窗后带 id=123 过去
  • 类型string

示例

json
"sg-pval":"user_id"

sg-opencheck

  • 说明:【方法】弹窗打开前检查回调
  • 类型string

示例

json
"sg-opencheck":"opencheck_func"

sg-change

  • 说明:【方法】弹窗内容改变触发事件
  • 类型string

示例

json
"sg-change":"change_func"

sg-autonext

  • 说明:选择后自动跳到下一个控件
  • 类型boolean
  • 默认值false

可选值

说明
true开启
false关闭

示例

json
"sg-autonext":true

sg-autoselect

  • 说明:弹窗输入文字,如果列表只有一条,自动默认选择(不弹窗)
  • 类型boolean
  • 默认值false

可选值

说明
true开启
false关闭

示例

json
"sg-autoselect":true

sg-autoselectbutton

  • 说明:弹窗自动选择触发列表中的按钮的 name
  • 类型string

示例

json
"sg-autoselectbutton":"sel_name"

方法

setSelectTemp

通过控件 ID,设置弹窗控件的值。

语法

js
setSelectTemp(controlId, value, text, isClose)

参数

参数名类型必填说明
controlIdstring弹窗控件 ID
valueany
textstring文字
isCloseboolean是否关闭弹窗

示例

js
// 设置弹窗控件的值并关闭弹窗
setSelectTemp("userSelector", "1001", "张三", true);

getSelectTempKey

获取弹窗选择的 key(文字)。

语法

js
getSelectTempKey(controlId)

参数

参数名类型必填说明
controlIdstring弹窗控件 ID

返回值

返回弹窗选择的 key(文字)。

示例

js
// 获取弹窗选择的文字
var selectedText = getSelectTempKey("userSelector");
console.log("选中的用户: " + selectedText);

renderSelectTemp

手动渲染弹窗控件。

语法

js
renderSelectTemp(controlId, params)

参数

参数名类型必填说明
controlIdstring弹窗控件 ID
paramsObject参数

示例

js
// 手动渲染弹窗控件
var params = {
    title: "选择用户",
    url: "/user/select"
};
renderSelectTemp("userSelector", params);

fillSelectTemp

弹框页面中使用的方法,会自动填写值并且关闭弹框。

语法

js
fillSelectTemp(value, text)

参数

参数名类型必填说明
valueany
textstring文字

示例

js
// 填写弹窗内容并关闭弹窗
fillSelectTemp("1001", "张三");

clearSelectTemp

清除弹窗内容。

语法

js
clearSelectTemp(controlId)

参数

参数名类型必填说明
controlIdstring弹窗控件 ID

示例

js
// 清除弹窗控件内容
clearSelectTemp("userSelector");

closeSelectTemp

手动关闭弹窗选择。

语法

js
closeSelectTemp(controlId)

参数

参数名类型必填说明
controlIdstring弹窗控件 ID

示例

js
// 手动关闭弹窗选择
closeSelectTemp("userSelector");

基于 MIT 许可发布