Xamarin Forms自定义渲染器的IsVisible控件属性处理问题

我来分享下我实现这个全局上层自定义提示框的思路和具体做法，目前是针对iOS平台用Custom Renderer搞定的：

核心逻辑梳理 #

• 自定义控件基础：先封装一个继承自Frame的Xamarin Forms自定义控件，它作为提示框的基础容器，后续完全通过IsVisible属性来触发显示/隐藏操作。
• 原生层级挂载：在iOS的Custom Renderer中监听控件的IsVisible状态变化，一旦触发显示，就把对应的原生容器视图添加到应用的根视图层级，这样就能保证它显示在所有页面内容的最上层。

关键代码示例 #

1. Xamarin Forms端自定义控件 #

public class GlobalToast : Frame
{
    // 自定义绑定属性，用于传递提示文本（可根据需求扩展其他样式属性）
    public static readonly BindableProperty MessageProperty =
        BindableProperty.Create(nameof(Message), typeof(string), typeof(GlobalToast), string.Empty);

    public string Message
    {
        get => (string)GetValue(MessageProperty);
        set => SetValue(MessageProperty, value);
    }
}

2. iOS端Custom Renderer实现 #

[assembly: ExportRenderer(typeof(GlobalToast), typeof(GlobalToastRenderer))]
namespace YourAppNamespace.iOS.Renderers
{
    public class GlobalToastRenderer : FrameRenderer
    {
        private UIView _nativeToastView;
        private UIWindow _currentRootWindow;

        protected override void OnElementChanged(ElementChangedEventArgs<Frame> e)
        {
            base.OnElementChanged(e);

            if (e.NewElement != null)
            {
                // 获取当前根窗口（iOS13+适配多场景情况）
                _currentRootWindow = UIApplication.SharedApplication.ConnectedScenes
                    .OfType<UIWindowScene>()
                    .FirstOrDefault()?
                    .Windows
                    .FirstOrDefault(w => w.IsKeyWindow) ?? UIApplication.SharedApplication.KeyWindow;

                // 创建原生提示视图并设置基础样式
                _nativeToastView = new UIView
                {
                    BackgroundColor = UIColor.Black.ColorWithAlpha(0.7f),
                    Layer = { CornerRadius = 8 }
                };

                // 添加提示文本标签
                var messageLabel = new UILabel
                {
                    Text = ((GlobalToast)Element).Message,
                    TextColor = UIColor.White,
                    TextAlignment = UITextAlignment.Center,
                    Lines = 0,
                    Font = UIFont.SystemFontOfSize(15)
                };
                _nativeToastView.AddSubview(messageLabel);

                // 用AutoLayout设置文本标签的约束
                messageLabel.TranslatesAutoresizingMaskIntoConstraints = false;
                NSLayoutConstraint.ActivateConstraints(new[]
                {
                    messageLabel.LeadingAnchor.ConstraintEqualTo(_nativeToastView.LeadingAnchor, 16),
                    messageLabel.TrailingAnchor.ConstraintEqualTo(_nativeToastView.TrailingAnchor, -16),
                    messageLabel.TopAnchor.ConstraintEqualTo(_nativeToastView.TopAnchor, 12),
                    messageLabel.BottomAnchor.ConstraintEqualTo(_nativeToastView.BottomAnchor, -12)
                });
            }
            else
            {
                // 控件销毁时清理原生视图，避免内存泄漏
                _nativeToastView?.RemoveFromSuperview();
                _nativeToastView?.Dispose();
            }
        }

        protected override void OnElementPropertyChanged(object sender, PropertyChangedEventArgs e)
        {
            base.OnElementPropertyChanged(sender, e);

            // 监听IsVisible属性变化
            if (e.PropertyName == VisualElement.IsVisibleProperty.PropertyName)
            {
                var formsToast = (GlobalToast)Element;
                if (formsToast.IsVisible)
                {
                    // 更新提示文本（如果有动态修改的需求）
                    ((UILabel)_nativeToastView.Subviews.First()).Text = formsToast.Message;
                    // 将原生视图添加到根窗口最上层
                    _currentRootWindow.AddSubview(_nativeToastView);
                    // 设置提示框的位置（示例为居中显示）
                    _nativeToastView.TranslatesAutoresizingMaskIntoConstraints = false;
                    NSLayoutConstraint.ActivateConstraints(new[]
                    {
                        _nativeToastView.CenterXAnchor.ConstraintEqualTo(_currentRootWindow.CenterXAnchor),
                        _nativeToastView.CenterYAnchor.ConstraintEqualTo(_currentRootWindow.CenterYAnchor),
                        _nativeToastView.WidthAnchor.ConstraintLessThanOrEqualTo(_currentRootWindow.WidthAnchor, multiplier: 0.8f)
                    });
                    // 添加淡入动画提升体验
                    _nativeToastView.Alpha = 0;
                    UIView.Animate(0.3f, () => _nativeToastView.Alpha = 1);
                }
                else
                {
                    // 淡出后移除视图
                    UIView.Animate(0.3f, () => _nativeToastView.Alpha = 0, () => _nativeToastView.RemoveFromSuperview());
                }
            }
        }
    }
}

使用方式（代码后台创建） #

// 初始化提示框
var globalToast = new GlobalToast
{
    Message = "这是一个全局上层的自定义提示框",
    IsVisible = false
};

// 触发显示
globalToast.IsVisible = true;

// 2秒后自动隐藏
Device.StartTimer(TimeSpan.FromSeconds(2), () =>
{
    globalToast.IsVisible = false;
    return false;
});

额外注意事项 #

• 根窗口获取逻辑已经适配iOS13+的多场景情况，避免在iPad分屏等场景下出现窗口获取错误。
• 记得在控件销毁时清理原生视图，防止内存泄漏。
• 动画效果、提示框样式（比如背景色、圆角、位置）都可以根据需求自行调整。

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