ArkUI Subsystem Changelog

cl.arkui.1 Change in the Default Scrollbar State of <List> and <Gird> Components

Changed the default state of the scrollbar in the <List> and <Gird> components from BarState.Off to BarState.Auto.

Change Impact

In the scenario where the scrollbar status is not set in the <List> and <Gird> components:

  • Before change:

    The scrollbar is not displayed.

  • After change:

    The scrollbar is displayed during scrolling and is hidden 2 seconds after the scrolling stops.

Key API/Component Changes

scrollBar attribute of the <List> and <Gird> components:

Adaptation Guide

In scenarios where the scrollbar is not required, set the scrollBar attribute of the <List> and <Gird> components to BarState.Off.

The code snippet is as follows:

// xxx.ets
@Entry
@Component
struct ListItemExample {
  private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

  build() {
    Column() {
      List({ space: 20, initialIndex: 0 }) {
        ForEach(this.arr, (item) => {
          ListItem() {
            Text('' + item)
              .width('100%').height(100).fontSize(16)
              .textAlign(TextAlign.Center).borderRadius(10).backgroundColor(0xFFFFFF)
          }
        }, item => item)
      }
      .width('90%')
      .scrollBar(BarState.Off)
    }.width('100%').height('100%').backgroundColor(0xDCDCDC).padding({ top: 5 })
  }
}

cl.arkui.2 Change of Effect for When Both Margin and Margin Are Set

When a component has both margin and position attributes set, the settings for both attributes take effect, instead of only the settings of position.

Change Impact

When a component has both margin and position attributes set, it is moved to the specified position with the extra margins.

Key API/Component Changes

margin and position attributes:

Adaptation Guide

If both margin and position are set for a component, or if position is set for a component that has default margin settings (for example, the <Checkbox> component), you are advised to adjust the margin to ensure that the component is in an appropriate position.