氚专开发者扩展文档

外观

表单前端GetValue&SetValue

约 2597 字大约 9 分钟

2025-02-17

由于不同控件类型，在赋值和取值（即：SetValue/GetValue）时数据结构有一定差别，所以本篇做一个特别说明。

注意

本文中的 that 指代的是 this，不直接使用 this 是因为在回调事件中 this 的指向是错的（具体原因请移步：表单前端API-this）。

为了使用时统一，本文一律把 this 替换为 that。

单行文本/多行文本/单选框/下拉框/流水号

此类控件值都是 string 类型

取值：

var str = that.控件编码.GetValue();

//判断控件有值
if( str ) {
    //符合这个条件的值为非空字符串，undefined、null、"" 都不会符合这个条件
}

//判断控件值为空
if( str === undefined || str === null || str === "" ) {

}

赋值：

that.控件编码.SetValue("控件值");

清空控件值：

that.控件编码.SetValue("");

人员单选/部门单选

此类控件取值和赋值不一样，取值时返回的是字符串数组，而赋值时传入字符串即可。

取值：

var idArray = that.控件编码.GetValue();

//虽然返回的是字符串数组，但因为是单选，所以数组只会有一个元素，所以取下标为0的就是 用户Id/部门Id
var unitId = "";
if( idArray && idArray.length > 0 ) {
    unitId = idArray[ 0 ];
}

//判断控件值为空
if( idArray === null || idArray.length === 0 ) {

}

赋值：

that.控件编码.SetValue("人员Id/部门Id");

清空控件值：

that.控件编码.SetValue("");

人员多选/部门多选

此类控件取值和赋值都是字符串数组。

取值：

赋值：

that.控件编码.SetValue(["id1", "id2"]);

清空控件值：

that.控件编码.SetValue(null);

关联表单

此类控件值都是 string 类型，但是值是被关联表单的数据Id，即数据表中的ObjectId字段。

取值：

var boId = that.控件编码.GetValue();

//判断控件有值
if( boId ) {
    //符合这个条件的值就是非空字符串，而 undefined、null、"" 都不会符合这个条件
}

//判断控件值为空
if( boId === undefined || boId === null || boId === "" ) {

}

赋值：

that.控件编码.SetValue("xxx-xxx-xxx-xxx");

清空控件值：

that.控件编码.SetValue("");

关联表单多选

此类控件取值和赋值都是字符串数组，但是数组里每一个元素都是被关联表单的数据Id，即数据表中的ObjectId字段。

取值：

赋值：

that.控件编码.SetValue(["数据Id-1", "数据Id-2"]);

清空控件值：

that.控件编码.SetValue(null);

日期

日期控件取值和赋值都是 string 类型，取值时字符串格式会和配置的格式一致，但是赋值时只支持2种格式：yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

取值：

var dateStr = that.控件编码.GetValue();

//判断控件有值
if( dateStr ) {
    //如果有值，将它转成Date类型
    var dateObj = new Date(dateStr);
}

//判断控件值为空
if( dateStr === undefined || dateStr === null || dateStr === "" ) {

}

赋值：

that.控件编码.SetValue("2024-05-17");//无时间部分时
that.控件编码.SetValue("2024-05-17 06:24:49");//有时间部分时

如果是把当前时间赋值给日期控件，请参考：前端Date Format

清空控件值：

that.控件编码.SetValue(null);

数字

数字控件取值时返回 string 类型，但赋值时是 number 类型。

取值：

var numStr = that.控件编码.GetValue();

//判断控件有值
if( numStr ) {
    //转成number类型
    var num = parseFloat(numStr);
}

//判断控件值为空
if( numStr === undefined || numStr === null || numStr === "" ) {

}

赋值：

that.控件编码.SetValue(123.45);

清空控件值：

that.控件编码.SetValue(null);

复选框

复选框取值赋值都是 string 类型，每个选项间用;分割。

取值：

赋值：

that.控件编码.SetValue("选项1;选项2");

清空控件值：

that.控件编码.SetValue("");

是/否

是/否控件取值赋值都是 boolean 类型。

取值：

var isChecked = that.控件编码.GetValue();
if( isChecked ) {
    //选择了“是”
}

if(!isChecked){
    //选择了“否”
}

赋值：

that.控件编码.SetValue(true);
that.控件编码.SetValue(false);

清空控件值：不支持

地址

地址控件取值赋值都是 string 类型，但格式是一个对象JSON。

JSON里的adcode是中国行政区划代码，可访问：2022年中华人民共和国县以上行政区划代码。

注意：这个区划代码国家会修订，氚云的地址控件也会随之更新，所以使用时请百度查询最新版的区划代码。

取值：

赋值：

that.控件编码.SetValue('{"adcode":"440305","adname":"广东省 深圳市 南山区","Detail":"粤海街道科兴科学园A2单元1505室"}');

清空控件值：

that.控件编码.SetValue(null);

位置

位置控件取值赋值都是 string 类型，但值是一个JSON字符串，JSON结构如下：

{
  "Address": "广东省深圳市南山区粤海街道南山科兴科学园C2栋",
  "Point": {
    "lat": 22.547421,
    "lng": 113.944386
  },
  "CSType": 2,
  "WGS84Point": {
    "lng": 113.93950766274739,
    "lat": 22.550433917423504
  }
}

取值：

赋值：

that.控件编码.SetValue('{"Address":"广东省深圳市南山区粤海街道南山科兴科学园C2栋","Point":{"lat":22.547421,"lng":113.944386},"CSType":2,"WGS84Point":{"lng":113.93950766274739,"lat":22.550433917423504}}');

清空控件值：

that.控件编码.SetValue(null);

附件/图片

此类控件在前端可取值、清空控件值，但由于附件和图片的特殊性，所以前端不可对附件/图片赋值。

取值：

赋值：不支持

清空控件值：

that.控件编码.SetValue(null);

子表

子表控件提供了比较多的函数来操作数据，这里只演示 GetValue、ClearRows 函数，其他的函数请查阅：表单前端API。

取值：

清空控件值：

that.控件编码.ClearRows();