@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.1

package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/beta1-ux-style-and-effect-changes.md

@@ -0,0 +1,288 @@
+---
+title: UX样式或效果的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-7001
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# UX样式或效果的变更
+
+## notofonts三方件小语种字体升级变更
+
+**变更原因**
+
+当前版本存在错别字的问题，变更后可修复错别字和优化数学字符的显示。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：蒙古语（NotoSansMongolian-Regular.ttf）、天城体（NotoSansDevanagari\[wdth,wght\].ttf）、缅甸语（NotoSansMyanmar\[wdth,wght\].ttf）部分显示不正确。
+
+变更后：蒙古语（NotoSansMongolian-Regular.ttf）、天城体（NotoSansDevanagari\[wdth,wght\].ttf）、缅甸语（NotoSansMyanmar\[wdth,wght\].ttf）显示正确，部分数学符号字体（NotoSansMath-Regular.ttf）显示变大。
+
+**起始 API Level**
+
+11
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+数学符号变大后，显示更清晰，效果会更好。由于数学符号变大，可能出现界面排版变动，需要应用根据实际情况调整界面排版。
+
+## 表单类组件触摸热区最小高度变更
+
+**变更原因**
+
+[Button](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-button)、[样式为Button的Toggle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-toggle)、[Select](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-select)、[Chip](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-chip)、[ChipGroup](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-chipgroup)组件触摸热区当前最小高度28vp，点击范围小，不易操作。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。
+
+-   变更前：组件默认触摸热区高度最小为28vp。
+    
+-   变更后：组件默认触摸热区高度最小为32vp。
+    
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6c/v3/X7WUABOeQIaSCZ9Sc9zTdQ/zh-cn_image_0000002607653205.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=0BE070182CD501A278ED1E65193556C0BC0BDF1064E8273B3DED4D2AED49F578)
+
+**起始 API Level**
+
+Button：7
+
+Toggle：8
+
+Select：8
+
+Chip：11
+
+ChipGroup：12
+
+**变更的接口/组件**
+
+Button、Button模式的Toggle、Chip、ChipGroup和Select组件。
+
+**适配指导**
+
+默认行为变更，应注意变更后的行为是否对整体应用逻辑产生影响，如开发者期望恢复默认触摸热区，可使用如下方法重置组件的触摸热区，恢复为与组件实际大小一致。如果开发者自定义了组件高度或热区，触摸热区随自定义大小生效。
+
+```
+@Entry
+struct ButtonExample {
+  build() {
+    Button('xxxxx')
+      .responseRegion(undefined)
+  }
+}
+```
+
+## 内置文本的组件文本样式优化
+
+**变更原因**
+
+部分ArkUI组件内置了文本功能，文本存在孤字换行、小语种（藏语、缅甸语）行高异常截断、文本按单词换行导致单词截断的问题。为提升组件内文本的可阅读性，针对上述三种场景进行默认优化。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。
+
+**场景一：孤字换行优化**
+
+变更前：系统语言为中文时，组件内文本显示换行后存在单独文字，孤字会独立在一行显示。
+
+变更后：系统语言为中文时，组件内文本显示换行后存在单独文字，前一行尾部的文字会跟随显示到第二行，不会出现孤字显示一行的情况。
+
+孤字换行变更前后效果如下图所示：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f6/v3/AagHLgXGSz23OEvMXzWW-A/zh-cn_image_0000002577173246.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=4FDC5884CDEBDAD9A5AEB08E0D0CE410C49066AA0C65261B4C2423A4C56C2488)
+
+**场景二：小语种行高优化**
+
+变更前：系统语言为小语种（藏语、缅甸语）时，文本显示存在重叠，截断的问题。
+
+变更后：系统语言为小语种（藏语、缅甸语）时，文本显示时行高会自动调整，不会出现文本重叠和截断的现象。
+
+小语种行高优化变更前后效果如下图所示：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5c/v3/nk4z5BG_SnWqlzRKPf_pFw/zh-cn_image_0000002577333224.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=0AD20F62147AD5CBCA26F77DBD43E94545F1CFC25105FDE5BDD6303FBA93F8C2)
+
+**场景三：单词换行改为音节换行**
+
+变更前：系统语言为英语、意大利语等外语时，组件内文本的单词较长时会按照单词换行的方式进行换行，如果单词长度超过显示宽度，单词会被截断。
+
+变更后：系统语言为英语、意大利语等外语时，组件内文本的单词较长时会按照音节换行的方式进行换行，同一个单词内部换行后会使用连词符连接，不会出现单词截断问题。
+
+文本按单词换行改为按音节换行变更前后效果如下图所示：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/63/v3/dHSlGNfsR46GyWPXHnkKNA/zh-cn_image_0000002607733199.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=48F73CB09F20BD2417F78E9DBA10BC3F394F2C23A70464321CB58AFB6E852B38)
+
+**起始 API Level**
+
+12
+
+**变更的接口/组件**
+
+[bindPopup](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-popup#bindpopup)，[bindTips](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-tips#bindtips)，[showToast](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showtoast)，[openToast](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#opentoast18)，[Menu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-menu)，[MenuItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-menuitem)，[Slider](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-slider)，[Select](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-select)，[showAlertDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showalertdialog)，[showActionSheet](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showactionsheet)，[showActionMenu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showactionmenu11)，[showDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showdialog)，[ArcButton](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-arcbutton)，[Search](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-search)，[Hyperlink](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-hyperlink)，[Marquee](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-marquee)，[TextClock](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textclock)，[Badge](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-badge)，[Chip](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-chip)，[ChipGroup](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-chipgroup)，[SegmentButton](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-segmentbutton)，[SegmentButtonV2](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-segmentbuttonv2)，[bindSheet](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-sheet-transition#bindsheet)，[Dialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ohos-arkui-advanced-dialog)，[showDatePickerDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showdatepickerdialog)，[showTimePickerDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showtimepickerdialog)，[showTextPickerDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showtextpickerdialog)，[CalendarPickerDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-calendarpicker-dialog)
+
+**适配指导**
+
+1.  默认效果变更，组件内置文本的换行策略、行高变化后，组件的布局大小存在变化，应用需根据实际显示效果进行调整适配。
+    
+2.  变更针对的是系统设置的语言，而非应用实际使用的语言。比如当前应用并未适配藏语和缅甸语，当用户将系统语言切换为藏语或缅甸语后，应用显示的文本依然为中文，但仍会受到本次文本样式变更的影响，行高会自动撑开，相关组件布局大小会发生改变。
+    
+
+## Dialog、Toast、AlphabetIndexer和文本选择菜单默认开启沉浸式系统材质
+
+**变更原因**
+
+ArkUI组件支持对接沉浸式系统材质功能，为减少应用适配成本，部分高频组件默认开启沉浸式系统材质功能。组件范围为所有的弹出框Dialog、Toast、AlphabetIndexer和文本选择菜单。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。
+
+-   变更前：所有组件默认均不开启沉浸式系统材质。
+    
+-   变更后：Dialog、Toast、AlphabetIndexer和文本选择菜单默认开启沉浸式系统材质。
+    
+
+**起始 API Level**
+
+12
+
+**变更的接口/组件**
+
+涉及接口：
+
+-   [showAlertDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showalertdialog)
+-   [showActionSheet](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-uicontext#showactionsheet)
+-   [showActionMenu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showactionmenu11)
+-   [showDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showdialog)
+-   [openCustomDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#opencustomdialog12)
+-   [自定义弹窗 (CustomDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-custom-dialog-box)
+-   [日历选择器弹窗 (CalendarPickerDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-calendarpicker-dialog)
+-   [日期滑动选择器弹窗 (DatePickerDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-datepicker-dialog)
+-   [时间滑动选择器弹窗 (TimePickerDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-timepicker-dialog)
+-   [文本滑动选择器弹窗 (TextPickerDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-textpicker-dialog)
+-   [showToast](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#showtoast)
+-   [openToast](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#opentoast18)
+-   [AlphabetIndexer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-alphabet-indexer)
+-   [文本选择菜单](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#copyoption9)
+
+沉浸式系统材质效果和设备算力相关，详见[系统材质](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uimaterial)。变更前后的效果图如下。
+
+Dialog变更前后的效果图：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ad/v3/BgLcwFYZTDuCn6MTiHJ79A/zh-cn_image_0000002607653207.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=8ADEAA0C014CD66D61143F8AEDE3D48C13FB6620942012A8167AD7C3306CC4E7)
+
+Toast变更前后的效果图：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f4/v3/pihldoinQLOD51Vms20XtQ/zh-cn_image_0000002577173248.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=BEE3B217AAEF5EF7B3F02FFE5E7186006B0F8F7BE560239F196DAC624EDBC7A2)
+
+AlphabetIndexer变更前后的效果图：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8f/v3/vt4dfdu3RRGhmMVG1leQEQ/zh-cn_image_0000002577333226.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=1D4DCCAB9DEFEECBC46EC9C998C74891EE0422D6DA3B0D8A31CEE8FBC003FEC1)
+
+文本选择菜单变更前后的效果图：
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8e/v3/RUmN3PBxS-O-fSZXboZ0fw/zh-cn_image_0000002607733201.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=DA17E9749BA1F2B545023E6E75859F3F98621D4A50B4077A152EE811E86979F0)
+
+**适配指导**
+
+1.  当开发者主动为上述组件配置了背景色、背景模糊、阴影和边框样式时，沉浸式系统材质不会默认生效，如开发者期望沉浸式系统材质生效，建议删除自定义的背景色、背景模糊、阴影和边框样式设置。
+    
+2.  如果开发者不期望开启沉浸式系统材质功能，可通过应用级开关能力，强制禁止应用内所有组件使用沉浸式系统材质。
+    
+    在[module.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)文件中配置metadata（仅在entry类型的module中配置生效），将value设置为"disable"即可禁用所有组件的沉浸式系统材质。
+    
+    ```
+    {
+      "module": {
+        // ...
+        "type": "entry",
+        // ...
+        "metadata": [{
+          "name": "ohos.arkui.UIMaterial.state",
+          "value": "disable"
+        }]
+        // ...
+      }
+    }
+    ```
+    
+    更多配置说明参见[MaterialState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uimaterial#materialstate)。
+    
+3.  如果开发者仅想关闭部分组件的沉浸式系统材质，可通过组件提供的组件级接口关闭指定组件的沉浸式系统材质功能。
+    
+    为需要关闭材质的组件设置[systemMaterial](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-image-effect#systemmaterial)为uiMaterial.Material.[empty](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uimaterial#empty)。
+    
+    ```typescript
+    import { uiMaterial } from '@kit.ArkUI';
+    
+    this.getUIContext().getPromptAction().showToast({
+      message: 'Toast Content',
+      // 关闭指定组件的沉浸式系统材质
+      systemMaterial: uiMaterial.Material.empty
+    });
+    ```
+    
+
+## 半模态居中弹窗最大高度变更
+
+**变更原因**
+
+UX规格变更，当前半模态最大高度限制为窗口短边长度的90%，可能导致半模态与信号栏重叠。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。
+
+变更前：
+
+半模态居中弹窗最大高度：取“短边长度\*90%”。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c3/v3/Ixzxf1r_SySFFFyU2JyI0Q/zh-cn_image_0000002607653209.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=64F92254E800636E8BA90202F578F9C4060A2CAB0B35B23CFAEC9DE4E19EA204)
+
+变更后：
+
+半模态居中弹窗最大高度：取“短边长度\*90%”、“窗口高度-信号栏高度\*2”两者中的最小值。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/18/v3/ewWfN2zYTsOiU32oTZEnpA/zh-cn_image_0000002577173250.png?HW-CC-KV=V1&HW-CC-Date=20260903T083716Z&HW-CC-Expire=86400&HW-CC-Sign=E9C44747C37D905E31CE2EAB0E1A90DBF841C2AD13AC59F4DAF6140F497E6C00)
+
+**起始 API Level**
+
+12
+
+**变更发生版本**
+
+从OpenHarmony SDK 7.0.0.19开始。
+
+**变更的接口/组件**
+
+[CENTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-sheet-transition#sheettype11枚举说明)
+
+**适配指导**
+
+1.  UX规格变更，无需适配。
+    
+2.  若半模态达到最大高度后，内容布局存在截断，可通过[height](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-sheet-transition#sheetoptions)属性调整半模态高度。

package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/26.0.0/beta2-changes-for-all-apps.md

@@ -0,0 +1,148 @@
+---
+title: 针对所有应用的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-7002
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# 针对所有应用的变更
+
+## ArkUI
+
+### List组件onScrollVisibleContentChange事件行为变更
+
+**变更原因**
+
+[List](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list)组件[onScrollVisibleContentChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollvisiblecontentchange12)事件索引输出规则与空列表参数设计定义不符，原列表从有数据切换成没有数据时复用旧start和end参数，优化后该场景start和end参数的index成员均为-1，itemGroupArea和itemIndexInGroup成员均为undefined，符合空列表参数设计定义。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。
+
+-   变更前：[List](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list)组件[onScrollVisibleContentChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollvisiblecontentchange12)事件从有子组件切换到没有子组件时，上报的start和end参数均为原值。
+    
+-   变更后：[List](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list)组件[onScrollVisibleContentChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollvisiblecontentchange12)事件从有子组件切换到没有子组件时，上报的start和end参数的index成员均为-1，itemGroupArea和itemIndexInGroup成员均为undefined。
+    
+
+```
+@Entry
+@Component
+struct ListExample {
+  @State listData: string[] = ['item1', 'item2', 'item3'];
+
+  build() {
+    Column() {
+      Button('清空列表数据')
+        .onClick(() => {
+          this.listData = [];
+        })
+      List() {
+        ForEach(this.listData, (item: string) => {
+          ListItem() {
+            Text(item)
+              .width('100%')
+              .height(100)
+              .textAlign(TextAlign.Center)
+          }
+        })
+      }
+      .width('100%')
+      .height('100%')
+      .onScrollVisibleContentChange((start, end) => {
+        console.info(`start: ${start.index}, end: ${end.index}`);
+        // 变更前：当listData从['item1', 'item2', 'item3']变为[]时，打印 start: 0, end: 2
+        // 变更后：当listData从['item1', 'item2', 'item3']变为[]时，打印 start: -1, end: -1
+      })
+    }
+  }
+}
+```
+
+**起始 API Level**
+
+12
+
+**变更发生版本**
+
+从OpenHarmony SDK 7.0.0.28开始。
+
+**变更的接口/组件**
+
+[onScrollVisibleContentChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollvisiblecontentchange12)事件。
+
+**适配指导**
+
+如果应用依赖[onScrollVisibleContentChange](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-list#onscrollvisiblecontentchange12)事件的start和end参数来判断列表内容变化，当列表从有内容变为空时，开发者需要适配start和end参数的index为-1的场景。例如，开发者需要在事件回调中判断index是否为-1，以区分列表为空的情况。
+
+```
+@Entry
+@Component
+struct ListExample {
+  @State listData: string[] = ['item1', 'item2', 'item3'];
+
+  build() {
+    Column() {
+      Button('清空列表数据')
+        .onClick(() => {
+          this.listData = [];
+        })
+      List() {
+        ForEach(this.listData, (item: string) => {
+          ListItem() {
+            Text(item)
+              .width('100%')
+              .height(100)
+              .textAlign(TextAlign.Center)
+          }
+        })
+      }
+      .width('100%')
+      .height('100%')
+      .onScrollVisibleContentChange((start, end) => {
+        // 适配指导：判断列表是否为空
+        if (start.index === -1 && end.index === -1) {
+          console.info('列表为空');
+        } else {
+          console.info(`可见列表项范围：start: ${start.index}, end: ${end.index}`);
+        }
+      })
+    }
+  }
+}
+```
+
+## ArkWeb
+
+### Cookie存储目录变更
+
+**变更原因**
+
+ArkWeb产生的Cookie目前存储在应用的缓存目录下，清空应用缓存会同时清除Cookie数据，导致Web页面内的登录态丢失。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：ArkWeb的Cookie存储在应用的缓存目录（/data/storage/el2/base/cache/web/Cookies）下，清空应用缓存（/data/storage/el2/base/cache）会同时清除Cookie数据。
+
+变更后：ArkWeb的Cookie存储在应用的数据目录下，清空应用缓存（/data/storage/el2/base/cache）不会清除Cookie数据。
+
+**起始 API Level**
+
+9
+
+**变更发生版本**
+
+从OpenHarmony SDK 7.0.0.23开始。
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+若应用期望在清空应用缓存时同时清除Cookie，需使用[clearAllCookiesSync11+](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-webview-webcookiemanager#clearallcookiessync11)、[clearAllCookies11+](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-webview-webcookiemanager#clearallcookies11)（callback）或[clearAllCookies11+](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-webview-webcookiemanager#clearallcookies11-1)（Promise）接口清除Cookie。