下拉选择器

下拉选择器控件用于从预设选项中选择单个值，支持指令加载数据和固定选项两种模式。

属性

sg-caption

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

示例

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

---

sg-captionclass

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

示例

"sg-captionclass":"w5"

---

sg-cmdcode

• 说明：下拉选择绑定的指令编码
• 类型：string

示例

"sg-cmdcode":"getuser"

---

sg-key

• 说明：作为"文字"的字段，搭配指令 sg-cmdcode 使用
• 类型：string

示例

"sg-key":"NAME"

---

sg-list

• 说明：select 框的 list，里面三个参数：key（文字）、val（值）、selected（true 默认选择），适用于固定选项，如果使用 sg-cmdcode 的时候，会叠加 sg-list 选项
• 类型：Array

示例

"sg-list":[
    { "key":"选项1", "val":"值1" },
    { "key":"选项2", "val":"值2", "selected":true }
]

---

sg-loaddata

• 说明：下拉控件渲染后，是否自动加载数据并渲染选项，搭配指令 sg-cmdcode 使用，如果填写 false，则需调用 loadSelectData 渲染选项
• 类型：boolean
• 默认值：true

可选值

值	说明
true	开启
false	关闭

示例

"sg-loaddata":true

---

sg-pageid

• 说明：调用指令的页面 ID，指令在哪个页面就填哪个页面的 page_id，不填默认当前页，搭配 sg-cmdcode 使用
• 类型：string

示例

"sg-pageid":"1"

---

sg-require

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

可选值

值	说明
true	是
false	否

示例

"sg-require":true

---

sg-val

• 说明：作为"值"的字段，搭配指令 sg-cmdcode 使用
• 类型：string

示例

"sg-val":"ID"

方法

loadSelectData

通过指令加载下拉框选项。

语法

loadSelectData(html_id, param, callback)

参数

参数名	类型	必填	说明
html_id	string	是	控件 ID
param	object	是	指令请求参数
callback	function	否	回调函数，不写则为同步模式

callback 参数

参数名	类型	说明
success	function	成功回调
error	function	失败回调
complete	function	完成回调

示例

// 同步模式加载数据
loadSelectData("province", {"NAME": 1});

// 异步模式加载数据
loadSelectData("province", {"NAME": 1}, {
    success: function(data) {
        console.log("加载成功", data);
    },
    error: function(err) {
        console.log("加载失败", err);
    },
    complete: function() {
        console.log("加载完成");
    }
});

---

selectOptions

通过选择器，渲染下拉框选项。

语法

selectOptions(selector, list, value, keyParam, valueParam)

参数

参数名	类型	必填	说明
selector	string	是	选择器
list	Array	是	数据列表
value	any	是	选中值
keyParam	string	是	键参数名
valueParam	string	是	值参数名

示例

// 渲染省份下拉框
var provinces = [
    {id: "1", name: "北京市"},
    {id: "2", name: "上海市"},
    {id: "3", name: "广东省"}
];

selectOptions("#province", provinces, "2", "id", "name");

---

getselectItem

获取下拉框选中的整行数据。

语法

getselectItem(html_id)

参数

参数名	类型	必填	说明
html_id	string	是	控件 ID

返回值

返回下拉框控件选中选项的整行数据（通过指令获取的数据）。

示例

// 获取控件 ID 为 province 的下拉框选中项的整行数据
var selectedItem = getselectItem("province");
console.log(selectedItem);

---

getSelectData

获取下拉框数据。

语法

getSelectData(selector)

参数

参数名	类型	必填	说明
selector	string	是	选择器

返回值

返回下拉框控件的数据。

示例

// 获取控件 ID 为 province 的下拉框数据
var provinceData = getSelectData("#province");
console.log(provinceData);

---

getSelectText

获取下拉框文字。

语法

getSelectText(selector)

参数

参数名	类型	必填	说明
selector	string	是	选择器

返回值

返回下拉框控件的显示文字。

示例

// 获取控件 ID 为 province 的下拉框选中项的文本
var provinceText = getSelectText("#province");
console.log("选中的省份: " + provinceText);