ArkUI Subsystem Changelog

OpenHarmony 4.1.6.1 has the following changes in the <Navigation>, <NavDestination>, and <Tabs> components.

cl.arkui.1 Expansion of the <Navigation> and <NavDestination> Components to the Non-Safe Area

When conditions permit, the <Navigation> and <NavDestination> components are expanded to the non-safe area by default.

Access Level

Public

Change Impact

Before change: The expandSafeArea attribute of the <Navigation> and <NavDestination> components is defaulted to [SafeAreaExpandType.NONE, SafeAreaExpandEdges.NONE].

After change: The expandSafeArea attribute of the <Navigation> and <NavDestination> components is defaulted to [SafeAreaExpandType.SYSTEM, SafeAreaExpandEdges.BOTTOM, SafeAreaEdge.TOP], meaning that the components' background color is expanded to the status bar and navigation bar.

API Level

Change Since

OpenHarmony SDK 4.1.6.1

Key API/Component Changes

<Navigation> and <NavDestination> components

Adaptation Guide

If margin is set for the <Navigation> or <NavDestination> component, there would be space between the component and the status bar or navigation bar. As a result, the component cannot be expanded to the non-safe area. To create an immersive experience for the application, change margin to padding to remove the space between the component and the status bar and navigation bar. The code example is as follows:

Before adaptation:

@Entry
@Component
struct NavigationExample {
  build() {
    NavDestination() {
        ...
    }.margin({...})
  }
}

After adaptation:

@Entry
@Component
struct NavigationExample {
  build() {
    NavDestination() {
        ...
    }.padding({...})
  }
}

cl.arkui.1 Expansion of the <Tabs> Component to the Bottom Non-Safe Area

When conditions permit, the <Tabs> component is expanded to the bottom non-safe area by default.

Access Level

Public

Change Impact

Before change: The expandSafeArea attribute of the <Tabs> component is defaulted to [SafeAreaExpandType.NONE, SafeAreaExpandEdges.NONE].

Before change: The expandSafeArea attribute of the <Tabs> component is defaulted to [SafeAreaExpandType.SYSTEM, SafeAreaExpandEdges.BOTTOM], meaning that the components' background color is expanded to the bottom navigation bar.

API Level

Change Since

OpenHarmony SDK 4.1.6.1

Key API/Component Changes

<Tabs> component

Adaptation Guide

The component can deliver an immersive experience at its default settings, and no adaptation is required.

cl.arkui.3 Change to the Default Value of the autoResize and interpolation Attributes of the <Image> Component

Access Level

Public

Reason for Change

This change is to solve the image aliasing issue.

Change Impact

This change is a non-compatible change.

Before change: The <Image> component's autoResize attribute is defaulted to true and the interpolation attribute None.

After change: The <Image> component's autoResize attribute is defaulted to false and the interpolation attribute LOW. This change enhances the component's visual appeal. Yet, it may increase the memory usage if the contained image is large, in which case you need to take memory optimization measures. Note: This change does not affect the component's display on the large home screen.

API Level

Change Since

OpenHarmony SDK 4.1.6.1

Key API/Component Changes

<Image> component

Adaptation Guide

This change is about the default settings, and no adaptation is required. To change the component to its original default display effect, set autoResize to true and interpolation to None.