Xamarin.Forms.InputKit SelectionView动态生成原理:运行时从ItemsSource生成控件列表全解析
Xamarin.Forms.InputKit SelectionView动态生成原理:运行时从ItemsSource生成控件列表全解析
在 Xamarin.Forms.InputKit 输入控件库中,SelectionView 动态选择列表无需逐个手写控件——只要绑定一个 ItemsSource 数据源,运行时就会自动生成按钮、单选框或复选框组成的完整控件列表,自动排布行列,并随时响应数据的增删。本文带你走读源码中"数据绑定 → 行列布局 → 控件生成 → 事件与选中状态"的 4 步链路,最后说明如何扩展出自定义控件。🎯
一、为什么 SelectionView 被称为"动态"控件
SelectionView 的本质是一个 Grid 布局容器:
public partial class SelectionView : Grid
- 它没有"固定条目模板"的概念,数据进来后,为每个数据项即时实例化一个子控件;
- 生成什么控件由
SelectionType决定,共 6 种类型(Button / RadioButton / CheckBox 及其多选择变体); - 数据源变化时,它会清空全部子控件并整体重建(重建策略),而不是做细粒度的增量 diff。
这正是它和普通选择器的最大区别:选项直接平铺在页面上,还可以用 ColumnNumber(默认 2 列)排成多列网格。
二、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:
第 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(多选),就能与控制状态保持同步。
四、常见用法: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 方法,内置类型不满足需求时可以:
- 编写一个实现 ISelection 的控件(例如自定义开关、图标按钮);
- 继承
SelectionView,重写GetInstance返回你的控件实例; - 在 XAML 中照常绑定
ItemsSource即可。
生成流程、行列布局、禁用判断和选中事件体系全部复用,你只需关心控件本身的样式。完整步骤参考官方文档 SelectionView.md。
六、总结
- 数据驱动:
ItemsSource是唯一数据源,控件列表完全由它生成; - 重建策略:数据一变就清空
Children重新生成,逻辑简单直接,易于理解; - 奇偶编码:用枚举值的奇偶区分单选/多选,小而精巧;
- 可扩展:实现
ISelection+ 重写GetInstance,即可生成任意可选控件。
理解了这条链路后,绑定任何 IList 到 ItemsSource,你就能在运行时看到一份自动生成的动态控件列表。✨



