Xamarin iOS如何确保Entry聚焦时不被弹出的键盘遮挡

核心逻辑为监听键盘弹出/收起系统通知，计算获得焦点的Entry在全局屏幕的绝对坐标，判断是否被键盘遮挡，若遮挡则调整容器偏移量将控件移动到可视区域。 #

1. 监听键盘系统通知 #

iOS提供了键盘状态变化的全局通知，直接在iOS平台层注册即可：

• 键盘即将弹出通知：UIKeyboard.WillShowNotification
• 键盘即将收起通知：UIKeyboard.WillHideNotification
  示例平台代码如下：

// 声明通知监听对象，避免销毁时无法释放
private NSObject _keyboardShowObserver;
private NSObject _keyboardHideObserver;

// 页面加载时注册通知
public override void ViewDidLoad()
{
    base.ViewDidLoad();
    
    // 监听键盘弹出
    _keyboardShowObserver = UIKeyboard.Notifications.ObserveWillShow((sender, args) =>
    {
        // 从通知参数获取键盘高度
        var keyboardHeight = args.FrameEnd.Height;
        // 执行位置调整逻辑
        AdjustEntryPosition(keyboardHeight, args.AnimationDuration);
    });
    
    // 监听键盘收起
    _keyboardHideObserver = UIKeyboard.Notifications.ObserveWillHide((sender, args) =>
    {
        // 恢复容器原有位置
        ResetContainerPosition(args.AnimationDuration);
    });
}

// 页面销毁时移除监听，防止内存泄漏
public override void ViewWillDisappear(bool animated)
{
    base.ViewWillDisappear(animated);
    if (_keyboardShowObserver != null)
        NSNotificationCenter.DefaultCenter.RemoveObserver(_keyboardShowObserver);
    if (_keyboardHideObserver != null)
        NSNotificationCenter.DefaultCenter.RemoveObserver(_keyboardHideObserver);
}

2. 判断Entry可视状态并调整位置 #

将Entry的坐标转换为全局窗口坐标系下的位置，和键盘顶部位置对比判断是否被遮挡：

private void AdjustEntryPosition(nfloat keyboardHeight, double animationDuration)
{
    // 获取当前获得焦点的Entry控件（可自行实现遍历逻辑查找聚焦的Entry）
    var focusedEntry = GetCurrentFocusedEntry();
    if (focusedEntry == null) return;
    
    // 将Entry的相对坐标转换为全局UIWindow下的绝对坐标
    var entryGlobalFrame = focusedEntry.ConvertRectToView(focusedEntry.Bounds, UIApplication.SharedApplication.KeyWindow);
    // Entry底部Y坐标
    var entryBottomY = entryGlobalFrame.Y + entryGlobalFrame.Height;
    // 键盘顶部Y坐标
    var keyboardTopY = UIScreen.MainScreen.Bounds.Height - keyboardHeight;
    
    // Entry底部低于键盘顶部，说明被遮挡
    if (entryBottomY > keyboardTopY)
    {
        // 计算需要上移的偏移量，额外加10px避免控件贴住键盘边缘
        var offset = entryBottomY - keyboardTopY + 10;
        // 执行动画调整容器位置，和键盘弹出动画同步
        UIView.Animate(animationDuration, () =>
        {
            // 可根据需求调整根视图或者Entry所在ContentView的位置
            // 若使用MAUI/Xamarin.Forms，也可以直接设置ContentView的TranslationY属性实现偏移
            View.Frame = new CGRect(View.Frame.X, -offset, View.Frame.Width, View.Frame.Height);
        });
    }
}

private void ResetContainerPosition(double animationDuration)
{
    UIView.Animate(animationDuration, () =>
    {
        View.Frame = new CGRect(0, 0, View.Frame.Width, View.Frame.Height);
    });
}

注意事项 #

• 坐标计算必须转换为全局窗口坐标系，使用父容器相对坐标会出现计算偏差
• 偏移调整动画时长要和键盘动画时长保持一致，避免出现生硬跳转
• 如果不需要调整整个页面，仅需要调整Entry所在的ContentView，将上述调整Frame的逻辑替换为对应ContentView的位置调整即可

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