跳转至

Select From List 列表下拉单选与动态选择器节点

通过下拉菜单交互界面，从字符串列表中选择单个数据项。

节点功能描述 (Description)

Select From List 节点允许创作者在工作流画布中，通过交互式下拉菜单（Dropdown Interface）从给定的字符串列表中自由挑选单项元素。当输入的列表数据发生动态变更时，下拉选项会自动响应式实时更新，并在新列表中仍然包含先前所选项时智能保持当前的选择状态。

参数配置规范 (Parameters)

输入参数 (Input Parameters)

参数名称 数据类型 描述说明 默认值
list list 供创作者选择备选子项的母列表 []

输出参数 (Output Parameters)

参数名称 数据类型 描述说明
selected_item string 当前在下拉菜单中选中的目标数据项字符串

核心特性 (Features)

  • 动态下拉菜单 (Dynamic Dropdown)：自动根据接入的列表内容填充并刷新下拉列表选项；
  • 智能选择态记忆 (Selection Preservation)：列表更新时，若先前选中的项在新列表中依旧存在，则自动保留该项，避免误重置；
  • 自动字符串转换 (String Conversion)：自动将接入的列表非字符串元素转换为字符串形式，确保统一的比对与展现；
  • 实时响应刷新 (Real-time Updates)：上游数据源变更瞬间即刻响应刷新 UI；
  • 安全防御机制 (Safe Handling)：当输入为空列表或非法对象时优雅处理，不引发画布中断。

使用示例 (Examples)

基础列表选择

# 输入列表: ["Apple", "Banana", "Cherry", "Date"]
# 创作者在面板下拉选择: "Banana"
# 输出结果: "Banana"

业务状态单选

# 输入列表: ["In Progress", "Not Started", "Waiting", "Completed", "Blocked"]
# 创作者选择: "Completed"
# 输出结果: "Completed"

动态列表实时更新记忆

# 初始列表: ["Option A", "Option B", "Option C"]
# 创作者选择: "Option B"
# 上游更新列表为: ["Option A", "Option B", "Option D", "Option E"]
# 选项自动保留: "Option B"（因为其依旧存在于新列表中）

# 若上游列表被整体替换为: ["Option X", "Option Y", "Option Z"]
# 选项安全重置为: "Option X"（自动对齐新列表的首项）

典型业务场景 (Use Cases)

  • 业务状态管理：从预定义的标准状态集合（如 "In Progress"、"Completed"）中快速选取当前流转状态；
  • 品类与维度切换：从分类目录或主题列表中挑选当前处理分支；
  • 模型配置项选择：在多个可选的大模型或图像预设中挑选执行目标；
  • 交互式工作流构建：为复杂的工作流拓扑提供直观的用户下拉交互控制端；
  • 数据切片过滤：从动态爬取或生成的实体列表中选定单项进入下游精细化流水线。

典型工作流拓扑结构 (Workflow Examples)

状态流转管理工作流

Create Text List → Select From List → 状态处理后续节点
     ↓                    ↓
["In Progress",      "Completed"    → 更新任务最终状态
 "Not Started", 
 "Waiting", 
 "Completed", 
 "Blocked"]

动态 API 选项解析工作流

API 响应 → 提取备选列表 → Select From List → 消费选定配置
   ↓             ↓               ↓
JSON 数据  → ["Option 1",   → "Option 2"    → 针对该配置执行计算
             "Option 2", 
             "Option 3"]

运行处理逻辑 (Behavior)

选择项状态机逻辑 (Selection Logic)

  1. 初始挂载 (Initial Load)：默认自动选中列表的首项元素；
  2. 列表发生变更 (List Update)：
    • 若当前已选中的项仍在新列表中 $\rightarrow$ 维持当前选中状态不变；
    • 若先前选中的项在新列表中已不复存在 $\rightarrow$ 自动回退选中新列表的第 0 号首项；
  3. 空列表容错 (Empty List)：清空选项，输出安全空字符串 ""；
  4. 非法输入容错 (Invalid Input)：清空选项，输出安全空字符串 ""。

自动化字符串转换 (String Conversion)

接入的所有非文本类型元素均会被自动规范化转换为字符串：

  • 数值：123 $\rightarrow$ "123"
  • 布尔：True $\rightarrow$ "True"
  • 对象/字典：{"key": "value"} $\rightarrow$ "{'key': 'value'}"