1# ArkUI子系统ChangeLog
2
3OpenHarmony 4.1.6.1 版本相较于OpenHarmony 之前的版本，Navigation、NavDestination、Tabs 组件默认行为变更如下。
4
5## cl.arkui.1  Navigation、NavDestination组件默认扩展到非安全区
6
7满足安全区可拓展的条件下，Navigation、NavDestination组件默认扩展到非安全区。
8
9**访问级别**
10
11公开接口
12
13**变更影响**
14
15变更前：Navigation、NavDestination组件的expandSafeArea属性默认为[SafeAreaExpandType.NONE, SafeAreaExpandEdges.NONE]。
16
17![stack](../../figures/navigation_unexpandSafeArea.jpg)
18
19变更后：Navigation、NavDestination组件的expandSafeArea属性默认为[SafeAreaExpandType.SYSTEM, SafeAreaExpandEdges.BOTTOM, SafeAreaEdge.TOP]，背景色延伸到顶部状态栏和底部导航栏。
20
21![stack](../../figures/navigation_expandSafeArea.jpg )
22
23**API Level**
24
2511
26
27**变更发生版本**
28
29OpenHarmony SDK 4.1.6.1
30
31**变更的接口/组件**
32
33受影响组件有：Navigation与NavDestination
34
35**适配指导**
36
37默认行为变更，如果应用原先使用margin设置了Navigation或NavDestination的外边距，使其无法与顶部状态栏或底部导航栏贴边，会导致组件无法扩展到非安全区。若应用仍想生效沉浸式效果，则需要将margin改成padding，使导航组件与顶部状态栏或底部导航栏贴边，代码示例如下：
38
39适配前：
40
41```ts
42@Entry
43@Component
44struct NavigationExample {
45  build() {
46    NavDestination() {
47        ...
48    }.margin({...})
49  }
50}
51```
52
53适配后：
54
55```ts
56@Entry
57@Component
58struct NavigationExample {
59  build() {
60    NavDestination() {
61        ...
62    }.padding({...})
63  }
64}
65```
66
67## cl.arkui.2  Tabs组件默认扩展到底部非安全区
68
69满足安全区可拓展的条件下，Tabs组件默认扩展到底部非安全区。
70
71**访问级别**
72
73公开接口
74
75**变更影响**
76
77变更前：Tabs组件的expandSafeArea属性默认为[SafeAreaExpandType.NONE, SafeAreaExpandEdges.NONE]。
78
79变更后：Tabs组件的expandSafeArea属性默认为[SafeAreaExpandType.SYSTEM, SafeAreaExpandEdges.BOTTOM]，背景色会延伸到底部导航栏。
80
81**API Level**
82
8311
84
85**变更发生版本**
86
87OpenHarmony SDK 4.1.6.1
88
89**变更的接口/组件**
90
91受影响组件有：Tabs
92
93**适配指导**
94
95默认满足沉浸式效果，不需要适配。
96
97## cl.arkui.3 Image组件autoResize interpolation属性默认行为变更
98
99**访问级别**
100
101公开接口
102
103**变更原因**
104
105应用侧需要设置autoResize为false、 interpolation设置为LOW来解决图片锯齿问题
106
107**变更影响**
108
109该变更为非兼容性变更。
110
111变更前，Image组件的autoResize默认值为true， interpolation为None。
112
113变更后，Image组件的autoResize默认值为false， interpolation为LOW，该修改会提升图片显示效果，但是image组件在大图显示成小组件时，默认内存会上涨，需要应用根据实际情况进行内存优化。
114说明：该修改不影响大桌面效果。
115
116**API Level**
117
11811
119
120**变更发生版本**
121
122从OpenHarmony SDK 4.1.6.1 开始。
123
124**变更的接口/组件**
125
126受影响的组件有：Image。
127
128**适配指导**
129
130默认行为变更，不涉及适配。如果开发者需要保留原来Image组件显示的效果，可以将autoResize的值设置为true， interpolation的值设置为None。
131
132## cl.arkui.4 Swiper组件单页场景新增边缘滑动效果
133
134**访问级别**
135
136公开接口
137
138**变更原因**
139
140Swiper组件在多页非循环场景下有边缘滑动效果，但在单页场景下无边缘滑动效果，行为未保持一致。
141
142**变更影响**
143
144该变更为非兼容性变更。
145
146变更前，Swiper组件在单页场景下无边缘滑动效果。
147
148变更后，Swiper组件在单页场景下有边缘滑动效果，默认为EdgeEffect.Spring。
149
150**API Level**
151
1528
153
154**变更发生版本**
155
156从OpenHarmony SDK 4.1.6.1 开始。
157
158**变更的接口/组件**
159
160受影响的组件有：Swiper。
161
162**适配指导**
163
164默认效果变更，无需适配。若希望Swiper组件在多页非循环和单页场景下无边缘滑动效果，可设置effectMode属性为EdgeEffect.None。