如何修改.NET MAUI Community Toolkit Popup的黑色透明背景？

Community Toolkit的Popup本身没有直接修改背景遮罩的属性，确实需要针对Android和iOS分别做平台定制：

Android平台 #

• 方式一：通过主题修改
  打开Android项目的Resources/values/styles.xml，添加或修改Popup对应的主题样式，禁用背景遮罩或调整透明度：

  <style name="CustomPopupTheme" parent="Theme.Maui">
      <!-- 完全禁用遮罩 -->
      <item name="android:backgroundDimEnabled">false</item>
      <!-- 或者调整遮罩透明度，0=完全透明，1=全黑 -->
      <!-- <item name="android:backgroundDimAmount">0.0</item> -->
  </style>
  

• 方式二：在Popup代码后台动态修改
  在自定义Popup的代码中，通过Handler获取Android原生PopupWindow对象，直接设置背景和遮罩：

  public partial class MyCustomPopup : Popup
  {
      public MyCustomPopup() => InitializeComponent();
  
      protected override void OnHandlerChanged()
      {
          base.OnHandlerChanged();
          if (Handler is PopupHandler handler && handler.PlatformView is AndroidX.AppCompat.Widget.PopupWindow window)
          {
              window.SetBackgroundDrawable(new Android.Graphics.Drawables.ColorDrawable(Android.Graphics.Color.Transparent));
              window.SetDimAmount(0.0f);
          }
      }
  }
  

iOS平台 #

• 方式一：在Popup代码后台修改
  同样在自定义Popup的OnHandlerChanged方法中，找到iOS原生的背景遮罩视图并设置为透明：

  protected override void OnHandlerChanged()
  {
      base.OnHandlerChanged();
      if (Handler is PopupHandler handler && handler.PlatformView is UIKit.UIView platformView)
      {
          // 定位遮罩视图（Community Toolkit默认标记遮罩Tag为1000）
          var backgroundMask = platformView.Superview?.Subviews.FirstOrDefault(v => v.Tag == 1000);
          backgroundMask?.SetBackgroundColor(UIKit.UIColor.Clear);
      }
  }
  

• 方式二：全局自定义Handler
  如果需要所有Popup都生效，注册自定义的PopupHandler：

  public class CustomPopupHandler : PopupHandler
  {
      protected override void ConnectHandler(UIKit.UIView platformView)
      {
          base.ConnectHandler(platformView);
          var backgroundMask = platformView.Superview?.Subviews.FirstOrDefault(v => v.Tag == 1000);
          backgroundMask?.SetBackgroundColor(UIKit.UIColor.Clear);
      }
  }
  
  // 在MauiProgram.cs中注册
  builder.ConfigureMauiHandlers(handlers =>
  {
      handlers.AddHandler<Popup, CustomPopupHandler>();
  });
  

注意点 #

• 确保使用的Community Toolkit版本≥5.0.0，不同版本的原生视图结构可能有差异
• 测试时覆盖不同版本的Android/iOS系统，部分旧系统可能需要微调适配代码

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