跳转至

String Selector（字符串选择器(String Selector)）

The String Selector widget can be used to display string options in various selection forms including a dropdown menu, as radio buttons, or a set of checkboxes.

String selector example

Configuration Options

  • Label
  • Sets an optional label for the widget. This text is displayed across the top of the widget.
  • Option generation
  • Static: Manually enter in and reorder option values by using the Add selector option button.
  • Dynamic: Select an existing or create a new string array variable to be used to generate options for the widget.
  • Selection
  • The widget can be set to either allow for a single option selection or multiple option selections.
  • Selected value: Output variable of the widget, storing the user’s selected option(s). If the selection is set to Single, the output variable will be a string variable. If the selection is set to Multiple, the output variable will be a string array variable.
  • Selection display
    • If the selection is set to Single, the widget may be displayed as either a dropdown or as radio buttons.
    • Dropdown
      • Disable clearing of dropdown options: Can be toggled on to disable clearing of the selected dropdown option
      • Placeholder: By default, “Select an option...“ will be used as the placeholder text displayed on the widget when no selection has been made. A custom placeholder value can be defined via the Custom option.
    • Radio buttons
      • Radio buttons layout: The layout of the options can be set to display vertically, horizontally, or in a grid formation with a specified number of columns.
    • If the selection is set to Multiple, the widget may be displayed as either a dropdown or as checkboxes.
    • Dropdown
      • Allow creating new options: Can be toggled on to allow users to create new options to be added to the dropdown. Any user-created options will be italicized.
      • Placeholder: By default, “Search options...” will be used as the placeholder text displayed on the widget when no selection has been made. A custom placeholder value can be defined via the ‘Custom’ option.
    • Checkboxes
      • Checkboxes layout: The layout of the options can be set to display vertically, horizontally, or in a grid formation with a specified number of columns.

中文翻译

字符串选择器(String Selector)

字符串选择器(String Selector)部件(Widget)可用于展示字符串选项，支持下拉菜单、单选按钮、复选框等多种选择形式。

字符串选择器示例

配置选项(Configuration Options)

  • 标签(Label)
  • 为部件设置可选标签，该文本会展示在部件顶部。
  • 选项生成(Option generation)
  • 静态(Static)：通过添加选择器选项(Add selector option)按钮手动输入选项值并调整排序。
  • 动态(Dynamic)：选择已有或新建字符串数组变量，用于为该部件生成选项。
  • 选择设置(Selection)
  • 可将该部件设置为仅允许单选选项，或允许多选选项。
  • 选中值(Selected value)：该部件的输出变量，存储用户选中的选项。如果选择模式设为单选(Single)，输出变量为字符串变量；如果选择模式设为多选(Multiple)，输出变量为字符串数组变量。
  • 选择展示样式(Selection display)
    • 如果选择模式设为单选(Single)，部件可展示为下拉框或单选按钮形式：
    • 下拉框(Dropdown)
      • 禁用下拉选项清空(Disable clearing of dropdown options)：开启该开关后，将无法清空下拉框中已选中的选项。
      • 占位符(Placeholder)：未做选择时，部件默认会显示 Select an option... 作为占位文本，你也可以通过自定义(Custom)选项设置专属占位值。
    • 单选按钮(Radio buttons)
      • 单选按钮布局(Radio buttons layout)：选项布局可设置为垂直展示、水平展示，或按指定列数的网格形式展示。
    • 如果选择模式设为多选(Multiple)，部件可展示为下拉框或复选框形式：
    • 下拉框(Dropdown)
      • 允许创建新选项(Allow creating new options)：开启该开关后，允许用户创建新选项并添加到下拉框中，所有用户创建的选项会以斜体显示。
      • 占位符(Placeholder)：未做选择时，部件默认会显示 Search options... 作为占位文本，你也可以通过自定义(Custom)选项设置专属占位值。
    • 复选框(Checkboxes)
      • 复选框布局(Checkboxes layout)：选项布局可设置为垂直展示、水平展示，或按指定列数的网格形式展示。