1# ArkUI子系统Changelog 2 3## cl.arkui.1 List组件首次创建布局时，Scroller控制器的跳转方法优先级变更为高于initialIndex的优先级 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11initialIndex仅支持设定起始index，并默认将列表头部对齐，这使得开发者无法自定义对齐策略。scrollToIndex允许指定index与对齐方式，然而其效果会被 initialIndex覆盖。因此，需要提升scrollToIndex的优先级，使其高于initialIndex。这样一来，在组件初次布局时，如果开发者希望设定起始index并同时指定对齐方式，即可通过使用scrollToIndex来达成目标。 12 13 14**变更影响** 15 16该变更为不兼容变更。 17 18场景1：List设置initialIndex为0 (默认也是0)，并在创建后，首次布局前（例如onAppear, onAttach回调时）调用scrollToIndex(1)。 19 20| 变更前 | 变更后 | 21|------ |--------| 22|List首次布局将从index为0的ListItem开始布局。</br>|List首次布局将从index为1的ListItem开始布局。</br>| 23 24场景2：List设置initialIndex为0 (默认也是0)，并在创建后，首次布局前（例如onAppear, onAttach回调时）调用scrollEdge(Edge.Bottom)。 25 26| 变更前 | 变更后 | 27|------ |--------| 28|List首次布局将展示在顶部，即index为0的ListItem处于顶部。</br>|List首次布局将展示在底部，即index为最大值的ListItem处于底部。</br>| 29 30 31**起始API Level** 32 33API 7 34 35**变更发生版本** 36 37从OpenHarmony 5.0.0.57开始。 38 39**变更的接口/组件** 40 41List组件的initialIndex接口和Scroller控制器的跳转接口（scrollToIndex、scrollToItemInGroup和scrollEdge）。 42 43**适配指导** 44 45需要对使用List组件的页面进行排查，检查是否在onAppear或其他List组件首次布局之前的阶段，同时设置了initialIndex并调用了scrollToIndex,、scrollToItemInGroup或scrollEdge接口。在变更后，initialIndex的生效优先级将低于scrollToIndex、scrollToItemInGroup或scrollEdge的优先级。 46 47## cl.arkui.2 Canvas使用toDataURL接口生成图片，对于带有透明度的图片，创建为“image/png”或“image/webp”格式时，其效果可能会发生变更 48 49**访问级别** 50 51公开接口 52 53**变更原因** 54 55变更前效果未达到预期。 56 57**变更影响** 58 59该变更为不兼容变更。 60 61变更前：Canvas使用toDataURL接口生成图片，对于带有透明度的图片，创建为“image/png”或“image/webp”格式时，带透明度部分会与黑色背景混合，效果与原图有色差。 62 63变更后：Canvas使用toDataURL接口生成图片，对于带有透明度的图片，创建为“image/png”或“image/webp”格式时，变更为与原图一致。 64 65| 变更前 | 变更后 | 66| :----------------------------------------: | :-------------------------------------: | 67|  |  | 68 69**起始API Level** 70 71API 8 72 73**变更发生版本** 74 75从OpenHarmony 5.0.0.57开始。 76 77**变更的接口/组件** 78 79Canvas组件的toDataURL接口。 80 81**适配指导** 82 83默认效果变更，无需适配，但应注意变更后的效果是否符合预期。
