鸿蒙5.0开发进阶:主题设置(应用深浅色适配)

【HarmonyOS NEXT】鸿蒙系统应用深浅色适配 当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,应用应适配深浅色模式。 阅读详情

往期鸿蒙全套实战文章必看:


应用深浅色适配

概述

当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,应用应适配深浅色模式。从应用与系统配置关联的角度来看,适配深浅色模式可以分为下面两种情况:

应用跟随系统的深浅色模式

  1. 颜色适配
    • 自定义资源实现

      resources目录下增加深色模式限定词目录(命名为dark)并新建color.json文件,可显示深色模式颜色资源的配置。

      图1 resources目录结构示意

      例如,开发者可在这两个color.json中定义同名配色定义并赋予不同的色值。

      base/element/color.json文件:

      {
        "color": [
          {
            "name": "app_title_color",
            "value": "#000000"
          }
        ]
      }

      dark/element/color.json文件:

      {
        "color": [
          {
            "name": "app_title_color",
            "value": "#FFFFFF"
          }
        ]
      }
    • 通过系统资源实现

      开发者可直接使用的系统预置资源,即分层参数,同一资源ID在设备类型、深浅色等不同配置下有不同的取值。通过使用系统资源,不同的开发者可以开发出具有相同视觉风格的应用,不需要自定义2份颜色资源,在深浅色模式下也会自动切换成不同的颜色值。例如,开发者可调用系统资源中的文本主要配色来定义应用内文本颜色。

      Text('使用系统定义配色')
        .fontColor($r('sys.color.ohos_id_color_text_primary'))
  2. 图片资源适配

    采用资源限定词目录的方式。参照颜色适配的方法,需要将深色模式下对应的同名图片放到 dark/media 目录下,再通过$r的方式加载图片资源的key值,系统做深浅色模式切换时,会自动加载对应资源文件中的value值。

    对于 SVG 格式的一些简单图标,可以使用fillColor属性配合系统资源改变图片的绘制颜色。不通过两套图片资源的方式,也可以实现深浅色模式适配。

    Image($r('app.media.pic_svg'))
      .width(50)
      .fillColor($r('sys.color.ohos_id_color_text_primary'))
  3. Web组件适配

    Web组件支持对前端页面进行深色模式配置。

  4. 应用监听深浅色模式切换事件

    应用可以主动监听系统深浅色模式变化,进行其他类型的资源初始化等自定义逻辑。无论应用是否跟随系统深浅色模式变化,该监听方式均可生效。

    1. 在 AbilityStage 的 onCreate() 生命周期中获取APP当前的颜色模式并保存到 AppStorage。
      onCreate(): void {
        hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
        AppStorage.setOrCreate('currentColorMode', this.context.config.colorMode);
      }
    2. 在 AbilityStage 的 onConfigurationUpdate() 生命周期中获取最新变更的颜色模式并刷新到 AppStorage。
      onConfigurationUpdate(newConfig: Configuration): void {
        AppStorage.setOrCreate('currentColorMode', newConfig.colorMode);
        hilog.info(0x0000, 'testTag', 'the newConfig.colorMode is %{public}s', JSON.stringify(AppStorage.get('currentColorMode')) ?? '');
      }
    3. 在Page中通过 @StorageProp + @Watch 方式获取当前最新颜色并监听设备深色模式变化。
      @StorageProp('currentColorMode') @Watch('onColorModeChange') currentMode: number = ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT;
    4. 在 aboutToAppear 初始化函数中根据当前最新颜色模式刷新状态变量。
      aboutToAppear(): void {
        if (this.currentMode == ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT) {
          //当前为浅色模式,资源初始化逻辑
        }else {
          //当前为深色模式,资源初始化逻辑
        }
      }
    5. 在 @Watch 回调函数中执行同样的适配逻辑。
      onColorModeChange(): void {
        if (this.currentMode == ConfigurationConstant.ColorMode.COLOR_MODE_LIGHT) {
          //当前为浅色模式,资源初始化逻辑
        }else {
          //当前为深色模式,资源初始化逻辑
        }
      }

应用主动设置深浅色模式

应用默认配置为跟随系统切换深浅色模式,如不希望应用跟随系统深浅色模式变化,可主动设置应用的深浅色风格。设置后,应用的深浅色模式固定,不会随系统改变。

onCreate(): void {
  hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
  this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_DARK);
}

系统默认判断规则

  1. 如果应用调用上述setColorMode接口主动设置了深浅色,则以接口效果优先。
  2. 应用没有调用setColorMode接口时:
    • 如果应用工程dark目录下有深色资源,则系统内置组件在深色模式下会自动切换成为深色。
    • 如果应用工程dark目录下没有任何深色资源,则系统内置组件在深色模式下仍会保持浅色体验。

如果应用全部都是由系统内置组件/系统颜色开发,且想要跟随系统切换深浅色模式时,请参考以下示例修改代码来保证应用体验。

onCreate(): void {
  this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
}

HarmonyOS NEXT实战开发:自定义扩展(设置主题换肤) 对于使用ets声明式前端开发的应用,提供应用内组件的主题能力,支持局部深浅色、动态换肤功能。 阅读详情

相关推荐

HarmonyOS 5.0.0 或以上:实现文件夹操作与管理(创建 / 读取 / 删除目录与文件)

文件夹操作是构建本地存储系统的基础,适用于:创建用户自定义目录(如下载/草稿/日志)管理资源文件:列出、删除、重命名构建本地资料库 / 离线缓存结构本篇实现:创建本地文件夹向该文件夹写入多个文件读取该目录下所有文件名支持删除某个文件或整个目录。

2501_92048894的博客 1424

鸿蒙HarmonyOS创建并使用color资源文件

创建第一步: 创建第二步:注意这里都要输入color才可行。 使用第一种: 使用第二种:

冰雪齐迹 957

【鸿蒙开发教程】HarmonyOS NEXT应用开发之深色模式适配

本示例介绍在开发应用以适应深色模式时,对于深色和浅色模式的适配方案,采取了多种策略如下:1.固定属性适配:对于部分组件的颜色属性,如背景色或字体颜色,若保持不变,可直接设定固定色值或引用固定的资源文件。2.双资源目录适配:在resources目录下新增dark子目录,用于存放深色模式下的特定颜色配置(color.json文件)和图片资源(media文件)。在深色模式下,系统会自动加载此目录中的颜色及图片资源,确保与浅色模式下的UI元素色彩差异性。

HarmonyOS_001的博客 1653

基于原生的应用主题开发

hongxiaomeng的博客 538

鸿蒙(HarmonyOS)应用开发实战——深色模式适配

固定属性适配:对于部分组件的颜色属性,如背景色或字体颜色,若保持不变,可直接设定固定色值或引用固定的资源文件。双资源目录适配:在resources目录下新增dark子目录,用于存放深色模式下的特定颜色配置(color.json文件)和图片资源(media文件)。在深色模式下,系统会自动加载此目录中的颜色及图片资源,确保与浅色模式下的UI元素色彩差异性。利用系统分层参数。

CTrup的博客 1275

纯血鸿蒙APP实战开发——深色模式适配

固定属性适配:对于部分组件的颜色属性,如背景色或字体颜色,若保持不变,可直接设定固定色值或引用固定的资源文件。双资源目录适配:在resources目录下新增dark子目录,用于存放深色模式下的特定颜色配置(color.json文件)和图片资源(media文件)。在深色模式下,系统会自动加载此目录中的颜色及图片资源,确保与浅色模式下的UI元素色彩差异性。利用系统分层参数。

heyuan49的博客 1984

29、鸿蒙HarmonyOS Next开发:深浅色适配和应用主题换肤

本文介绍了应用深浅色模式适配的完整方案。主要内容包括:1.通过资源限定词和系统资源实现颜色、图片适配;2.提供Web组件、自定义节点、监听系统模式变化的适配方法;3.支持应用主动设置深浅色模式,并说明系统默认判断规则;4.详细阐述应用内主题换肤功能,包括自定义主题色设置、局部页面主题风格调整和深浅色切换;5.列出系统缺省的token色值表。文章给出了具体实现代码示例,并提供了使用建议,强调应优先采用监听系统模式变化的方式,避免直接通过函数适配颜色。

夜诺 2218

鸿蒙开发实战 Beta5.0版:基于原生能力的深色模式适配

通过使用系统资源,不同的开发者可以开发出具有相同视觉风格的应用,不需要自定义2份颜色资源,在深浅色模式下也会自动切换成不同的颜色值。小编在之前的鸿蒙系统扫盲中,有很多朋友给我留言,不同的角度的问了一些问题,我明显感觉到一点,那就是许多人参与鸿蒙开发,但是又不知道从哪里下手,因为资料太多,太杂,教授的人也多,无从选择。不通过两套图片资源的方式,也可以实现深浅色模式适配(补充:通过两套图片资源的方式也可以实现,修改svg图片中fill属性的颜色,然后将两张图片分别放置在不同的目录下)

2401_84917132的博客 1251

鸿蒙5.0开发实战案例:主题设置(应用深浅色适配)

当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,应用应适配深浅色模式。应用跟随系统的深浅色模式应用主动设置深浅色模式。

liudiaosi6的博客 1368

国密系列算法简介

众所周知,为了保障商用密码的安全性,国家商用密码管理办公室制定了一系列密码标准,包括SM1(SCB2)、SM2、SM3、SM4、SM7、SM9、祖冲之密码算法(ZUC)那等等。其中SM1、SM4、SM7、祖冲之密码(ZUC)是对称算法;SM2、SM9是非对称算法;SM3是哈希算法。目前,这些算法已广泛应用于各个领域中,期待有一天会有采用国密算法的区块链应用出现。其中SM1、SM7算法不公开,调用该...

HardessGod的博客 5778

EPLAN二次开发入门:Visual Studio 2019环境配置与插件调试实战

本文详细介绍了EPLAN二次开发入门的关键步骤,重点讲解如何在Visual Studio 2019中配置开发环境并进行插件调试。通过创建符合命名规范的项目、引用核心API库、实现插件接口以及使用附加进程调试等实战技巧,帮助电气工程师快速掌握EPLAN插件开发,提升自动化设计效率。

h6i7j8的博客 763

鸿蒙6.0应用开发——切换主题

对于采用ArkTS开发的应用,提供了应用内组件的主题换肤功能,支持局部的深浅色切换及动态换肤。目前,该功能只支持设置应用内主题换肤,暂不支持在UIAbility或窗口层面进行主题设置,同时也不支持C-API和Node-API。

高心星的专栏 4382

奥比中光Gemini335L SDK实战:从标定参数到3D点云转换

本文详细介绍了奥比中光Gemini 335L深度相机的SDK实战应用,重点讲解如何跳过繁琐的棋盘格标定,直接调用出厂预标定参数实现高效的3D点云转换。通过解析内参、外参获取及四种核心坐标转换模式,并结合OpenCV等工具,指导开发者快速将相机集成到机器人抓取、三维测量等项目中,实现开箱即用的3D视觉解决方案。

raspberrypi5的博客 643

HarmonyOS核心知识点:主题设置(应用深浅色适配)

当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,应用应适配深浅色模式。应用跟随系统的深浅色模式应用主动设置深浅色模式。

wuliusan5的博客 1710

机器学习 线性回归 头歌实训

第1关:简单线性回归与多元线性回归 第2关:线性回归的正规方程解 第3关:衡量线性回归的性能指标 第4关:scikit-learn线性回归实践 - 波斯顿房价预测

weixin_57270536的博客 1万+

BCC Python开发教程&常用BCC工具(一)

这个教程主要目的是展示如何使用python来进行bcc工具开发和编程。教程主要分为两个部分:可观察性和网络。文中的代码片段均都来自于bcc:代码片段的licenses见bcc中具体文件。也可参考bcc开发者手册以及end-users工具教程:。此外bcc还开放有lua接口。

hudongliang2006nb的专栏 2087

鸿蒙 应用适配深浅色模式

摘要:HarmonyOS支持应用适配深浅色模式,分为跟随系统自动切换和主动设置固定模式两种方式。适配要点包括:1)通过资源限定词目录(dark/)和系统预置资源实现颜色适配;2)使用WithTheme容器实现局部适配;3)通过onConfigurationUpdate监听模式变化;4)API20+支持高性能切换和反色能力优化。建议优先使用系统资源和状态变量绑定,避免性能损耗大的实现方式。适配时需注意高级组件限制和反色算法优先级规则。

梦想不只是梦与想的博客 1585

System Verilog学习笔记(十九)——覆盖率

覆盖率是用来衡量验证精度和完备性的数据指标。也可以告诉我们在仿真时设计的哪些结构被触发,哪些没被触发。高质量的验证需要满足以下三个条件。

ljy77882333的博客 2145

鸿蒙开发:适配系统深浅色模式

无论是Android还是iOS,在系统设置中,都有着深色和浅色两种外观模式,同样,鸿蒙系统中也存在这样的外观切换,如何让自己的应用,跟随着系统的模式进行动态切换呢?目前系统给我们提供了两种方式可以实现,一种是资源形式,一种是动态的代码形式。

知足常乐 1017

围绕国产化操作系统以及人大金仓地理空间库的GIS的解决方案,含超详细部署步骤以及与QGIS,GeoServer,PostGlS Shapefile lmport/Export Manager的连接步骤

人大金仓软件 2.1软件的下载以及授权的相关文件插件 2.2上传至虚拟机 2.3KingbaseES V8R6数据库部署过程 2.3.1创建安装用户 2.3.2赋权 2.3.3.创建安装目录且赋权 2.3.4 准备挂载 2.4kingbase安装方法 2.7postgis安装 3 人大金仓数据库与QGIS的连接 4 人大金仓数据库与PostGlS Shapefile lmport/Export Manager的连接 5 人大金仓数据库与geoserver的连接

挣钱花388的博客 2592

第5.2章 【自动驾驶行业融合定位核心】:手把手详解ESKF(误差卡尔曼滤波)理论公式及代码

自动驾驶定位中的ESKF(误差卡尔曼滤波)技术是解决IMU累积误差的关键,通过分离名义状态与误差状态实现高精度定位。其核心步骤包括:1)名义状态递推(位置/速度/姿态的基础物理计算);2)误差传播建模(雅可比矩阵F量化误差影响);3)协方差更新(评估定位不确定性)。ESKF在GNSS信号丢失(如隧道场景)、无卫星定位(地下车库)等场景发挥重要作用,通过融合多传感器数据维持定位精度。工程实现需解决零偏校准、协方差投影等关键问题,噪声参数需通过数据标定而非随意设置。掌握ESKF原理与实现是自动驾驶定位工程师的核

行知SLAM 709

鸿蒙HarmonyOS 5.0开发实战:深色模式实现案例

本示例介绍在开发应用以适应深色模式时,对于深色和浅色模式的适配方案......

m0_73088370的博客 1475

老版QQ原生表情gif动态

这是老版的QQ表情,不过全是动态的的,Windows照片查看器是不会动的,可以右击用浏览器打开查看,再说一遍是老版的,只是分享给宁愿用老版也要动态的人。

HarmonyOS APP应用主题切换

本示例展示多种应用主题切换。通过创建 base 同级资源文件夹 dark 和 light 完成深色浅色主题相关资源配置,实现深色浅色主题切换,在 ThemeConst 文件中配置自定义主题文件,通过控制变量实现多主题切换。通过能力,对Ability状态进行修改:其中AbilityManager.updateConfiguration()通过修改colorMode属性来更新配置系统主题颜色。

m0_71263309的博客 1965

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

鸿蒙5.0 APP开发案例分析:深色模式适配

深色模式(Dark Mode)又称之为暗色模式,是与日常应用使用过程中的浅色模式(Light Mode)相对应的一种UI主题。深色模式最早来源于人机交互领域的研究和实践,该模式并非简单地将页面背景变为黑色,文字内容变为白色,而是提供一整套适配深色模式的应用配色主题。深色模式相较浅色模式更加柔和,能减少亮度对用户眼睛造成的刺激和疲劳,此外深色模式能在一定程度上降低应用功耗,提升续航表现。应用深色模式适配,需遵循基本的UX设计原则,保障应用页面内容的易读性、舒适性和一致性。

mn_xiaona666的博客 1404

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

HarmonyOS开发实战:小分享-ColorMode深浅色模式设置与切换

摘要:本文详细介绍了HarmonyOS中深浅色模式(Dark Mode)的实现与切换方法。通过小分享App的EntryAbility示例,讲解了setColorMode、getColorMode等核心API的使用,包括三种颜色模式取值(跟随系统、深色、浅色)的选择策略。文章还涵盖了系统主题变化监听、资源目录适配规范(base/dark/light目录结构)以及实战开发中的注意事项,为开发者提供了完整的深浅色模式适配方案。

weixin_54000324的博客 279

Flutter 三方库 theme_tailor_annotation 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、严谨、多终端一致的主题架构实战

什么是 Theme Tailor?它是一套强大的代码生成工具。定义了其核心注解(Annotations)。通过这种方式,开发者只需定义一个简单的类,库就会自动生成处理深浅色模式切换、多终端缩放比例及组件级动态样式的样板代码(Boilerplate)。在追求高颜值、高性能的鸿蒙应用实践中,其价值无可替代。标志了主题元数据,由底层生成器(Generator)将其膨胀为完整的 Flutter 主题扩展。graph TDA["OhosTheme (注解类)"] --> B["theme_tailor 编译器"]

大山哥 1015
上一篇: 鸿蒙5.0开发进阶:自定义扩展(AttributeUpdater)
下一篇: 鸿蒙5.0开发进阶:设置主题换肤
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值