Ant Design Blazor
Cascader级联选择
级联选择框。
何时使用
- 需要从一组相关联的数据集合进行选择，例如省市区，公司层级，事物分类等。
- 从一个较大的数据集合中进行选择时，用多级分类进行分隔，方便选择。
- 比起 Select 组件，可以在同一个浮层中完成选择，有较好的体验。
Examples
省市区级联
通过移入展开下级菜单，点击完成选择。
这种交互允许只选中父级选项。
Cascader API#
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| AllowClear | 属性是否允许清算 | Boolean | true |
| BoundaryAdjustMode | 属性叠加调整策略（例如浏览器调整大小时） | TriggerBoundaryAdjustMode | -- |
| ChangeOnSelect | 属性如果设置为 true，则更改每个选择的值，如果设置为 false，则仅更改最终选择。 | Boolean | -- |
| DefaultValue | 属性初始选择值 | String | -- |
| ExpandTrigger | 属性何时展开当前项目 - 单击或悬停 | String | click |
| NotFoundContent | 属性找不到时的空描述 | String | No Data (in current locale) |
| Placeholder | 属性输入占位符 | String | Please select (in current locacle) |
| PopupContainerSelector | 属性显示弹出容器的元素 | String | -- |
| ShowSearch | 属性是否允许搜索 | Boolean | -- |
| Disabled | 属性是否禁用输入 | Boolean | -- |
| OnChange | 属性选中值改变时执行的回调Instead use SelectedNodesChanged. Obsolete 将在未来的版本中删除。 |
Action<List<CascaderNode>, String, String> | -- |
| SelectedNodesChanged | 属性选中值改变时执行的回调 | EventCallback<CascaderNode[]> | -- |
| Options | 属性覆盖选项 | IEnumerable<CascaderNode> | -- |
| Placement | 属性叠加层的放置。默认为 AntDesign.Placement.BottomLeft。 |
Placement | Placement.BottomLeft |
| ValidationMessages | FormItem 的验证消息 | String[] | -- |
| AdditionalAttributes | 属性获取或设置将应用于所创建元素的附加属性的集合。 | IReadOnlyDictionary<String, Object> | -- |
| Value | 属性获取或设置输入的值。这应该与双向绑定一起使用。 | String | -- |
| ValueChanged | 属性更新绑定值的回调。 | EventCallback<String> | -- |
| ValueExpression | 属性标识绑定值的表达式。 | Expression<Func<String>> | -- |
| ValuesExpression | 属性标识可枚举绑定值的表达式。 | Expression<Func<IEnumerable<String>>> | -- |
| Size | 属性输入框的大小。注意：在表单的上下文中，使用“大”尺寸。可用：`大``默认``小` | String | AntSizeLDSType.Default |
| CultureInfo | 属性将字符串转换为值和将值转换为字符串时将使用什么文化对 InputNumber 组件有用。 | CultureInfo | CultureInfo.CurrentCulture |
| Id | 属性组件 HTML 的 ID | String | Uniquely Generated ID |
| Class | 属性为 DOM 元素指定一个或多个类名。 | String | -- |
| Style | 属性指定 DOM 元素的内联样式。 | String | -- |
| RefBack | 属性一个 ForwardRef 实例。您可以使用 AntDesign.ForwardRef.Current 获取对内部 DOM 的引用。 |
ForwardRef | -- |
CascaderNode API#
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| Label | 显示价值的标签 | String | -- |
| Value | 选择选项时的值 | String | -- |
| Disabled | 是否禁用该选项 | Boolean | false |
| Children | 这一项下的选项 | IEnumerable<CascaderNode> | -- |
TriggerBoundaryAdjustMode API#
基础类型: Int32
| 名称 | 描述 |
|---|---|
| None | 不要自动调整 |
| InView | 默认情况下，视口边界是在覆盖完全可见时用于计算的边界。尝试调整叠加层，使其始终在视口中完全可见。因此，如果叠加层位于视口之外（“溢出”），则会尝试重新定位计算。 |
| InScroll | 如果覆盖需要重新定位，则文档边界是用于计算的边界。因此，即使覆盖在视口之外，只要不“溢出”文档边界，覆盖仍可能显示。 |