• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ArkUI子系统Changelog
2
3## cl.arkui.1 Text的minFontSize、maxFontSize在子组件span或属性字符串场景下，文本自适应字号设置生效
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11能力增强，方便开发者对不同文字样式的文字做字号的适应。
12
13**变更影响**
14
15此变更涉及应用适配。
16
17变更前，Text的minFontSize、maxFontSize在子组件Span或属性字符串场景下，文本自适应字号设置不生效。
18
19变更后，Text的minFontSize、maxFontSize在子组件Span或属性字符串场景下，文本自适应字号设置生效。
20
21如下是属性字符串和Span子组件场景变更前后效果对比：
22
23|               变更前                |              变更后               |
24| :---------------------------------: | :-------------------------------: |
25|![](figures/before_span_adapter.png)|![](figures/after_span_adapter.png)|
26
27**起始API Level**
28
29API 7
30
31**变更发生版本**
32
33从OpenHarmony SDK 5.1.0.46开始。
34
35**变更的接口/组件**
36
37Text组件的minFontSize、maxFontSize接口。
38
39**适配指导**
40
41如果在Text使用子组件或属性字符串场景下，设置了minFontSize、maxFontSize，变更后自适应字号生效，导致字号变化，如果需要保持之前的字号，可以删除minFontSize、maxFontSize属性设置。
42
43## cl.arkui.2 FrameNode被UINode包裹时isVisible接口返回值发生变更
44
45**访问级别**
46
47公开接口
48
49**变更原因**
50
51用户使用FrameNode的isVisible接口时，节点会依次向上层父节点查询可见性，如果父节点不可见，子节点也不可见。但如果子节点被UINode类型节点（如IfElse、ForEach、LazyForEach等）包裹，则向上查找过程被阻塞，无法继续查询父节点可见性。
52
53**变更影响**
54
55此变更不涉及应用适配。
56
57变更前：父节点设为不可见、子节点设为可见时，如果子节点被UINode类型节点包裹，子节点调用isVisible结果为true。
58
59变更后：父节点设为不可见、子节点设为可见时，如果子节点被UINode类型节点包裹，子节点调用isVisible结果为false。
60
61父节点设为不可见、子节点设为可见时，如果子节点被UINode类型节点包裹，调用isVisible接口返回值结果变更前后会不一致，例如：
62```ts
63import { FrameNode } from '@kit.ArkUI'
64
65@Entry
66@Component
67struct Index {
68  private stackNode: FrameNode | null = null
69  private columnNode: FrameNode | null = null
70
71  build() {
72    Column() {
73      Stack() {
74        if (true) {
75          Column()
76            .id("column")
77            .visibility(Visibility.Visible)
78        }
79      }
80      .id("stack")
81      .visibility(Visibility.Hidden)
82
83      Button("print")
84        .onClick(() => {
85          this.stackNode = this.getUIContext().getFrameNodeById("stack")
86          this.columnNode = this.getUIContext().getFrameNodeById("column")
87          if (this.stackNode) {
88            // Stack节点的可见性，为false
89            console.log("stackNode.isVisible:", this.stackNode.isVisible())
90          }
91          if (this.columnNode) {
92            // Column节点的可见性，变更前为true，变更后为false
93            console.log("columnNode.isVisible:", this.columnNode.isVisible())
94          }
95        })
96    }
97  }
98}
99```
100
101**起始API Level**
102
103API 12
104
105**变更发生版本**
106
107从OpenHarmony SDK 5.1.0.46开始。
108
109**变更的接口/组件**
110
111FrameNode.d.ts文件isVisible接口。
112
113**适配指导**
114
115默认行为变更，无需适配。
116
117## cl.arkui.3 Search组件searchButton属性行为变更，设置为undefined后，获取searchButton属性的值为空
118**访问级别**
119
120公开接口
121
122**变更原因**
123
124Search组件searchButton属性设置为undefined后，变更前获取searchButton属性值会取得上一次设置的值，此行为非预期行为，变更后改为获取到空值。
125
126**变更影响**
127
128此变更不涉及应用适配。
129
130| 变更前 | 变更后 |
131|------ |--------|
132|Search组件searchButton属性设置为undefined后，获取属性值为上一次设置的值，且会导致分隔线不消失。<br>![search_button_before](figures/search_button_before.png)|Search组件searchButton属性设置为undefined后，获取属性值为空，分隔线隐藏<br>![search_button_after](figures/search_button_after.png)|
133
134**起始API Level**
135
1367
137
138**变更发生版本**
139
140从OpenHarmony 5.1.0.46 版本开始。
141
142**变更的接口/组件**
143
144search.d.ts文件searchButton接口。
145
146**适配指导**
147
148默认行为变更，无需适配。
149