首页/新闻资讯/正文详情

及时做APP开发实战(十)-深浅色主题适配实现

发布时间:2026/11/19 23:13:50 来源:云帆数科 栏目:资讯中心
及时做APP开发实战(十)-深浅色主题适配实现
及时做APP开发实战(十)-深浅色主题适配实现本文将详细介绍如何在HarmonyOS NEXT中实现深浅色主题适配让应用跟随系统主题动态切换。一、需求背景1.1 功能需求现代应用需要支持深浅色主题切换提供更好的用户体验┌─────────────────────────────────────┐ │ 主题适配需求 │ ├─────────────────────────────────────┤ │ • 跟随系统主题自动切换 │ │ • 动态更新所有UI组件颜色 │ │ • 保持主题切换的流畅性 │ │ • 抽离颜色常量便于维护 │ └─────────────────────────────────────┘1.2 技术方案HarmonyOS提供Configuration.colorMode监听系统主题变化模式说明COLOR_MODE_LIGHT浅色模式COLOR_MODE_DARK深色模式COLOR_MODE_NOT_SET跟随系统二、主题颜色设计2.1 颜色体系规划【图1颜色体系】┌─────────────────────────────────────┐ │ 颜色分类 │ ├─────────────────────────────────────┤ │ 背景色 │ │ - 页面背景 background │ │ - 卡片背景 cardBackground │ │ │ │ 文本色 │ │ - 主文本 textPrimary │ │ - 次要文本 textSecondary │ │ - 提示文本 textHint │ │ │ │ 主题色 │ │ - 主色 primary │ │ - 主色浅 primaryLight │ │ - 成功色 success │ │ - 警告色 warning │ │ │ │ 边框色 │ │ - 边框 border │ │ - 分割线 divider │ └─────────────────────────────────────┘2.2 ThemeColors接口定义exportinterfaceThemeColors{// 背景色background:string;cardBackground:string;// 文本色textPrimary:string;textSecondary:string;textHint:string;// 主题色primary:string;primaryLight:string;success:string;warning:string;// 边框色border:string;divider:string;}2.3 浅色主题配置constLightTheme:ThemeColors{background:#F5F5F5,cardBackground:#FFFFFF,textPrimary:#333333,textSecondary:#666666,textHint:#999999,primary:#FF6B6B,primaryLight:#FFE5E5,success:#4CAF50,warning:#FF9800,border:#E0E0E0,divider:#EEEEEE};2.4 深色主题配置constDarkTheme:ThemeColors{background:#1A1A1A,cardBackground:#2D2D2D,textPrimary:#FFFFFF,textSecondary:#B0B0B0,textHint:#808080,primary:#FF6B6B,primaryLight:#3D2D2D,success:#66BB6A,warning:#FFB74D,border:#404040,divider:#333333};三、ThemeUtil工具类实现3.1 类结构设计┌─────────────────────────────────────┐ │ ThemeUtil │ ├─────────────────────────────────────┤ │ - instance: ThemeUtil │ │ - currentTheme: ThemeColors │ │ - isDarkMode: boolean │ ├─────────────────────────────────────┤ │ getInstance(): ThemeUtil │ │ updateTheme(config): void │ │ getColors(): ThemeColors │ │ isDark(): boolean │ │ getBackgroundColor(): string │ │ getCardBackground(): string │ │ getTextPrimary(): string │ │ ...其他getter方法 │ └─────────────────────────────────────┘3.2 完整实现代码importConfigurationConstantfromohos.app.ability.ConfigurationConstant;import{Configuration}fromkit.AbilityKit;// 主题颜色接口同上exportinterfaceThemeColors{...}// 主题配置同上constLightTheme:ThemeColors{...};constDarkTheme:ThemeColors{...};exportclassThemeUtil{privatestaticinstance:ThemeUtil|nullnull;privatecurrentTheme:ThemeColorsLightTheme;privateisDarkMode:booleanfalse;// 私有构造函数privateconstructor(){}// 获取单例publicstaticgetInstance():ThemeUtil{if(!ThemeUtil.instance){ThemeUtil.instancenewThemeUtil();}returnThemeUtil.instance;}/** * 根据配置更新主题 */publicupdateTheme(configuration:Configuration):void{try{constcolorModeconfiguration.colorMode;this.isDarkModecolorModeConfigurationConstant.ColorMode.COLOR_MODE_DARK;this.currentThemethis.isDarkMode?DarkTheme:LightTheme;console.info([ThemeUtil] 主题已更新:${this.isDarkMode?深色:浅色});}catch(err){consterrorMsgerrinstanceofError?err.message:String(err);console.error([ThemeUtil] 更新主题失败:${errorMsg});}}/** * 获取当前主题颜色 */publicgetColors():ThemeColors{returnthis.currentTheme;}/** * 是否深色模式 */publicisDark():boolean{returnthis.isDarkMode;}// 其他getter方法...publicgetBackgroundColor():string{returnthis.currentTheme.background;}publicgetCardBackground():string{returnthis.currentTheme.cardBackground;}publicgetTextPrimary():string{returnthis.currentTheme.textPrimary;}publicgetTextSecondary():string{returnthis.currentTheme.textSecondary;}publicgetTextHint():string{returnthis.currentTheme.textHint;}publicgetPrimary():string{returnthis.currentTheme.primary;}publicgetSuccess():string{returnthis.currentTheme.success;}publicgetBorder():string{returnthis.currentTheme.border;}}四、Ability中监听主题变化4.1 在EntryAbility中添加监听import{AbilityConstant,ConfigurationConstant,UIAbility,Want,Configuration}fromkit.AbilityKit;import{ThemeUtil}from../utils/ThemeUtil;exportdefaultclassEntryAbilityextendsUIAbility{onCreate(want:Want,launchParam:AbilityConstant.LaunchParam):void{// 设置跟随系统主题try{this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);}catch(err){hilog.error(DOMAIN,testTag,Failed to set colorMode);}}/** * 监听系统配置变化包括主题变化 */onConfigurationUpdate(newConfig:Configuration):void{hilog.info(DOMAIN,testTag,Configuration updated);// 更新主题try{ThemeUtil.getInstance().updateTheme(newConfig);}catch(err){hilog.error(DOMAIN,testTag,Failed to update theme);}}}4.2 配置变化流程【图2主题切换流程】┌─────────────────────────────────────┐ │ 主题切换流程 │ ├─────────────────────────────────────┤ │ 用户切换系统主题 │ │ ↓ │ │ 系统发送Configuration变化事件 │ │ ↓ │ │ EntryAbility.onConfigurationUpdate │ │ ↓ │ │ ThemeUtil.updateTheme() │ │ ↓ │ │ 更新currentTheme和isDarkMode │ │ ↓ │ │ UI组件响应式更新 │ └─────────────────────────────────────┘五、页面中使用主题5.1 定义主题状态变量import{ThemeUtil,ThemeColors}from../utils/ThemeUtil;EntryComponentstruct PomodoroPage{// 主题状态StatethemeColors:ThemeColorsThemeUtil.getInstance().getColors();StateisDarkMode:booleanfalse;// 工具类privatethemeUtil:ThemeUtilThemeUtil.getInstance();// 生命周期asyncaboutToAppear(){// 初始化主题this.themeColorsthis.themeUtil.getColors();this.isDarkModethis.themeUtil.isDark();}}5.2 在UI组件中应用主题颜色BuilderTopBar(){Row(){Text( 番茄钟).fontSize(24).fontWeight(FontWeight.Bold).fontColor(#FFFFFF)}.width(100%).height(56).backgroundColor(this.isBreak?this.themeColors.success:this.themeColors.primary)}BuilderTimerSection(){Column(){// 进度条Progress({value:this.getProgress(),total:100,type:ProgressType.Ring}).color(this.isBreak?this.themeColors.success:this.themeColors.primary).backgroundColor(this.themeColors.border)// 时间显示Text(this.formatTime(this.timeLeft)).fontSize(64).fontWeight(FontWeight.Bold).fontColor(this.themeColors.textPrimary)}.width(100%).backgroundColor(this.themeColors.background)}BuilderPomodoroStats(){Column(){Row(){Column(){Text(this.pomodoroCount.toString()).fontSize(28).fontWeight(FontWeight.Bold).fontColor(this.themeColors.primary)Text(今日完成).fontSize(12).fontColor(this.themeColors.textSecondary)}}}.backgroundColor(this.themeColors.cardBackground)}5.3 半模态弹窗主题适配.bindSheet($$this.showTimePicker,this.TimePickerSheet(),{height:300,backgroundColor:this.isDarkMode?#2D2D2D:Color.White,dragBar:true,onWillDismiss:(){this.showTimePickerfalse;}})六、颜色对比效果6.1 浅色主题效果【图3浅色主题】6.2 深色主题效果【图4深色主题】七、最佳实践7.1 颜色使用规范// ✅ 推荐使用主题颜色.backgroundColor(this.themeColors.background).fontColor(this.themeColors.textPrimary)// ❌ 不推荐硬编码颜色.backgroundColor(#F5F5F5).fontColor(#333333)7.2 状态变量设计// ✅ 推荐使用State自动响应StatethemeColors:ThemeColorsThemeUtil.getInstance().getColors();// ❌ 不推荐普通变量不会触发更新privatethemeColors:ThemeColorsThemeUtil.getInstance().getColors();7.3 主题颜色扩展// 扩展主题颜色接口exportinterfaceThemeColors{// 基础颜色...// 扩展颜色error:string;// 错误色info:string;// 信息色disabled:string;// 禁用色}// 在主题配置中添加constLightTheme:ThemeColors{// 基础颜色...error:#F44336,info:#2196F3,disabled:#BDBDBD};八、总结本文实现了番茄钟应用的深浅色主题适配颜色体系设计定义完整的ThemeColors接口工具类封装ThemeUtil单例类管理主题状态系统监听在Ability中监听配置变化响应式更新使用State实现UI自动更新主题适配是现代应用的基本要求合理的设计可以让应用在各种环境下都有良好的显示效果。

相关推荐

Java 1.8运行时编译器:C1与C2原理及性能优化实践
Java 1.8运行时编译器:C1与C2原理及性能优化实践

1. Java运行时编译器的基本概念Java作为一门跨平台的编程语言,其核心特性之一就是"一次编写,到处运行"。这一特性主要依赖于Java虚拟机(JVM)的运行时编译机制。在Java 1.8版本中,JVM提供了两种不同的运行时编译器:Clien… · 2026/10/15 6:06:55

C++二叉树非递归遍历:前序、中序、后序的栈实现与工程实践
C++二叉树非递归遍历:前序、中序、后序的栈实现与工程实践

1. 项目概述:为什么二叉树遍历值得深究?在C的算法与数据结构世界里,二叉树是一个绕不开的经典模型。无论是面试中的高频考点,还是实际项目中(比如文件系统索引、表达式求值、游戏AI决策树)的底层支撑&#… · 2026/10/14 23:51:33

线下户外广告怎样实现精准转化?传播易一站式投放平台给出行业解法
线下户外广告怎样实现精准转化?传播易一站式投放平台给出行业解法

据《2026年中国户外广告行业发展白皮书》统计数据,2025年中国社区数字户外广告(DOOH)市场规模达到420亿元,同比增长22%。依托线下沉浸式场景触达、高效私域用户沉淀的核心价值,社区DOOH已成为品牌线下营销布局的核心阵地,推动整个… · 2026/10/14 7:13:54

2026河南最新政策下特种设备司炉工培训怎么选才不吃亏
2026河南最新政策下特种设备司炉工培训怎么选才不吃亏

2026河南最新政策下特种设备司炉工培训怎么选才不吃亏 怕考不过白交培训费?2026河南最新政策下,特种设备司炉工培训不是随便找个机构就能搞定的事。很多人报名前没搞清规则,结果要么钱花了证没拿到,要么培训内容和考试脱节,浪费时间和金钱。今天… · 2026/11/19 23:12:56

电工证有什么分别内部消息告诉你怕考不过白交培训费
电工证有什么分别内部消息告诉你怕考不过白交培训费

电工证有什么分别内部消息告诉你怕考不过白交培训费 怕考不过白交培训费?电工证有什么分别?这个问题我从业十年都听得耳朵起茧了。今天我就掏心窝子给你讲讲,别看这证看起来都叫“电工证”,其实考哪一种、怎么考、能干啥,差得可不是一星半点。… · 2026/11/19 23:12:56

特种设备司炉工培训怎么选?内部消息帮你避开报名陷阱
特种设备司炉工培训怎么选?内部消息帮你避开报名陷阱

特种设备司炉工培训怎么选?内部消息帮你避开报名陷阱 你是不是也这样,想考特种设备司炉工证,却不知道去哪报名,怕被中介坑?别急,这波 内部消息 我直接告诉你怎么选靠谱的培训渠道,还能避开那些坑人的套路。… · 2026/11/19 23:12:56

荆门电工证去哪里复审 上岗必备实操考试怎么准备
荆门电工证去哪里复审 上岗必备实操考试怎么准备

荆门电工证去哪里复审 上岗必备实操考试怎么准备 实操考试心里没底怕挂科?荆门电工证去哪里复审成了很多持证人最头疼的问题。尤其是像你这样在周口中小施工企业干活的师傅,电工证不仅是上岗必备,更是关系到你和同事的安全命根子。别急,下面这些建议和经… · 2026/11/19 23:12:56

荆门电工证去哪里复审 内部消息告诉你怎么搞
荆门电工证去哪里复审 内部消息告诉你怎么搞

荆门电工证去哪里复审 内部消息告诉你怎么搞 你急需特种作业证才能上岗找工作,别等考试过了才想起复审,现在就告诉你内部消息:荆门电工证复审不是随便找个地方就能搞定的,必须按流程来,否则证书作废,连工作都别想干。… · 2026/11/19 23:12:56

淮安住建局电工证上岗必备,怕考不过白交培训费?看这篇就够了
淮安住建局电工证上岗必备,怕考不过白交培训费?看这篇就够了

淮安住建局电工证上岗必备,怕考不过白交培训费?看这篇就够了 怕考不过白交培训费?那你不是一个人。很多刚接触电工行业的朋友都遇到过这种情况,报名参加培训,交了钱,结果考试不过,不仅浪费了时间,还浪费了钱。特别是在淮安,想要拿到【淮安住建局电工… · 2026/11/19 23:11:56

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07

姑苏区哪里考电工证好考前押题怎么找
姑苏区哪里考电工证好考前押题怎么找

姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12

罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南

罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12

罗定能考电工证吗 电工证含金量到底有多少?
罗定能考电工证吗 电工证含金量到底有多少?

罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码