harmony 鸿蒙ArkUI子系统Changelog

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

ArkUI子系统Changelog

cl.arkui.1 TextController的SetStyledString接口支持保存设置的属性字符串信息到调用的TextController中

访问级别

公开接口

变更原因

优化属性字符串与Text组件的绑定时机。

变更影响

此变更涉及应用适配。

  • 变更前:开发者调用TextController的setStyledString接口设置属性字符串时,如果调用时TextController还未绑定对应的Text,则此次设置无效。

  • 变更后:开发者调用TextController的setStyledString接口时,调用的TextController会保存设置的属性字符串。当TextController和Text绑定时,如果TextController中已经存储之前调用setStyledString接口保存的属性字符串,则Text会自动设置保存的属性字符串,显示出对应的属性字符串。

起始API Level

12

变更发生版本

从OpenHarmony SDK 5.1.0.51开始,API version 15及以上生效。

适配指导

变更后对setStyledString的接口的调用可以更加灵活,Text能够正确地显示出属性字符串。

@Entry
@Component
struct StyledStringExample {
  controller: TextController = new TextController()

  aboutToAppear(): void {
    this.controller.setStyledString(new StyledString("123456")) // 变更前,由于此时controller还未和Text绑定,此次设置不生效。变更后,属性字符串可以正确的显示
  }

  build() {
    Row() {
      Column() {
        Text(undefined, {controller: this.controller})
      }.width('100%')
    }.height('100%')
  }
}

cl.arkui.2 Image、Text和ListItem组件onDragStart接口默认行为变更

访问级别

公开接口

变更原因

Image、Text和ListItem组件存在设置onDragStart接口DragItemInfo返回值中的builder属性后,返回值中pixelMap和extraInfo属性不生效的问题。

变更影响

此变更涉及应用适配,只涉及Image、Text和ListItem组件。

  • 变更前:onDragStart接口设置返回值中的builder属性后,无法解析pixelMap和extraInfo属性。

  • 变更后:onDragStart接口设置返回值中的builder属性后,能够解析pixelMap和extraInfo属性。

起始API Level

11

变更发生版本

从OpenHarmony SDK 5.1.0.51开始, API15及以上生效。

变更的接口/组件

涉及组件: Image, Text, ListItem组件。

涉及接口: onDragStart(event: (event: DragEvent, extraParams?: string) => CustomBuilder|DragItemInfo)

适配指导

onDragStart接口的返回值用于指定拖拽过程中显示的图片(pixelMap,builder)以及拖拽过程中组件携带的额外信息(extraInfo)。变更后,pixelMap的显示优先级高于builder。如果开发者同时设置了pixelMap和builder,应移除返回值中的pixelMap属性。同样,若不打算传递extraInfo,也应删除该属性。具体实现代码如下:

@Entry
@Component
struct SlideExample {
  build() {
    Row() {
      Image()
      .onDragStart((event) => {
        return {
          builder: () => { this.pixelMapBuilder },
          // 若需要拖拽显示builder,需要移除掉pixelMap属性的赋值。
          // pixelMap:this.pixelMap,
          // 若设置了builder并且不需要传递extraInfo,需要移除掉extraInfo属性的赋值。
          // extraInfo: "test"
        }
      })
    }.height('100%')
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙arkcompiler子系统Changelog

harmony 鸿蒙DFX子系统ChangeLog

0  赞