harmony 鸿蒙ArkUI子系统Changelog

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

ArkUI子系统Changelog

cl.arkui.1 修复zIndex接口会影响组件在3D变换中的透视效果的错误行为

访问级别

公开接口

变更原因

zIndex接口在3D变换场景与translateZ耦合,导致zIndex值的改变会影响3D变换时的透视效果。

变更影响

该变更为不兼容变更。

变更前:开发者在3D变换中使用zIndex接口,zindex接口的数值会影响近大远小的透视效果。

变更后:开发者在3D变换中使用zIndex接口,zindex接口的数值不会影响近大远小的透视效果。

设置组件绕y轴旋转45度,同时设置zIndex值为200,变更前后效果如下:

变更前 变更后
pagePath pagePath

起始API Level

API 7

变更发生版本

从OpenHarmony SDK 5.0.1.44开始。

变更的接口/组件

zIndex接口

适配指导

如仍需要实现变更前近大远小的透视效果,可以使用translate接口并设置z向平移实现近大远小的透视效果,示例代码如下:

@Entry
@Preview
@Component
struct zIndexTest {
  build() {
    Column() {
      Stack() {
        Column()
          .backgroundColor("rgb(213, 213, 213)")
          .width('600px')
          .height('600px')
        Column()
          .backgroundColor("rgb(0, 74, 175)")
          .width('600px')
          .height('600px')
          .rotate({
            y: 1,
            angle: 45
          })
          .translate({ x: 0, y: 0, z: 66 })    // 使用translate接口并设置Z向移动,实现3D变换中的近大远小透视效果
      }.margin({ top: 80 })
    }
    .width('100%')
    .height('100%')
  }
}

实现效果如下图所示:

pagePath

cl.arkui.2 富文本组件RichEditor的onCopy回调中设置preventDefault()时的行为变更

访问级别

公开接口

变更原因

在富文本组件RichEditor的onCopy回调中,当调用preventDefault()时,复制操作完成后,选中区消失。这导致了一个接口同时管理了复制功能和选中区关闭这两个相互独立的行为。

变更影响

此变更不涉及应用适配。

变更前:富文本组件RichEditor的onCopy回调中设置preventDefault()时,复制之后选中区消失,触发OnSelectionChange回调。

变更后:富文本组件RichEditor的onCopy回调中设置preventDefault()时,复制之后选中区不消失,不触发OnSelectionChange回调。

起始API Level

API 12

变更发生版本

从OpenHarmony SDK 5.0.1.44开始。

变更的接口/组件

富文本组件RichEditor

适配指导

此变更不涉及应用适配。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkTS方舟编程语言Changelog

0  赞