• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ArkUI子系统Changelog
2
3## cl.arkui.1 Tabs组件底部页签默认高度由52vp变更为48vp
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11Tabs组件底部页签默认高度由52vp调整到48vp,优化用户体验。
12
13**变更影响**
14
15该变更为不兼容性变更。
16
17变更前:设置BottomTabBarStyle样式且vertical属性为false时,barHeight的默认值为52vp。
18
19变更后:设置BottomTabBarStyle样式且vertical属性为false时,barHeight的默认值为48vp。
20
21|               变更前                |              变更后               |
22| :---------------------------------: | :-------------------------------: |
23| ![](figures/before_tabs_barHeight.jpg) | ![](figures/after_tabs_barHeight.jpg) |
24
25**起始API Level**
26
2711
28
29**变更发生版本**
30
31从OpenHarmony SDK 5.0.0.53开始
32
33**变更的接口/组件**
34
35barHeight
36
37**适配指导**
38
39若发现组件高度变化导致界面内容出现留白,可通过修改内容区高度或自适应内容区高度。
40
41若组件高度发生变化,开发者期望保持原有高度样式。示例如下:
42
43```ts
44@Entry
45@Component
46struct barHeightTest {
47  build() {
48    Column() {
49      Tabs({ barPosition: BarPosition.End }) {
50        TabContent() {
51          Column().width('100%').width('100%').height('100%').backgroundColor(Color.Pink)
52        }
53        .tabBar(new BottomTabBarStyle($r('sys.media.ohos_app_icon'), "Pink"))
54
55        TabContent() {
56          Column().width('100%').width('100%').height('100%').backgroundColor(Color.Green)
57        }
58        .tabBar(new BottomTabBarStyle($r('sys.media.ohos_app_icon'), "Green"))
59      }
60      .barHeight(52)
61    }
62  }
63}
64```
65
66## cl.arkui.2 轴事件分发到XComponent组件变更
67
68**访问级别**
69
70其他
71
72**变更原因**
73
74轴事件分发错误,开发者如果改了组件z序,组件显示、隐藏后不能正确分发到挂载轴事件的XComponent组件上。
75
76**变更影响**
77
78该变更为不兼容变更。
79
80变更前:在多层级组件堆叠场景下,zIndex属性会影响兄弟组件响应轴事件的顺序。堆叠场景下,先绑定zIndex大的组件,然后绑定zIndex小的组件,轴事件无法正常分发给挂载轴事件且zIndex较大的组件,而会分发给挂载轴事件但zIndex较小的组件。
81
82变更后:在多层级组件堆叠场景下,zIndex属性会影响兄弟组件响应轴事件的顺序。堆叠场景下,先绑定zIndex大的组件,然后绑定zIndex小的组件,轴事件可以正常分发给挂载轴事件且zIndex较大的组件,挂载轴事件但zIndex较小的组件无法收到事件。
83
84**起始API Level**
85
8611
87
88**变更发生版本**
89
90从OpenHarmony SDK 5.0.0.53开始
91
92**变更的接口/组件**
93
94不涉及
95
96**适配指导**
97
98默认行为变更,无需适配,但应注意变更后的行为是否对整体应用逻辑产生影响。
99
100## cl.arkui.3 getSnapshot接口行为变更
101
102**访问级别**
103
104系统接口
105
106**变更原因**
107
108window.getSnapshot接口当前获取到的图片尺寸是windowRect*0.5,不是窗口实际尺寸。
109
110**变更影响**
111
112该变更为不兼容变更。
113
114变更前:window.getSnapshot接口获取到的图片尺寸是windowRect*0.5。
115
116变更后:window.getSnapshot接口获取到的图片尺寸是窗口实际尺寸。
117
118**起始API Level**
119
120API 12
121
122**变更发生版本**
123
124从OpenHarmony 5.0.0.53版本开始。
125
126**变更的接口/组件**
127
128@ohos.window.d.ts
129
130getSnapshot接口
131
132**适配指导**
133
134默认行为变更,无需适配,但应注意变更后的行为是否对整体应用逻辑产生影响。
135
136## cl.arkui.4 setWindowBrightness在2in1设备的行为变更
137
138**访问级别**
139
140公开接口
141
142**变更原因**
143
1442in1设备下,在视频播放页面,通过快捷键调节屏幕亮度不生效,原因是快捷键调节系统亮度,而在视频播放页面屏幕亮度跟随窗口亮度值。
145
146**变更影响**
147
148该变更为不兼容变更。
149
150变更前:2in1设备下,窗口设置屏幕亮度生效时,控制中心和快捷键不可以调整系统屏幕亮度,窗口恢复默认系统亮度之后,控制中心和快捷键可以调整屏幕亮度。
151
152变更后:2in1设备下,窗口设置屏幕亮度生效时,控制中心和快捷键也可以调整系统屏幕亮度。
153
154**起始API Level**
155
156API 9
157
158**变更发生版本**
159
160从OpenHarmony 5.0.0.53版本开始。
161
162**变更的接口/组件**
163
164@ohos.window.d.ts
165
166setWindowBrightness接口
167
168**适配指导**
169
170默认行为变更,无需适配。