Xamarin.Forms.InputKit SelectionView动态生成原理:运行时从ItemsSource生成控件列表全解析

原创2026-11-16 22:37:272,313 阅读

Xamarin.Forms.InputKit SelectionView动态生成原理:运行时从ItemsSource生成控件列表全解析

在 Xamarin.Forms.InputKit 输入控件库中,SelectionView 动态选择列表无需逐个手写控件——只要绑定一个 ItemsSource 数据源,运行时就会自动生成按钮、单选框或复选框组成的完整控件列表,自动排布行列,并随时响应数据的增删。本文带你走读源码中"数据绑定 → 行列布局 → 控件生成 → 事件与选中状态"的 4 步链路,最后说明如何扩展出自定义控件。🎯

Xamarin.Forms.InputKit SelectionView 运行时动态生成选择控件列表效果

一、为什么 SelectionView 被称为"动态"控件

SelectionView 的本质是一个 Grid 布局容器:

public partial class SelectionView : Grid
  • 它没有"固定条目模板"的概念,数据进来后,为每个数据项即时实例化一个子控件;
  • 生成什么控件由 SelectionType 决定,共 6 种类型(Button / RadioButton / CheckBox 及其多选择变体);
  • 数据源变化时,它会清空全部子控件并整体重建(重建策略),而不是做细粒度的增量 diff。

这正是它和普通选择器的最大区别:选项直接平铺在页面上,还可以用 ColumnNumber(默认 2 列)排成多列网格。

InputKit SelectionView 动态控件列表在 Windows 平台的运行效果

二、ItemsSource 到控件列表的生成流程(4 步)

整个流程集中在 SelectionView.cs 中,先速览四个关键方法:

步骤 方法 职责
① 触发 SetItemsSource ItemsSource 属性变化时订阅集合事件并启动重建
② 重建 UpdateView 清空旧控件,逐项生成新控件列表
③ 布局 SetRowAndColumnDefinitions 动态生成 Grid 行列定义
④ 实例 GetInstance 按 SelectionType 生成具体控件类型

第 1 步:触发——属性变化回调 + 集合变更监听

ItemsSource 是一个标准 BindableProperty,其 propertyChanged 回调会调用 SetItemsSource:

private void SetItemsSource(IList value)
{
    UpdateEvents(value);   // 若是 ObservableCollection 则订阅 CollectionChanged
    UpdateView();         // 启动重建
}

同时 UpdateEvents 会检查数据源是否实现了 INotifyCollectionChanged,是则订阅 CollectionChanged 事件——这意味着你在 ViewModel 里对列表做 Add / Remove 操作后,控件列表会自动重建,不需要任何额外代码。

第 2 步:重建——先清空,再逐项生成

UpdateView 的核心逻辑可以概括为一句话:清空全部子控件 → 为每个数据项创建控件、绑定文本、订阅点击、计算行列并插入:

Children.Clear();                              // 清空旧控件
SetRowAndColumnDefinitions();                  // 重算行列
foreach (var item in ItemsSource)
{
    var _View = GetInstance(item);             // 生成对应控件
    SetTextBinding(_View as View);            // 按 ItemDisplayBinding 绑定文本
    _View.Clicked += Element_Clicked;         // 统一点击处理
    var column = Children.Count % ColumnNumber;   // 计算行列
    var row    = Children.Count / ColumnNumber;
    this.Add(addedView, column, row);
}

其中有两个值得注意的细节:

  • 禁用判断:生成时先用反射读取数据项上 IsDisabledPropertyName(默认 "IsDisabled")指定的属性,为 true 就标记禁用;数据项也可以在 DisabledSource 列表中被批量禁用;
  • 选中态保持:重建完成后会按 SelectedIndex 恢复原有选中状态,因此切换 SelectionType 或数据源时选中状态不会丢失。

第 3 步:布局——动态生成 Grid 行列

SetRowAndColumnDefinitions 用简单的整除运算把数据排成网格:

  • 列定义:生成 ColumnNumber 列,每列 GridLength.Star(等宽);
  • 行定义:生成 ItemsSource.Count / ColumnNumber 行,每行 GridLength.Auto。

所以想做"分段选择器"效果,只需把 ColumnNumber 设为 3:

InputKit SelectionView 通过 ColumnNumber 生成的三列选项控件

第 4 步:实例——一个 switch 生成 6 种控件

GetInstance 决定了每个选项的"长相":

SelectionType 枚举值 生成的控件 选择行为
Button(默认) 1 SelectableButton 单选
RadioButton 3 SelectableRadioButton 单选
CheckBox 2 SelectableCheckBox 多选
MultipleButton 4 SelectableButton 多选
SingleCheckBox 5 SelectableCheckBox 单选
MultipleRadioButton 6 SelectableRadioButton 多选

三种内置控件(SelectableButton / SelectableRadioButton / SelectableCheckBox)都实现了统一接口 ISelection,它只定义了 IsSelected、Value、IsDisabled 和 Clicked 事件——外层 SelectionView 因此完全不关心具体控件类型,就能统一读写选中状态。

三、单选还是多选?枚举奇偶值的巧妙设计

Element_Clicked 里有这样一个判断:

if ((int)SelectionType % 2 == 0)   // 偶数 = 多选

对照上表的枚举值就明白了:奇数(1/3/5)是单选型,偶数(2/4/6)是多选型,枚举值本身就是"选择模式"的编码。点击某个选项后:

  • 单选:直接回写 SelectedItem 与 SelectedIndex;
  • 多选:维护 SelectedItems 集合(首次点击时自动创建对应泛型的 ObservableCollection),并回写 SelectedIndexes。

ViewModel 只需双向绑定 SelectedItem(单选)或 SelectedItems(多选),就能与控制状态保持同步。

InputKit SelectionView 使用 IsDisabled 属性禁用部分选项的生成效果

四、常见用法:4 行 XAML 搞定动态列表

官方示例工程 SelectionViewPage 用 4 行 XAML 就完成了一个动态列表:

<input:SelectionView
    ColumnNumber="2"
    ItemDisplayBinding="{Binding Name}"
    ItemsSource="{Binding Items}"
    SelectionType="Button" />

数据项只需一个普通模型类(示例中重写了 ToString(),见 SampleItem.cs),复杂类型则通过 ItemDisplayBinding="{Binding Name}" 指定显示属性。示例页面还能通过 Picker 在运行时随意切换 6 种 SelectionType(定义见 Enums.cs),每次切换都触发一次完整重建——这正是"动态"二字的含义。🔁

五、扩展:生成你自己的控件

GetInstance 是 protected virtual 方法,内置类型不满足需求时可以:

  1. 编写一个实现 ISelection 的控件(例如自定义开关、图标按钮);
  2. 继承 SelectionView,重写 GetInstance 返回你的控件实例;
  3. 在 XAML 中照常绑定 ItemsSource 即可。

生成流程、行列布局、禁用判断和选中事件体系全部复用,你只需关心控件本身的样式。完整步骤参考官方文档 SelectionView.md。

六、总结

  • 数据驱动:ItemsSource 是唯一数据源,控件列表完全由它生成;
  • 重建策略:数据一变就清空 Children 重新生成,逻辑简单直接,易于理解;
  • 奇偶编码:用枚举值的奇偶区分单选/多选,小而精巧;
  • 可扩展:实现 ISelection + 重写 GetInstance,即可生成任意可选控件。

理解了这条链路后,绑定任何 IList 到 ItemsSource,你就能在运行时看到一份自动生成的动态控件列表。✨

登录后查看全文
Xamarin.Forms.InputKit