Avalonia可通过TextBox+Popup+ListBox组合实现可搜索ComboBox：监听TextBox输入实时过滤数据，Popup内ListBox展示匹配项，支持键盘导航、回车选择及失焦/ESC关闭。
Avalonia 本身没有内置的可搜索 ComboBox，但可以通过组合 TextBox、ListBox 和数据绑定 + 过滤逻辑，手动实现一个功能完整的“可搜索下拉框”。核心思路是：用文本框输入触发实时过滤，用弹出面板（如 Popup）展示匹配项，支持键盘导航和回车选择。
1. 使用 TextBox + Popup + ListBox 模拟可搜索下拉
这是最常用且可控性最强的方式。结构大致如下：
-
主区域：一个只读
TextBox（显示当前选中值，点击时聚焦并展开下拉） -
下拉层：用
Popup包裹ListBox，绑定过滤后的数据源 -
搜索逻辑：监听
TextBox.Text变化，用ICollectionView或ObservableCollection<T>+ LINQ 动态过滤 - 交互支持：按上下键在列表中移动焦点，回车/鼠标点击确认选择，失焦或 Esc 关闭弹窗
2. 关键 XAML 结构示例
以下是一个简化但可运行的布局片段（需配合 ViewModel）：
<StackPanel>
<TextBox x:Name="SearchBox"
Text="{Binding SearchText, UpdateSourceTrigger=PropertyChanged}"
GotFocus="OnTextBoxGotFocus" />
<Popup x:Name="DropdownPopup"
IsOpen="{Binding IsDropdownOpen}"
PlacementMode="Bottom"
StaysOpen="False">
<Border Background="#FFFFFF" BorderBrush="#CCCCCC" BorderThickness="1">
<ListBox ItemsSource="{Binding FilteredItems}"
SelectedItem="{Binding SelectedItem, Mode=TwoWay}"
ScrollViewer.VerticalScrollBarVisibility="Auto">
<ListBox.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding DisplayName}" />
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>
</Border>
</Popup>
</StackPanel>
3. ViewModel 中的关键逻辑（C#）
重点在于响应式过滤与状态同步：
- 定义
SearchText属性，setter 中触发FilterItems() -
FilteredItems是一个ReadOnlyObservableCollection<T>或用ICollectionView（推荐Avalonia.Collections.AvaloniaList<T>+ 手动刷新） - 每次过滤后调用
NotifyOfPropertyChange(nameof(FilteredItems)) -
SelectedItem改变时，自动更新SearchText并关闭弹窗 - 为支持键盘操作，在代码后台处理
KeyDown：Esc 关闭、Enter 选中高亮项、上下键移动 ListBox 选中项
4. 进阶建议：封装成自定义控件
若项目中多处使用，建议封装为 SearchableComboBox 控件：
- 继承
TemplatedControl，定义ItemsSource、DisplayMemberPath、SelectedItem等依赖属性 - 内部管理 Popup 生命周期、键盘事件、焦点流转
- 暴露
FilterFunc（Func<object, string, bool>）让调用方自定义匹配逻辑（如支持拼音首字母、模糊匹配等） - 参考开源实现：Avalonia.Controls 中的
ComboBox源码，或社区库如Avalonia.Xaml.Interactions
不复杂但容易忽略的是焦点管理和 Popup 关闭时机——务必处理好 TextBox 失焦、Popup 外部点击、Esc 键这三类场景，否则体验会断开。
