HarmonyOS 鸿蒙Next 分层参数表使用实践分享|深色模式适配|逸校园开发实践

相信很多开发者朋友们在HarmonyOS NEXT开发中遇到过深色模式适配的问题，本文除了回顾常用深色模式适配方法，还介绍了一种根据系统分层参数表适配深色模式的方法。

一、常用深色模式适配方法：

1. 固定属性适配：对于部分组件的颜色属性，如背景色或字体颜色，若保持不变，可以直接设定固定色值或引用固定的资源文件。例如，将文本组件的颜色直接设置为固定色值#000000：

Text(“精品好礼”)

    .opacity(0.6)

    .fontColor($r(‘app.color.black_font_color’))

2. 双资源目录适配：在resources目录下新增dark子目录，用于存放深色模式下的特定颜色配置（color.json文件）和图片资源（media文件）。在深色模式下，系统会自动加载此目录中的颜色及图片资源，确保与浅色模式下的UI元素色彩差异性。例如，为深色模式下的各个UI组件指定相应的颜色值，并确保与浅色模式下同名颜色资源名称一致：

// 用资源ID方式设置Column背景色。（浅色模式色值为’#FA5A3C’、深色模式色值为’#000000’）

.backgroundColor($r(‘app.color.column_bg_color’))

3. 利用系统分层参数：对于支持深浅模式切换的系统层级颜色资源，可以直接引用这些具有分层特性的参数，使得当切换设备主题时，相关组件的颜色能根据系统当前颜色模式自动更新。例如，使用系统提供的分层参数颜色资源方式设置色值：

Text(item.price)

    .fontSize($r(‘app.integer.goods_font’)) 

    .fontColor($r(‘sys.color.ohos_id_color_foreground’)) //系统分层参数，后面有分享表格

4. 监听当前颜色模式变化：通过注册AbilityStage.onConfigurationUpdate事件监听器，实时捕捉到设备深浅颜色模式的变化，并据此动态调整UI布局结构或逻辑处理，以适应不同模式下的最佳视觉体验。

二、系统分层参数表获取与使用

部分参数表下载地址：项目文件预览 - docs:OpenHarmony documentation | OpenHarmony开发者文档 - GitCode

系统分层参数表使用：直接通过资源引用$r(“sys.xxx.xxxx”)即可，例如：($r(‘sys.color.ohos_id_color_foreground’))

三、效果：