Xamarin.Forms 5版本中CollectionView绑定IsVisible属性iOS15异常问题

问题原因 #

Xamarin.Forms 5.x 针对iOS 14及以上系统的RefreshView渲染逻辑存在已知缺陷：当从CollectionView内部的手势识别器回调中修改RefreshView的IsVisible属性时，iOS端的手势事件RunLoop模式会阻塞属性变更的UI渲染通知，导致IsVisible修改不生效，Android端和低版本XF没有该逻辑问题。

解决方案（按优先级排序） #

方案1：外层嵌套容器绑定IsVisible（最便捷，无侵入）

在RefreshView外层套一层空的ContentView或StackLayout，将IsVisible绑定从RefreshView移动到外层容器上，原有逻辑无需修改即可生效。
代码示例：

<!-- 新增外层容器 -->
<ContentView IsVisible="{Binding isSearchResultVisible, Mode=TwoWay}">
    <RefreshView x:DataType="local:ViewModel" Command="{Binding searchItems}"  >
        <!-- 原有CollectionView代码完全不变 -->
        <CollectionView HeightRequest="{Binding searchZoneHeight}"  x:Name="ItemsList"
            ItemsSource="{Binding searchResultItems}"
            SelectionMode="None" >
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <StackLayout  Padding="10" x:DataType="model:Item" >
                        <Label Text="{Binding Text}" 
                            Style="{DynamicResource ListItemTextStyle}" 
                            FontSize="16" />
                        <StackLayout.GestureRecognizers>
                            <TapGestureRecognizer 
                                NumberOfTapsRequired="1"
                                Command="{Binding Source={RelativeSource AncestorType={x:Type local:ViewModel}}, Path=ItemTapped}"      
                                CommandParameter="{Binding .}">
                            </TapGestureRecognizer>
                        </StackLayout.GestureRecognizers>
                    </StackLayout>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </RefreshView>
</ContentView>

方案2：强制UI主线程触发属性变更

将IsVisible的赋值和属性通知逻辑包裹在Device.BeginInvokeOnMainThread中，强制其在UI主线程的默认RunLoop模式下执行，避开手势事件的RunLoop阻塞问题。
修改后的ViewModel代码：

async void OnItemSelected(Item item)
{
    Debug.WriteLine("Search result was tapped " + item.Text);
    searchText = item.Text;
    // 强制UI线程执行属性变更
    Device.BeginInvokeOnMainThread(() => 
    {
        isSearchResultVisible = false;
        OnPropertyChanged(nameof(isSearchResultVisible));
    });
}

方案3：自定义iOS端RefreshView渲染器（仅在前两种方案不生效时使用）

如果需要直接在RefreshView上绑定IsVisible，可以自定义iOS端的RefreshViewRenderer，重写属性变更回调，手动控制视图的Hidden属性：

[assembly: ExportRenderer(typeof(RefreshView), typeof(CustomRefreshViewRenderer))]
namespace YourNamespace.iOS.Renderers
{
    public class CustomRefreshViewRenderer : RefreshViewRenderer
    {
        protected override void OnElementPropertyChanged(object sender, PropertyChangedEventArgs e)
        {
            base.OnElementPropertyChanged(sender, e);
            if (e.PropertyName == nameof(RefreshView.IsVisible))
            {
                Hidden = !Element.IsVisible;
                Superview?.SetNeedsLayout();
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者user1202278