界面组件 深入了解 D · 日常用语或特定名称 平台: 网页

Cascader

级联选择器

级联选择器会逐级显示选项。选好一级,才会打开下一级。

动手试试看
也有人这样说 Cascader联动选择器层级选择器

动手试试看

级联选择器
选择配送地区
中国台湾 / 北部 / 台北

生活中的例子

配送表单先选国家,再选省份和城市。每次选择都会缩小下一份列表。

主要部分

  1. 01触发字段
  2. 02层级列
  3. 03已选路径

什么时候用

选项有固定层级,而且路径清楚时使用。

什么时候不要用

短列表、跨分支搜索或名称不清楚时,不要使用。

代码里的名称

tree path + dependent option columns

上线前要检查

每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。

可以直接复制的需求

预期结果:使用 级联选择器 (Cascader) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:配送表单先选国家,再选省份和城市。每次选择都会缩小下一份列表。 建议界面模式:级联选择器 (Cascader)。 适用理由:选项有固定层级,而且路径清楚时使用。 不应使用的情况:短列表、跨分支搜索或名称不清楚时,不要使用。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):这不是正式规范标准。不同来源使用的名称、范围和预期做法可能不同。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。

检查这份需求

请 AI 编程助手检查当前如何使用 级联选择器 (Cascader)。 定义:级联选择器会逐级显示选项。选好一级,才会打开下一级。 生产环境检查:每个字段都要有程序能读到的标签。关联提示与错误,并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

D
这个术语有多正式?

日常用语或特定名称

这可能是常用旧称、特定公司的用语,或 Vibulary 的分类名称。来源可能只说明做法或限制,不一定定义这个名称。

这不是正式规范标准。不同来源使用的名称、范围和预期做法可能不同。

适用范围
只包含来源有说明的内容:正式名称、定义、平台 API、实现、使用指南
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 · Ant Design · 稳定 Cascader 适用范围: 正式名称、定义、平台 API、实现、使用指南 本页用途: 提供背景,不是正式定义 来源涵盖内容: 正式名称, 定义, 平台 API, 实现, 使用指南

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。