在现代应用程序中，表单控件是用户与系统交互的重要方式之一。本文将详细介绍几种常见的表单控件，包括文本输入列表、整数输入列表和数值输入列表。这些控件允许用户在单个表单屏幕上输入多个值，极大地提高了数据输入的效率和用户体验。
文本输入列表控件允许用户在单个屏幕上输入多个文本值。例如，用户可以输入不同组织的缩写。这种控件的实现方式如下：
{
"mainScreen": {
"screenID": "OrgAbbrev",
"screenDisplayArray": [
{
"localeCode": "en",
"screenLabel": "1. Type in the abbreviations for the organizations listed below.",
"screenHint": "All inputs are compulsory."
}
],
"screenwidgetType": "textInputList",
"inputRequired": true,
"widgetSchema": "\"OrgAbbrev\": { \"type\": \"object\", \"properties\": { \"International Monetary Fund\": {\"type\": \"string\"}, \"United Nations\": {\"type\": \"string\"}, \"World Health Organization\": {\"type\": \"string\"}, \"North Atlantic Treaty Organization\": {\"type\": \"string\"} }, \"additionalProperties\": false}",
"options": ["International Monetary Fund", "United Nations", "World Health Organization", "North Atlantic Treaty Organization"]
}
}
在上述代码中，screenwidgetType 设置为 textInputList。widgetSchema 包含了一个转义的字符串，用于定义输入模式。在这个例子中，输入模式是一个名为 OrgAbbrev 的 JSON 对象，它包含四个属性，每个属性都是 JSON 字符串类型。这些文本输入必须映射到这四个属性中的一个。此外，可以像文本输入屏幕一样，对这四个属性应用长度和格式约束。options 参数是一个 JSON 数组，包含用于表单屏幕的每个输入文本框的标签文本。
整数输入列表控件与文本输入列表控件的 JSON 表单规范类似，不同之处在于 widgetSchema 中的对象属性是 JSON 整数类型，并且 screenwidgetType 设置为 integerInputList。以下是整数输入列表控件的代码示例：
{
"mainScreen": {
"screenID": "OrgYear",
"screenDisplayArray": [
{
"localeCode": "en",
"screenLabel": "2. Type in the year in which each of these organizations listed were created.",
"screenHint": "Enter values between 1900 and 2000."
}
],
"screenwidgetType": "integerInputList",
"inputRequired": true,
"widgetSchema": "\"OrgYear\": { \"type\": \"object\", \"properties\": { \"International Monetary Fund\": {\"type\": \"integer\", \"minimum\": 1900, \"maximum\": 2000}, \"United Nations\": {\"type\": \"integer\", \"minimum\": 1900, \"maximum\": 2000}, \"World Health Organization\": {\"type\": \"integer\", \"minimum\": 1900, \"maximum\": 2000}, \"North Atlantic Treaty Organization\": {\"type\": \"integer\", \"minimum\": 1900, \"maximum\": 2000} }, \"additionalProperties\": false}",
"options": ["International Monetary Fund", "United Nations", "World Health Organization", "North Atlantic Treaty Organization"]
}
}
在整数输入列表控件中，可以应用适用于整数输入屏幕的约束，例如可接受的输入值范围。
数值输入列表控件允许用户在单个屏幕上输入多个数值。这种控件的实现方式如下：
{
"mainScreen": {
"screenID": "FruitAffinity",
"screenDisplayArray": [
{
"localeCode": "en",
"screenLabel": "3. On a scale of 0.1 to 0.9 how much do you like the fruits listed below?",
"screenHint": "Enter a valid decimal value in the range stated above."
}
],
"screenwidgetType": "numberInputList",
"inputRequired": true,
"widgetSchema": "\"FruitAffinity\": { \"type\": \"object\", \"properties\": { \"Guava\": {\"type\": \"number\", \"minimum\": 0.1, \"maximum\": 0.9}, \"Apple\": {\"type\": \"number\", \"minimum\": 0.1, \"maximum\": 0.9}, \"Banana\": {\"type\": \"number\", \"minimum\": 0.1, \"maximum\": 0.9}, \"Oranges\": {\"type\": \"number\", \"minimum\": 0.1, \"maximum\": 0.9} }, \"additionalProperties\": false}",
"options": ["Guava", "Apple", "Banana", "Oranges"]
}
}
在数值输入列表控件中，用户可以输入介于 0.1 到 0.9 之间的数值，以表示对列表中水果的喜好程度。