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|  |  | 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默认行为变更,无需适配。