MAUI 输入框被软键盘遮挡需分平台处理:Android 推荐 WindowSoftInputModeAdjust.Resize 或 Pan 模式;iOS 需监听键盘通知动态调整 Padding;通用技巧包括滚动到可视区、底部固定定位及定制 IME 操作键。

MAUI 中输入框被软键盘遮挡,本质是窗口未响应键盘弹出时的尺寸变化。处理核心就两点:让系统知道怎么调整窗口,或让页面内容主动“让位”。iOS 和 Android 的机制不同,但都有成熟、轻量的官方方案。
Android:用 WindowSoftInputModeAdjust 控制窗口行为
这是最推荐的起点,无需写平台特定代码,一行配置就能生效。
- Resize 模式(表单类首选):键盘弹出时,自动压缩应用窗口高度,确保输入框始终在可视区。适合登录页、设置页等结构清晰的页面。
在App.xaml.cs的OnLaunched或构造函数中添加:
Application.Current.On
- Pan 模式(全屏 / 游戏类适用):不压缩窗口,而是把整个内容区域向上平移,露出当前焦点输入框。适合 视频播放器、聊天界面等对布局完整性要求高的场景:
Application.Current.On().SetWindowSoftInputModeAdjust(WindowSoftInputModeAdjust.Pan);
iOS:监听 键盘事件 + 动态调整布局
iOS 不支持全局窗口模式切换,需手动响应键盘通知。关键在于监听 UIKeyboardWillShowNotification 和 UIKeyboardWillHideNotification,然后修改容器的 Padding 或 TranslationY。
- 在页面后台代码(如
ContentPage的OnAppearing)中注册监听; - 获取键盘高度(从通知的
UIKeyboardFrameEndUserInfoKey中解析); - 给外层
ScrollView或StackLayout增加底部Padding,值等于键盘高度; - 收起键盘时,把
Padding设回 0。
注意:务必在 OnDisappearing 中注销通知,避免内存泄漏。
通用技巧:增强输入框自身表现
除了窗口级调整,还可从控件层面优化体验:
- 聚焦后滚动到可视区:对
Entry或Editor绑定Focused事件,在Dispatcher.DispatchAsync中调用ScrollToAsync(需外层是ScrollView); - 底部输入框 固定定位:聊天场景常用,把输入框容器设为
VerticalOptions="End",再配合Margin或TranslationY动态避让; - 键盘操作键定制:比如搜索框配
Search键,发送消息配Send键,提升操作效率:
entry.On().SetImeOptions(ImeFlags.Search);
基本上就这些。优先试 Resize,不行再补监听逻辑,iOS 部分写一次可封装复用。不复杂但容易忽略的是生命周期管理——注册了通知就得注销,设置了动态 Padding 就得重置。






























