harmony 鸿蒙ArkUI子系统Changelog

  • 2025-06-16
  • 浏览 (3)

ArkUI子系统Changelog

cl.arkui.1 废弃gridSpan和gridOffset属性

访问级别

公开接口

废弃原因

gridSpan和gridOffset属性仅设置在gridContaier的子组件上有效,gridContainer组件已废弃。

废弃影响

该变更为接口废弃,开发者需使用替代接口。

废弃发生版本

从OpenHarmony SDK 5.0.0.56开始。

废弃的接口/组件

废弃接口 替代接口
gridSpan(value: number): T; GridCol(option?: GridColOptions)中的span
gridOffset(value: number): T; GridCol(option?: GridColOptions)中的offset

适配指导

废弃前使用gridSpan、gridOffset属性的栅格。

// xxx.ets
@Entry
@Component
struct GridContainerExample1 {
  build() {
    Column() {
      Text('gridSpan,gridOffset').fontSize(15).fontColor(0xCCCCCC).width('90%')
      GridContainer() {
        Row() {
          Row() {
            Text('Left').fontSize(25)
          }
          .gridSpan(1)
          .height("100%")
          .backgroundColor(0x66bbb2cb)

          Row() {
            Text('Center').fontSize(25)
          }
          .gridSpan(2)
          .gridOffset(1)
          .height("100%")
          .backgroundColor(0x66b6c5d1)

          Row() {
            Text('Right').fontSize(25)
          }
          .gridSpan(1)
          .gridOffset(3)
          .height("100%")
          .backgroundColor(0x66bbb2cb)
        }.height(200)
      }
    }
  }
}

使用GridRow容器,并且子组件为GridCol。GridCol构造中设置span(对应废弃的gridSpan)、offset(对应废弃的gridOffset)属性的栅格。

// xxx.ets
@Entry
@Component
struct GridRowExample {
  @State bgColors: Color[] = [Color.Red, Color.Orange, Color.Yellow, Color.Green, Color.Pink, Color.Grey, Color.Blue, Color.Brown]
  @State currentBp: string = 'unknown'

  build() {
    Column() {
      GridRow({
        columns: 5,
        gutter: { x: 5, y: 10 },
        breakpoints: { value: ["400vp", "600vp", "800vp"],
          reference: BreakpointsReference.WindowSize },
        direction: GridRowDirection.Row
      }) {
          GridCol({ span: { xs: 1, sm: 2, md: 3, lg: 4 }, offset: 0, order: 0 }) {
            Text('Left').fontSize(25)
          }.borderColor(color).borderWidth(2)
          GridCol({ span: { xs: 1, sm: 2, md: 3, lg: 4 }, offset: 1, order: 0 }) {
            TText('Center').fontSize(25)
          }.borderColor(color).borderWidth(2)
          GridCol({ span: { xs: 1, sm: 2, md: 3, lg: 4 }, offset: 2, order: 0 }) {
             Text('Right').fontSize(25)
          }.borderColor(color).borderWidth(2)
      }.width("100%").height("100%")
      .onBreakpointChange((breakpoint) => {
        this.currentBp = breakpoint
      })
    }.width('80%').margin({ left: 10, top: 5, bottom: 5 }).height(200)
    .border({ color: '#880606', width: 2 })
  }
}

cl.arkui.3 RichEditor(富文本)在光标处于文本起始位置情况时向前删除空文本onWillChange回调变更

访问级别

公开接口

变更原因

RichEditorController构造的富文本:光标位于文本起始位置时向前删除,触发onWillChange回调范围是[-1, -1],不符合接口定义。 RichEditorStyledStringController构造的富文本:光标位于文本起始位置时向前删除,触发onWillChange回调范围是[0, 1],不符合接口定义。

变更影响

该变更为不兼容变更。

组件 变更前 变更后
RichEditorController构造的富文本 光标位于文本起始位置时向前删除,触发onWillChange回调范围是[-1, -1]。 光标位于文本起始位置时向前删除,触发onWillChange回调范围是[0, 0]。
RichEditorStyledStringController构造的富文本 光标位于文本起始位置时向前删除,触发onWillChange回调范围是[0, 1]。 光标位于文本起始位置时向前删除,触发onWillChange回调范围是[0, 0]。

起始API Level

API 12。

变更发生版本

从OpenHarmony SDK 5.0.0.56开始。

变更的接口/组件

RichEditor

适配指导

默认行为变更,无需适配,但应注意变更后的行为是否对整体应用逻辑产生影响。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙元能力子系统Changelog

harmony 鸿蒙ArkCompiler子系统变更说明

harmony 鸿蒙媒体子系统变更说明

harmony 鸿蒙窗口子系统变更说明

0  赞