ithome
科技
采集 2026-09-03T16:10:42+00:00
华为鸿蒙HarmonyOS 7沉浸光感新增生效范围约束
原始标题:涉及应用适配:华为鸿蒙 HarmonyOS 7 系统沉浸光感新增生效约束
来源
ithome
发布时间
2026-09-03T15:03:04
采集批次
2026-09-03-16
字数
852
URL 指纹
f4e39693e3a590c1
📌 AI 总结(231 字)
华为开发者官网发布OS平台行为变更说明,宣布对HarmonyOS 7的沉浸光感组件新增生效范围约束。变更目的是确保性能与功耗体验最优,规范组件使用。此次变更仅在应用targetSdkVersion设置为26.0.0及以上时生效。变更后,弹窗类组件、弹窗类接口以及按钮与选择类组件仍可在页面全部区域生效,但其他组件仅在Navigation标题栏或底部TabBar中生效,其他区域设置沉浸光感将不再有效果。华为建议开发者如需沉浸光感效果,应将相关组件放置于指定位置。
📄 正文(852 字)
华为开发者官网OS平台行为变更说明今日迎来更新,宣布沉浸光感新增生效约束。华为官方针对此次变更给出了原因和影响。 变更原因为确保性能和功耗体验最优,规范沉浸光感组件使用,沉浸光感对部分组件新增生效范围的约束。 变更影响方面,此变更涉及应用适配,变更涉及的接口为26.0.0 Beta版本新增接口,因此变更仅在应用的targetSdkVersion设置为大于等于26.0.0时生效。 变更前,针对支持开启沉浸光感的所有组件,沉浸光感开启后,沉浸光感效果生效。 变更后,弹窗类组件(包括AlertDialog、ActionSheet、CustomDialog、CalendarPickerDialog、DatePickerDialog、TimePickerDialog、TextPickerDialog、SelectionMenu、AlphabetIndexer弹窗、Text设置copyOption后长按或双击触发的文本菜单)和弹窗类接口(PromptAction、ArkUI_NativeDialog、@ohos.promptAction弹窗、Popup控制、Tips控制、菜单控制、半模态转场)以及按钮与选择类组件(Slider、Toggle、Select)仍可在页面内全部区域生效,与变更前无变化。 其他组件仅在Navigation/NavDestination标题栏或横向Tab中barPosition为BarPosition.End的底部TabBar中生效,在其他区域中设置沉浸光感效果不生效。 以Column组件为例,变更前通过systemMaterial设置沉浸光感效果生效;变更后由于不处于生效范围内,沉浸光感效果不再生效。 变更的接口/组件除以下清单以外的所有ArkUI组件:弹窗类组件、弹窗类接口以及按钮与选择类组件。 华为官方表示,变更后如果组件需要沉浸光感效果,需要将该组件放置于Navigation/NavDestination标题栏或Tabs的底部TabBar。