> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

下拉选择组件用于从预定义的选项列表中选择一个选项。
## 属性设置 {#8ceebcc4}
下拉选择组件支持丰富的属性设置，例如常用设置、位置设置、尺寸设置、样式设置和可见性设置。
### 常用设置 {#a893eb9f}
<!-- @cols-width: 140,712 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|标签 |配置是否显示下拉选择组件的标签，标签可以为下拉选择组件提供文字描述，使用户能够更直观地理解下拉选择组件的状态或功能。 |
| | | \
|标签内容 |配置下拉选择组件的标签内容，支持配置静态内容和动态绑定数据，详情请参见[设置组件内容参数](/guides/set_content_parameters)。 |\
| |仅打开了下拉选择组件的设置开关时，才支持此配置项。默认标签内容为**请选择**。 |
| | | \
|占位文案 |配置下拉选择的占位文案，占位文案是一种提示性文本，它出现在选项框中但不会显示在最终提交的数据里。 |\
| |默认为**请选择**。 |
| | | \
|选项内容 |配置下拉选择中选项的显示内容，支持**固定内容**和**动态内容**。 |
| | | \
|选项设置 |配置各选项的显示内容，默认有三个选项，可以添加或移除选项。 |\
| |仅选择了**固定内容**，才支持此配置项。 |
| | | \
|默认值 |配置下拉选择组件的默认值。 |\
| |仅选择了**固定内容**，才支持此配置项。 |
| | | \
|绑定数组 |支持绑定工作流，以动态获取数据作为下拉选择的选项内容。 |\
| | |\
| |* 绑定的工作流的输出数据必须为Array类型。 |\
| |* 需要配置事件以触发调用工作流。 |\
| |* 仅选择了**动态内容**，才支持此配置项。 |
| | | \
|选项名称 |配置选项名称，选项名称是显示给用户看的文本，能够让用户理解每个选项的含义。例如满意度调查场景中，选项名称可以设置为非常满意、一般、不满意。 |
| | | \
|选项值 |配置选项名称对应的具体值，选项值是与选项名称相关联的实际数据值，通常在表单提交时发送给服务器。这个值通常是不可见的，它代表了选项名称背后的数据标识。 |\
| |例如，如果下拉选项用于选择国家，选项名称可能是国家名称，而选项值则可能是国家代码。 |
| | | \
|组件布局 |配置标签与选择框的布局方式，支持上下布局和左右布局。 |
| | | \
|垂直对齐 |配置下拉选择组件的垂直对齐方式。 |\
| | |\
| |* 范围：顶部对齐、垂直居中对齐、底部对齐。 |\
| |* 默认值：顶部对齐。 |
| | | \
|输入区颜色 |配置下拉选择组件背景的显示颜色。 |
| | | \
|输入区边框 |配置下拉选择组件背景的边框颜色、边框的粗细和边框的样式。 |

### 位置设置 {#037eae88}
下拉选择组件提供三种位置类型选项，以灵活配置组件在界面中的位置。

* 相对定位：堆叠布局下，元素自动向下或向右排列。
* 绝对定位：页面滚动时，绝对定位的元素会随页面一起滚动。
* 固定定位：页面滚动时，固定定位的元素会保持固定位置不变。

### 尺寸设置 {#16cf18a0}
<!-- @cols-width: 140,712 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|宽度 |配置下拉选择组件的宽度值，支持以下宽度设置方式： |\
| | |\
| |* 固定：固定的像素值，不会随容器大小变化。 |\
| |* 百分比：元素的宽度占容器宽度的百分比。 |\
| |* 填充容器：元素的宽度填满容器的可用空间。 |\
| |* 适应内容：元素的宽度会随着内容的大小自动调整。 |
| | | \
|高度 |配置下拉选择组件的高度值，支持以下高度设置方式： |\
| | |\
| |* 固定：固定的像素值，不会随容器大小变化。 |\
| |* 百分比：元素的高度占容器高度的百分比。 |\
| |* 填充容器：元素的高度填满容器的可用空间。 |\
| |* 适应内容：元素的高度会随着内容的大小自动调整。 |
| | | \
|尺寸限制 |配置下拉选择组件的尺寸限制，支持配置最大高度、最小高度、最大宽度、最小宽度。 |\
| |合理设置尺寸限制参数可以确保组件在不同屏幕尺寸下保持布局的稳定性和一致性，避免因屏幕尺寸差异而导致的布局问题。 |

### **样式设置** {#a7ad07ab}
<!-- @cols-width: 140,712 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|填充 |配置下拉选择组件背景的显示颜色。 |
| | | \
|圆角 |配置下拉选择组件背景的圆角，支持单独设置四个角的圆角。 |
| | | \
|内边距 |配置下拉选择组件背景的内边距，可以单独设置四个方向的内边距。 |
| | | \
|外边距 |配置下拉选择组件背景的外边距，可以单独设置四个方向的外边距。 |
| | | \
|边框 |配置下拉选择组件背景的边框样式。支持如下设置方式： |\
| | |\
| |* 预设样式：提供预设的边框样式，可直接使用。 |\
| |* 自定义样式：通过边框线的颜色、粗细和样式，自定义边框样式。 |
| | | \
|阴影 |配置下拉选择组件背景的阴影样式，增强组件的立体感。支持如下设置方式： |\
| | |\
| |* 预设样式：提供预设的阴影样式，可直接使用。 |\
| |* 自定义样式：支持通过样式、X偏移、Y偏移、模糊半径、扩展半径、颜色，自定义阴影样式。 |
| | | \
|图层模糊 |配置下拉选择组件的模糊效果。数值越大，模糊效果越明显。 |
| | | \
|溢出 |配置单行输入组件溢出相关设置，支持以下溢出方式： |\
| | |\
| |* 滚动：添加滚动条以查看超出的内容。 |\
| |* 可见：显示全部内容。 |\
| |* 隐藏：隐藏超出容器的内容。 |

### 变换设置 {#50215492}
丰富界面视觉效果的参数。
<!-- @cols-width: 138,707 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|缩放 |配置下拉选择组件大小的缩放比例。 |
| | | \
|旋转 |配置下拉选择组件围绕中心点旋转的角度。 |
| | | \
|位移 |配置下拉选择组件在水平和垂直方向上的移动距离。 |
| | | \
|倾斜 |配置下拉选择组件在水平和垂直方向上的倾斜角度。 |

### 状态设置 {#729ea207}
控制下拉选择组件禁用态、加载态、点击态和出现态的视觉效果参数。
<!-- @cols-width: 140,712 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|禁用态 |配置下拉选择组件的禁用状态。具体配置说明如下： |\
| | |\
| |* 设置为 true：组件处于禁用状态。 |\
| |* 设置为 false：组件处于可用状态。 |\
| |* 设置为变量：通过变量值（true 或 false）动态控制下拉选择组件的禁用状态。 |\
| |   例如可以通过工作流控制下拉选择组件的禁用状态。工作流为 `example_workflow`，当你将下拉选择组件**禁用态**设置为`{{example_workflow.disable.value}}`后，工作流的 `disable` 属性为 `true` 时，`{{example_workflow.disable.value}}` 值为 true，下拉选择组件将处于禁用状态。 |
| | | \
|加载态 |配置下拉选择组件的加载状态。具体配置说明如下： |\
| | |\
| |* 设置为 true：组件展示加载状态，隐藏组件内容。 |\
| |* 设置为 false：关闭加载状态。 |\
| |* 设置为变量：通过变量值（true 或 false）动态控制下拉选择组件的加载状态。 |\
| |   例如可以通过单行输入组件控制下拉选择组件的加载状态。单行输入组件 ID 为 `Input1`，当你将下拉选择组件的**加载态**设置为`{{Input1.value}}`后，在单行输入组件中输入文本时，`{{Input1.value}}`值为 true，下拉选择组件展示加载态。 |
| | | \
|点击效果 |配置下拉选择组件的点击态效果。具体配置说明如下： |\
| | |\
| |* 样式效果：点击下拉选择组件时，下拉选择组件的样式变化情况。详细说明，请参考[样式设置](/guides/drop-down_selection#a7ad07ab)。 |\
| |* 变换效果：点击下拉选择组件时，下拉选择组件的动态变化情况。详细说明，请参考[变换设置](/guides/drop-down_selection#50215492)。 |\
| |* 过渡效果：设置下拉选择组件点击态的动画效果。 |\
| |   * 动画效果：支持设置为缓入缓出、缓入、缓出、线性等动画。 |\
| |   * 持续时间：设置动画的持续时间，单位为毫秒。 |\
| |   * 延迟时间：设置动画延迟出现的时间，单位为毫秒。 |\
| |   * 生效范围：设置动画的生效范围。 |\
| |      * 应用于全部变化：动画效果将应用于样式设置和变换设置所产生的所有变化。 |\
| |      * 仅应用于变换效果：动画效果仅应用于变换设置所产生的变化。 |
| | | \
|出场效果 |设置下拉选择组件在界面中出现时的动画效果。目前支持设置为淡入、缩放、模糊、水平翻转、垂直翻转、从下滑入、从上滑入、从左滑入、从右滑入等动画效果。 |

### **可见性设置** {#6d9ed98d}
控制下拉选择组件隐藏或显示的参数，支持在特定条件下隐藏下拉选择组件。

* 设置为 false：显示组件。
* 设置为 true：隐藏组件。
* 设置为变量：通过变量值（true 或 false）动态控制下拉选择组件的可见性。
   例如可以通过单行输入组件控制下拉选择组件的可见性。单行输入组件 ID 为 `Input1`，当你将下拉选择组件的**可见性**设置为`{{ Input1.value}}`后，在单行输入组件中输入文本时，`{{ Input1.value}}`值为 true，下拉选择组件将被隐藏。

## 事件设置 {#3c0c4876}
通过配置下拉选择组件的事件，可以为下拉选择组件添加丰富的交互功能，以增强用户体验和界面的互动性。
<!-- @cols-width: 148,709 -->
| | | \
|**事件项** |**说明** |
|---|---|
| | | \
|事件类型 |数据改变时：当单选按钮组件的数据发生变化时，触发预定义的事件。 |
| | | \
|组件方法 |支持以下方法： |\
| | |\
| |* 设置数据：为组件设置或更新数据。 |\
| |* 设置禁用：使组件变为禁用状态，用户无法与之交互。 |\
| |* 复制到剪贴板：复制文本内容到剪切板。 |\
| |* 设置隐藏：隐藏组件，使其不可见。 |