harmony 鸿蒙ArkUI子系统Changelog

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

ArkUI子系统Changelog

cl.arkui.1 Text的minFontSize、maxFontSize在子组件span或属性字符串场景下,文本自适应字号设置生效

访问级别

公开接口

变更原因

能力增强,方便开发者对不同文字样式的文字做字号的适应。

变更影响

此变更涉及应用适配。

变更前,Text的minFontSize、maxFontSize在子组件Span或属性字符串场景下,文本自适应字号设置不生效。

变更后,Text的minFontSize、maxFontSize在子组件Span或属性字符串场景下,文本自适应字号设置生效。

如下是属性字符串和Span子组件场景变更前后效果对比:

变更前 变更后

起始API Level

API 7

变更发生版本

从OpenHarmony SDK 5.1.0.46开始。

变更的接口/组件

Text组件的minFontSize、maxFontSize接口。

适配指导

如果在Text使用子组件或属性字符串场景下,设置了minFontSize、maxFontSize,变更后自适应字号生效,导致字号变化,如果需要保持之前的字号,可以删除minFontSize、maxFontSize属性设置。

cl.arkui.2 FrameNode被UINode包裹时isVisible接口返回值发生变更

访问级别

公开接口

变更原因

用户使用FrameNode的isVisible接口时,节点会依次向上层父节点查询可见性,如果父节点不可见,子节点也不可见。但如果子节点被UINode类型节点(如IfElse、ForEach、LazyForEach等)包裹,则向上查找过程被阻塞,无法继续查询父节点可见性。

变更影响

此变更不涉及应用适配。

变更前:父节点设为不可见、子节点设为可见时,如果子节点被UINode类型节点包裹,子节点调用isVisible结果为true。

变更后:父节点设为不可见、子节点设为可见时,如果子节点被UINode类型节点包裹,子节点调用isVisible结果为false。

父节点设为不可见、子节点设为可见时,如果子节点被UINode类型节点包裹,调用isVisible接口返回值结果变更前后会不一致,例如:

import { FrameNode } from '@kit.ArkUI'

@Entry
@Component
struct Index {
  private stackNode: FrameNode|null = null
  private columnNode: FrameNode|null = null

  build() {
    Column() {
      Stack() {
        if (true) {
          Column()
            .id("column")
            .visibility(Visibility.Visible)
        }
      }
      .id("stack")
      .visibility(Visibility.Hidden)

      Button("print")
        .onClick(() => {
          this.stackNode = this.getUIContext().getFrameNodeById("stack")
          this.columnNode = this.getUIContext().getFrameNodeById("column")
          if (this.stackNode) {
            // Stack节点的可见性,为false
            console.log("stackNode.isVisible:", this.stackNode.isVisible())
          }
          if (this.columnNode) {
            // Column节点的可见性,变更前为true,变更后为false
            console.log("columnNode.isVisible:", this.columnNode.isVisible())
          }
        })
    }
  }
}

起始API Level

API 12

变更发生版本

从OpenHarmony SDK 5.1.0.46开始。

变更的接口/组件

FrameNode.d.ts文件isVisible接口。

适配指导

默认行为变更,无需适配。

cl.arkui.3 Search组件searchButton属性行为变更,设置为undefined后,获取searchButton属性的值为空

访问级别

公开接口

变更原因

Search组件searchButton属性设置为undefined后,变更前获取searchButton属性值会取得上一次设置的值,此行为非预期行为,变更后改为获取到空值。

变更影响

此变更不涉及应用适配。

变更前 变更后
Search组件searchButton属性设置为undefined后,获取属性值为上一次设置的值,且会导致分隔线不消失。
search_button_before
Search组件searchButton属性设置为undefined后,获取属性值为空,分隔线隐藏
search_button_after

起始API Level

7

变更发生版本

从OpenHarmony 5.1.0.46 版本开始。

变更的接口/组件

search.d.ts文件searchButton接口。

适配指导

默认行为变更,无需适配。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler子系统变更说明

harmony 鸿蒙方舟运行时子系统变更说明

harmony 鸿蒙媒体子系统Changelog

0  赞