Microsoft.Common.OptionsGroup UI 元素

OptionsGroup 控制項可讓使用者從兩個或多個選擇中選取一個選項。 使用者只能選取一個選項。

注意

此控制項過去是以水平呈現選項。 現在，控制項會以選項按鈕的形式垂直呈現選項。

UI 範例

結構描述

{
  "name": "element1",
  "type": "Microsoft.Common.OptionsGroup",
  "label": "Some options group",
  "defaultValue": "Value two",
  "toolTip": "",
  "constraints": {
    "allowedValues": [
      {
        "label": "Value one",
        "value": "one"
      },
      {
        "label": "Value two",
        "value": "two"
      }
    ],
    "required": true
  },
  "visible": true
}

範例輸出

"two"

備註

• constraints.allowedValues 的標籤是項目的顯示文字，其值為選取時的元素輸出值。
• 如果指定，預設值必須是 constraints.allowedValues 中存在的標籤。 如果未指定，依預設會選取 constraints.allowedValues 中的第一個項目。 預設值是 null。
• constraints.allowedValues 必須有至少一個項目。

下一步

• 如需建立 UI 定義的簡介，請參閱開始使用 CreateUiDefinition。
• 如需 UI 元素中通用屬性的說明，請參閱 CreateUiDefinition 元素。