Ant Design Blazor
Cascader级联选择
级联选择框。
何时使用
- 需要从一组相关联的数据集合进行选择，例如省市区，公司层级，事物分类等。
- 从一个较大的数据集合中进行选择时，用多级分类进行分隔，方便选择。
- 比起 Select 组件，可以在同一个浮层中完成选择，有较好的体验。
Examples
省市区级联
默认值通过数组的方式指定。
通过指定 Options 里的 Disabled 字段，禁用选项。也可以通过组件的 Disabled 属性禁用整个组件。
不同大小的级联选择器。
Cascader API#
| 属性 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| ChangeOnSelect | 属性如果设置为 true，则更改每个选择的值，如果设置为 false，则仅更改最终选择。 | Boolean | -- |
| DefaultValue | 属性初始选择值 | String | -- |
| ExpandTrigger | 属性何时展开当前项目 - 单击或悬停 | String | click |
| NotFoundContent | 属性找不到时的空描述 | String | No Data (in current locale) |
| ShowSearch | 属性是否允许搜索 | Boolean | -- |
| OnChange | 属性选中值改变时执行的回调Instead use SelectedNodesChanged. Obsolete 将在未来的版本中删除。 |
Action<List<CascaderNode>, String, String> | -- |
| SelectedNodesChanged | 属性选中值改变时执行的回调 | EventCallback<CascaderNode[]> | -- |
| Options | 属性覆盖选项 | IEnumerable<CascaderNode> | -- |
| BoundaryAdjustMode | 属性叠加调整策略（例如浏览器调整大小时） | TriggerBoundaryAdjustMode | -- |
| AllowClear | 属性显示清除按钮。如果 AntDesign.AntInputComponentBase`1.Value 类型默认值也在 SelectOption 列表中，则无效，除非与 AntDesign.SelectBase`2.ValueOnClear。 |
Boolean | -- |
| AutoClearSearchValue | 属性选择项目时是否清除当前搜索。 | Boolean | -- |
| Disabled | 属性选择组件是否被禁用。 | Boolean | -- |
| Mode | 属性设置选择模式 - 默认 |多个 |标签 | SelectMode | -- |
| EnableSearch | 属性指示搜索功能是否处于活动状态。对于模式标签始终为真。 | Boolean | -- |
| SearchDebounceMilliseconds | 属性延迟搜索输入事件的处理，直到用户停止键入预定的时间。默认为 250 毫秒。 | Int32 | -- |
| Loading | 属性显示加载指示器。您必须自己编写加载逻辑。 | Boolean | -- |
| Open | 属性下拉菜单的受控打开状态。 | Boolean | -- |
| OpenChanged | 属性打开状态更改时调用的回调函数。 | EventCallback<Boolean> | -- |
| Placeholder | 属性选择的占位符。 | String | -- |
| OnFocus | 属性焦点时调用。 | EventCallback | -- |
| AutoFocus | 属性自动对焦。 | Boolean | -- |
| SortByGroup | 属性用作组指示符的属性的名称。如果设置了该值，条目将按组显示。使用额外的 SortByGroup 和 SortByLabel。 | SortDirection | -- |
| SortByLabel | 属性按标签值对项目进行排序。无 |升序 |降序 | SortDirection | -- |
| HideSelected | 属性选中时隐藏选中的项目。 | Boolean | -- |
| ValueChanged | 属性用于双向绑定。 | EventCallback<String> | -- |
| ValuesChanged | 属性用于双向绑定。 | EventCallback<IEnumerable<String>> | -- |
| SuffixIcon | 属性自定义后缀图标。 | RenderFragment | -- |
| PrefixIcon | 属性自定义前缀图标。 | RenderFragment | -- |
| AccessKey | 属性accesskey 全局属性。 | String | -- |
| DefaultValues | 属性Mode = multiple | 时使用tags - 这些值在初始化期间和在 Forms 中按下 Reset 按钮时使用。 | IEnumerable<String> | -- |
| OnClearSelected | 属性当用户清除选择时调用。 | EventCallback | -- |
| ChildContent | 属性Child content to be rendered inside the Cascader. |
RenderFragment | -- |
| Unbound | 属性设置了 ElementReference 的 ChildElement 以避免包装 div。 | RenderFragment<ForwardRef> | -- |
| OnSelectedItemChanged | 属性当所选项目更改时调用。 | EventCallback<String> | -- |
| OnSelectedItemsChanged | 属性当所选项目更改时调用。 | EventCallback<IEnumerable<String>> | -- |
| Values | 属性获取或设置选定的值。 | IEnumerable<String> | -- |
| CustomTagLabelToValue | 属性将自定义标签（字符串）转换为 TItemValue 类型。 | Func<String, String> | -- |
| SelectOptions | 属性用于手动呈现选择选项。 | RenderFragment | -- |
| MaxTagTextLength | 属性标签的长度（字符数）。仅适用于 Mode = "multiple" 或 Mode = "tags" | Int32 | -- |
| LabelInValue | 属性是否在值中嵌入标签，将值的格式从 TItemValue 转换为字符串（JSON），例如{ "value": TItemValue, "label": "标签值" } | Boolean | -- |
| MaxTagCount | 属性要显示的最大标签数。响应式会降低渲染性能。 | OneOf<Int32, ResponsiveTag> | -- |
| ValueOnClear | 属性当按下清除按钮时，值将设置为 ValueOnClear 中设置的值 | String | -- |
| ItemLabel | 属性指定 option 对象中的 label 属性。如果使用此属性，则不应使用 AntDesign.SelectBase'2.LabelName |
Func<String, String> | -- |
| ItemValue | 属性指定 option 对象中的 value 属性。如果使用此属性，则不应使用 AntDesign.SelectBase'2.ValueName |
Func<String, String> | -- |
| LabelName | 属性用于标签的属性的名称。 | String | -- |
| ValueName | 属性要用于该值的属性的名称。 | String | -- |
| OnMouseEnter | 属性鼠标进入时调用。 | Action | -- |
| OnMouseLeave | 属性鼠标离开时调用。 | Action | -- |
| PopupContainerSelector | 属性使用它来修复覆盖问题，例如＃区域 | String | -- |
| DropdownRender | 属性自定义下拉内容。上下文是原始内容。 | RenderFragment<RenderFragment> | -- |
| LabelTemplate | 属性用于自定义标签样式。 | RenderFragment<String> | -- |
| MaxTagPlaceholder | 属性隐藏标签的占位符。如果与 ResponsiveTag.Responsive 一起使用，请实现您自己的处理逻辑。 | RenderFragment<IEnumerable<String>> | -- |
| ShowSearchIcon | 属性是否在单一模式下显示搜索输入。 | Boolean | -- |
| ShowArrowIcon | 属性 | Boolean | -- |
| Placement | 属性叠加层的放置。默认为 AntDesign.Placement.BottomLeft。 |
Placement | Placement.BottomLeft |
| ValidationMessages | FormItem 的验证消息 | String[] | -- |
| AdditionalAttributes | 属性获取或设置将应用于所创建元素的附加属性的集合。 | IReadOnlyDictionary<String, Object> | -- |
| Value | 属性获取或设置输入的值。这应该与双向绑定一起使用。 | String | -- |
| ValueExpression | 属性标识绑定值的表达式。 | Expression<Func<String>> | -- |
| ValuesExpression | 属性标识可枚举绑定值的表达式。 | Expression<Func<IEnumerable<String>>> | -- |
| Size | 属性The size of the input box. Note: in the context of a form, `InputSize.Large` is used. Available: `InputSize.Large` `InputSize.Default` `InputSize.Small` | InputSize | InputSize.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 | 如果覆盖需要重新定位，则文档边界是用于计算的边界。因此，即使覆盖在视口之外，只要不“溢出”文档边界，覆盖仍可能显示。 |