harmony 鸿蒙arkui子系统ChangeLog

2025-06-16
浏览 (7)

arkui子系统ChangeLog

cl.arkui.1 TextInput/TextArea组件单独设置尺寸约束constraintSize minWidth接口效果变更

访问级别

公开接口

变更原因

在API version 10上使用constraintSize minWidth效果不符合应用预期，因此需要在API version 11上进行变更。

变更影响

该变更为非兼容变更。

变更发生版本

从OpenHarmony SDK 4.1.3.1开始。

TextInput/TextArea组件

变更前：API version 10单独使用constraintSize({minWidth:100})且未设置width属性时，TextInput组件宽度为父组件传下来的最大宽度显示。

变更后：API version 11及更高的版本单独使用constraintSize({minWidth:100})且未设置width属性时，在父组件宽度约束不小于100时TextInput组件宽度最小为100，内容超过100组件宽度自适应内容增大。

适配指导

默认行为变更，不涉及适配。

cl.arkui.2 Navigation组件hideNavBar属性生效范围变更

访问级别

公开接口

变更原因

hideNavBar能力增强，从仅在双栏场景生效，扩展为单、双栏模式下均生效。

变更影响

该变更为非兼容性变更。变更前，单栏场景下使用hideNavBar无任何效果，变更后，可能由于未提供可显示页面，从而在生效hideNavBar后隐藏导航栏，产生白屏。

API Level

变更发生版本

从OpenHarmony SDK 4.1.3.1开始。

适配指导

使用该接口，会隐藏Navigation的导航栏，包括Navigation的标题栏、内容区和工具栏。此时，若路由栈NavPathStack中存在NavDestination页面，则显示栈顶页面，否则显示空白。该接口API11以前，仅对双栏模式生效，其他模式误用该接口无任何效果。API11开始，该接口对单栏、双栏和自适应模式均生效。若因使用该接口产生白屏，可直接去掉该接口或在路由栈中提供需要显示在首页的NavDestination页面。