用途
本技能用于在 .NET MAUI 应用中实现 Syncfusion 分段控件(SfSegmentedControl)。该控件提供一组线性排列的分段,每个分段可包含文本、图标或两者组合,用户可在互斥选项中进行选择。每个分段相当于一个独立按钮,适合在视图之间切换、筛选内容或选择时间段。
主要能力
- 多种显示格式:文本、图标或文本与图标组合。
- 四种选择指示器样式:Fill、Border、TopBorder、BottomBorder。
- 分段数量较多时可滚动。
- 两种选择模式:Single、SingleDeselect。
- 外观定制:边框颜色与粗细、圆角、文本样式、分段背景色、分隔符可见性等。
- 支持禁用单个分段。
- 支持 RTL(从右到左)布局。
- 支持涟漪(Ripple)动画效果。
- 支持 DataTemplate 自定义布局,并可通过 IsSelected 绑定定制选中项模板。
- 布局配置:分段宽度、高度、可见分段数量、滚动行为、自动尺寸与固定尺寸。
- 事件:SelectionChanged、SegmentTapped。
使用方式
包:Syncfusion.Maui.Toolkit 命名空间:Syncfusion.Maui.Toolkit.SegmentedControl 控件类:SfSegmentedControl
基本步骤(依据资料):
- 安装 Syncfusion.Maui.Toolkit NuGet 包。
- 注册 Syncfusion 处理程序(ConfigureSyncfusionToolkit)。
- 在 XAML 或 C# 中初始化控件。
- 通过 ItemsSource(字符串数组)或 SfSegmentItem 对象填充分段项,可设置文本、图标或两者组合。
- 通过 SelectedIndex 进行程序化选择,并配置选择指示器位置与选择模式。
- 按需定制外观、布局、禁用分段,并处理 SelectionChanged 与 SegmentTapped 事件。
资料中提供了按主题划分的参考文档:getting-started.md(入门设置)、populating-items.md(填充分段项)、selection.md(选择功能)、customization.md(外观定制)、layout.md(布局配置)、disabled-segments.md(禁用分段)、events.md(事件)、advanced-features.md(高级功能,含 RTL 与平台注意事项)。
适用场景
- 视图切换器:在 Day/Week/Month/Year 视图、列表/网格布局或不同数据可视化之间切换。
- 筛选按钮:按类别、类型或时间段筛选内容。
- 类标签导航:不依赖传统标签页的分段式导航。
- 选择界面:在 2 至 7 个互斥选项中进行选择。
- 常见场景:日历视图切换、图表周期选择器、排序选项、显示模式切换、类别筛选、设置开关。
限制
资料未提供关于收费、价格、平台支持范围、性能指标或具体版本要求的信息,暂未提供。