Appearance
弹窗
弹窗控件用于打开子页面进行选择或数据录入,支持页面传参、自动选择等功能。
属性
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": truesg-hide
- 说明:为 true 时窗口隐藏,需要调用显示方法 showWin() 才能显示
- 类型:
boolean - 默认值:
false
可选值
| 值 | 说明 |
|---|---|
true | 隐藏 |
false | 不隐藏 |
示例
json
"sg-hide":truesg-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":truesg-clear
- 说明:弹窗清除按钮(true 显示,false 或不传不显示)
- 类型:
boolean - 默认值:
false
可选值
| 值 | 说明 |
|---|---|
true | 显示 |
false | 不显示 |
示例
json
"sg-clear":truesg-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":truesg-autoselect
- 说明:弹窗输入文字,如果列表只有一条,自动默认选择(不弹窗)
- 类型:
boolean - 默认值:
false
可选值
| 值 | 说明 |
|---|---|
true | 开启 |
false | 关闭 |
示例
json
"sg-autoselect":truesg-autoselectbutton
- 说明:弹窗自动选择触发列表中的按钮的 name
- 类型:
string
示例
json
"sg-autoselectbutton":"sel_name"方法
setSelectTemp
通过控件 ID,设置弹窗控件的值。
语法
js
setSelectTemp(controlId, value, text, isClose)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| controlId | string | 是 | 弹窗控件 ID |
| value | any | 是 | 值 |
| text | string | 是 | 文字 |
| isClose | boolean | 是 | 是否关闭弹窗 |
示例
js
// 设置弹窗控件的值并关闭弹窗
setSelectTemp("userSelector", "1001", "张三", true);getSelectTempKey
获取弹窗选择的 key(文字)。
语法
js
getSelectTempKey(controlId)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| controlId | string | 是 | 弹窗控件 ID |
返回值
返回弹窗选择的 key(文字)。
示例
js
// 获取弹窗选择的文字
var selectedText = getSelectTempKey("userSelector");
console.log("选中的用户: " + selectedText);renderSelectTemp
手动渲染弹窗控件。
语法
js
renderSelectTemp(controlId, params)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| controlId | string | 是 | 弹窗控件 ID |
| params | Object | 是 | 参数 |
示例
js
// 手动渲染弹窗控件
var params = {
title: "选择用户",
url: "/user/select"
};
renderSelectTemp("userSelector", params);fillSelectTemp
弹框页面中使用的方法,会自动填写值并且关闭弹框。
语法
js
fillSelectTemp(value, text)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| value | any | 是 | 值 |
| text | string | 是 | 文字 |
示例
js
// 填写弹窗内容并关闭弹窗
fillSelectTemp("1001", "张三");clearSelectTemp
清除弹窗内容。
语法
js
clearSelectTemp(controlId)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| controlId | string | 是 | 弹窗控件 ID |
示例
js
// 清除弹窗控件内容
clearSelectTemp("userSelector");closeSelectTemp
手动关闭弹窗选择。
语法
js
closeSelectTemp(controlId)参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| controlId | string | 是 | 弹窗控件 ID |
示例
js
// 手动关闭弹窗选择
closeSelectTemp("userSelector");