弹窗

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

属性

sg-title

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

示例

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

---

sg-width

• 说明：窗口宽度（支持 px 和百分比）
• 类型：string

示例

"sg-width":"800px"

---

sg-height

• 说明：窗口高度（支持 px 和百分比）
• 类型：string

示例

"sg-height":"480px"

---

sg-top

• 说明：是否将弹窗页面置顶显示
• 类型：boolean
• 默认值：false

可选值

值	说明
true	开启
false	关闭

示例

"sg-top": true

---

sg-hide

• 说明：是否默认隐藏窗口，隐藏时需调用 showWin() 才能显示
• 类型：boolean
• 默认值：false

可选值

值	说明
true	隐藏
false	不隐藏

示例

"sg-hide":true

---

sg-caption

• 说明：弹窗控件的标签文字
• 类型：string

示例

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

---

sg-captionclass

• 说明：标签文字宽度样式，w1-w7 对应 1-7 个字符宽度，more 表示超出部分省略显示（如 w5 more）
• 类型：string

示例

"sg-captionclass":"w5"

---

sg-text

• 说明：弹窗选择后的默认显示文字
• 类型：string

示例

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

---

sg-require

• 说明：是否为必填项
• 类型：boolean
• 默认值：false

可选值

值	说明
true	是
false	否

示例

"sg-require":true

---

sg-clear

• 说明：是否显示弹窗清除按钮
• 类型：boolean
• 默认值：false

可选值

值	说明
true	显示
false	不显示

示例

"sg-clear":true

---

sg-url

• 说明：弹窗加载的页面 URL（与 pageid 二选一）
• 类型：string

示例

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

---

sg-pageid

• 说明：弹窗加载的页面 ID（与 url 二选一）
• 类型：string

示例

"sg-pageid":"10"

---

sg-pkey

• 说明：启用输入框并在弹窗时传参；按回车键可自动弹窗；留空则关闭输入框和回车弹窗功能
• 类型：string

示例

"sg-pkey":"user"

---

sg-pval

• 说明：弹窗时传递给子页面的参数名，子页面用 getQueryVariable("参数名") 获取。例如设置为 id，控件值为 123，则弹窗后传递 id=123
• 类型：string

示例

"sg-pval":"user_id"

---

sg-opencheck

• 说明：弹窗打开前的检查回调方法
• 类型：string

示例

"sg-opencheck":"opencheck_func"

---

sg-change

• 说明：弹窗内容改变时的回调方法
• 类型：string

示例

"sg-change":"change_func"

---

sg-autonext

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

可选值

值	说明
true	开启
false	关闭

示例

"sg-autonext":true

---

sg-autoselect

• 说明：输入文字后，如果列表只有一条匹配项，自动选中并关闭弹窗
• 类型：boolean
• 默认值：false

可选值

值	说明
true	开启
false	关闭

示例

"sg-autoselect":true

---

sg-autoselectbutton

• 说明：自动选择时触发的按钮控件 name
• 类型：string

示例

"sg-autoselectbutton":"sel_name"

方法

setSelectTemp

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

语法

setSelectTemp(controlId, value, text, isClose)

参数

参数名	类型	必填	说明
controlId	string	是	弹窗控件 ID
value	any	是	值
text	string	是	文字
isClose	boolean	是	是否关闭弹窗

示例

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

---

getSelectTempKey

获取弹窗选择的显示文字。

语法

getSelectTempKey(controlId)

参数

参数名	类型	必填	说明
controlId	string	是	弹窗控件 ID

返回值

返回弹窗选择的 key（文字）。

示例

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

---

renderSelectTemp

手动渲染弹窗控件。

语法

renderSelectTemp(controlId, params)

参数

参数名	类型	必填	说明
controlId	string	是	弹窗控件 ID
params	Object	是	参数

示例

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

---

fillSelectTemp

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

语法

fillSelectTemp(value, text)

参数

参数名	类型	必填	说明
value	any	是	值
text	string	是	文字

示例

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

---

clearSelectTemp

清除弹窗内容。

语法

clearSelectTemp(controlId)

参数

参数名	类型	必填	说明
controlId	string	是	弹窗控件 ID

示例

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

---

closeSelectTemp

手动关闭弹窗选择。

语法

closeSelectTemp(controlId)

参数

参数名	类型	必填	说明
controlId	string	是	弹窗控件 ID

示例

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