Visual glitch occurs during keyboard (IME) animations

[erisu]

Bug Report

Problem

A brief visual glitch occurs during keyboard (IME) animations where the app background becomes visible temporarily.

This appears to have been introduced in #1924, which was resolving an issue where the WebView was not fully scrollable when the IME keyboard was open.

Based on initial investigation, the behavior may be related to the WebView being resized while the IME is still animating, which can temporarily expose the underlying window background.

The issue is more noticeable when there is a strong contrast between the app's background and the web content's (for example, a light web page background over a dark application background defined via configuration preferences).

What is expected to happen?

During the keyboard animations, the WebView should remain fully visible.

What does actually happen?

During the keyboard animations, the app's background is briefly visible, which appears as a visual glitch.

Information

• Create a long page with multiple input elements (so the page is scrollable).
  • This step may not be necessary to reproduce the visual glitch, but it is important when addressing the issue as we need to continue to ensure the WebView remains scrollable and can reach the bottom of the page (rather than being hidden by the IME).
• Set the web page's background to a light color (e.g. white).
• Set the application background color to a dark color using config.xml:

<preference name="BackgroundColor" value="#000000" />

• Build and run the application on an Android device.
• Focus on an input field to trigger opening of the keyboard.

Environment, Platform, Device

I used the following emulator:

• Android SDK 24

Version information

Cordova Packages:

    cli: 13.0.0
        common: 6.0.0
        create: 6.0.0
        lib: 13.0.0
            common: 6.0.0
            fetch: 5.0.0

Project Installed Platforms:

    android: 15.0.1-dev.0

Project Installed Plugins:


Environment:

    OS: Tahoe 26.4.1 (25E253) (darwin 25.4.0) arm64
    Node: v24.13.0
    npm: 11.6.2

Note

android: 15.0.1-dev.0 is current master branch.

The app was launched from Android Studio Panda 4 | 2025.3.4.

Checklist

• I searched for existing GitHub issues
• I updated all Cordova tooling to most recent version
• I included all the necessary information above

[gabriel2mm]

The behavior is similar to what already existed in Cordova 14. However, in the previous version, the background shown during keyboard animations matched the device navigation bar color. In this version, we noticed a change due to the edge-to-edge behavior introduced by Android.

Since the WebView spacing is now being handled manually, it is expected that the app background may become visible while the view is being resized.

Below is a comparison between Cordova 14 and Cordova 15.0.1-dev.0.

Cordova 14	Cordova 15

the difference:

Cordova 14	Cordova 15

I believe this behavior was not necessarily introduced by the PR itself, but rather became more noticeable after the scroll fix.