在华为HarmonyOS的世界里，我们常常会遇到这样的问题：软键盘突然弹起，不仅遮挡了重要的输入框，还可能导致整个页面布局错乱，让人措手不及。但别担心，今天就让我们一起揭开ArkUI框架如何巧妙解决这个软键盘弹起顶起页面问题的神秘面纱。

一、组件设置中的expandSafeArea属性

在Stack布局中，当宽高都设置为100%时，软键盘弹起确实会顶起页面。但别急，ArkUI框架为我们提供了完美的解决方案——使用expandSafeArea属性！这个属性可以让你轻松控制组件的安全区域，实现软键盘的避让。

例如，在方舟UI框架（ArkUI）中，你可以这样设置：

@Component struct AvoidDialogPage {
  @Statemessage = '打开弹窗';
  final dialogController = CustomDialogController(builder: CustomDialogExample());

  Row() {
    Column() {
      Text(this.message)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .onClick(() => this.dialogController.open());
      .width('100%')
        .height('100%');
    }
    .width('100%')
    .height('100%');
  }
}

@CustomDialogstruct
CustomDialogExample {
  final controller = CustomDialogController(builder: CustomDialogExample({}));

  Column() {
    TextInput(
      expandSafeArea: [SafeAreaType.KEYBOARD, SafeAreaType.SYSTEM],
      borderWidth: 0.5,
      borderRadius: 4,
      height: 40,
      defaultFocus: true,
      margin: EdgeInsets.only(top: 30, left: 16, right: 16),
    );
  }
}

在这个例子中，expandSafeArea属性确保了软键盘弹起时，页面布局不会发生改变，输入框依然可见且可交互。

二、键盘避让的另一种模式

除了expandSafeArea属性，你还可以设置键盘的KeyboardAvoidMode值为RESIZE。但请注意，在这种模式下，expandSafeArea设置将不起作用。这时，你可以考虑使用三方库或系统原生方法来实现键盘避让。

例如，使用系统原生方法：

import { KeyboardAvoidMode } from '@kit.ArkUI';
onWindowStageCreate(windowStage) {
  windowStage.loadContent('pages/Index', (err, data) {
    let keyboardAvoidMode = windowStage.getMainWindowSync().getUIContext().getKeyboardAvoidMode();
    windowStage.getMainWindowSync().getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);
    if (err.code) {
      hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
      return;
    }
    hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
  });
}

三、总结

在华为HarmonyOS的世界里，软键盘弹起顶起页面问题并不是不可解决的难题。通过合理使用ArkUI框架中的expandSafeArea属性，结合系统原生方法，你可以轻松实现软键盘的避让，确保页面布局的稳定性和用户体验的流畅性。希望这篇文章能为你带来一些启发和帮助，让你在鸿蒙开发的世界里更加游刃有余！