HarmonyOS Next开辟学习手册——主题设置(设置主题换肤)

概述

针对应用，构建ArkUI应用级和页面级主题设置本领，并提供局部深淡色模式设置、动态换肤等功能。
本文提供如了局景：

• 自界说品牌色
  
• 应用级自界说品牌色
  
• 局部页面自界说主题风格
  
• 局部深淡色
  

自界说品牌色

CustomTheme 用于自界说主题，属性可选，只需要复写修改的部门，未修改内容继承于系统，参考 系统缺省token色值 。请参考：

1.   import { CustomColors, CustomTheme } from '@kit.ArkUI'
3.   export class AppColors implements CustomColors {
4.     //自定义品牌色
5.     brand: ResourceColor = '#FF75D9';
6.   }
8.   export class AppTheme implements CustomTheme {
9.     public colors: AppColors = new AppColors()
10.   }
11.   
12.   export let gAppTheme: CustomTheme = new AppTheme()

复制代码

设置应用级自界说品牌色

• 可在页面入口处同一设置，需要在页面build前执行 ThemeControl 。
  

其中， onWillApplyTheme 回调函数用于自界说组件获取当前生效的Theme对象。

1.   import { Theme, ThemeControl } from '@kit.ArkUI'
2.   import { gAppTheme } from './AppTheme'
3.   
4.   //在页面build前执行ThemeControl
5.   ThemeControl.setDefaultTheme(gAppTheme)
7.   @Entry
8.   @Component
9.   struct DisplayPage {
10.     @State menuItemColor: ResourceColor = $r('sys.color.background_primary')
11.    
12.     onWillApplyTheme(theme: Theme) {
13.       this.menuItemColor = theme.colors.backgroundPrimary;
14.     }
15.   
16.     build() {
17.       Column() {
18.         List({ space: 10 }) {
19.           ListItem() {
20.             Column({ space: '5vp' }) {
21.               Text('Color mode')
22.                 .margin({ top: '5vp', left: '14fp' })
23.                 .width('100%')
24.               Row() {
25.                 Column() {
26.                   Text('Light')
27.                     .fontSize('16fp')
28.                     .textAlign(TextAlign.Start)
29.                     .alignSelf(ItemAlign.Center)
30.                   Radio({ group: 'light or dark', value: 'light' })
31.                     .checked(true)
32.                 }
33.                 .width('50%')
35.                 Column() {
36.                   Text('Dark')
37.                     .fontSize('16fp')
38.                     .textAlign(TextAlign.Start)
39.                     .alignSelf(ItemAlign.Center)
40.                   Radio({ group: 'light or dark', value: 'dark' })
41.                 }
42.                 .width('50%')
43.               }
44.             }
45.             .width('100%')
46.             .height('90vp')
47.             .borderRadius('10vp')
48.             .backgroundColor(this.menuItemColor)
49.           }
51.           ListItem() {
52.             Column() {
53.               Text('Brightness')
54.                 .width('100%')
55.                 .margin({ top: '5vp', left: '14fp' })
56.               Slider({ value: 40, max: 100 })
57.             }
58.             .width('100%')
59.             .height('70vp')
60.             .borderRadius('10vp')
61.             .backgroundColor(this.menuItemColor)
62.           }
64.           ListItem() {
65.             Column() {
66.               Row() {
67.                 Column({ space: '5vp' }) {
68.                   Text('Touch sensitivity')
69.                     .fontSize('16fp')
70.                     .textAlign(TextAlign.Start)
71.                     .width('100%')
72.                   Text('Increase the touch sensitivity of your screen' +
73.                     ' for use with screen protectors')
74.                     .fontSize('12fp')
75.                     .fontColor(Color.Blue)
76.                     .textAlign(TextAlign.Start)
77.                     .width('100%')
78.                 }
79.                 .alignSelf(ItemAlign.Center)
80.                 .margin({ left: '14fp' })
81.                 .width('75%')
82.   
83.                 Toggle({ type: ToggleType.Switch, isOn: true })
84.                   .margin({ right: '14fp' })
85.                   .alignSelf(ItemAlign.Center)
86.                   .width('25%')
87.               }
88.               .width('100%')
89.               .height('80vp')
90.             }
91.             .width('100%')
92.             .borderRadius('10vp')
93.             .backgroundColor(this.menuItemColor)
94.           }
95.         }
96.       }
97.       .padding('10vp')
98.       .backgroundColor('#dcdcdc')
99.       .width('100%')
100.       .height('100%')
101.     }
102.   }

复制代码

• 在Ability中设置 ThemeControl ，需要在onWindowStageCreate()方法中 setDefaultTheme 。
  

1.   import AbilityConstant from '@ohos.app.ability.AbilityConstant';
2.   import hilog from '@ohos.hilog';
3.   import UIAbility from '@ohos.app.ability.UIAbility';
4.   import Want from '@ohos.app.ability.Want';
5.   import window from '@ohos.window';
6.   import { CustomColors, ThemeControl } from '@kit.ArkUI';
8.   class AppColors implements CustomColors {
9.     fontPrimary = 0xFFD53032
10.     iconOnPrimary = 0xFFD53032
11.     iconFourth = 0xFFD53032
12.   }
13.   
14.   const abilityThemeColors = new AppColors();
15.   
16.   export default class EntryAbility extends UIAbility {
17.     onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
18.       hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
19.     }
20.   
21.     onDestroy() {
22.       hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
23.     }
24.   
25.     onWindowStageCreate(windowStage: window.WindowStage) {
26.       // Main window is created, set main page for this ability
27.       hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
28.    
29.       windowStage.loadContent('pages/Index', (err, data) => {
30.         if (err.code) {
31.           hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
32.           return;
33.         }
34.         hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
35.         // 在onWindowStageCreate()方法中setDefaultTheme
36.         ThemeControl.setDefaultTheme({ colors: abilityThemeColors })
37.         hilog.info(0x0000, 'testTag', '%{public}s', 'ThemeControl.setDefaultTheme done');
38.       });
39.     }
40.   
41.   }

复制代码

注：假如setDefaultTheme的参数为undefined时，默认token值对应的色值参考 系统缺省token色值 。
设置应用局部页面自界说主题风格

将自界说Theme的配色通过设置 WithTheme 作用于内组件缺省样式，WithTheme作用域内组件配色跟随Theme的配色生效。
在下面示例中，通过WithTheme({ theme: this.myTheme })将作用域内的组件配色设置为自界说主题风格。后续可通过更改this.myTheme更换主题风格。
onWillApplyTheme 回调函数用于自界说组件获取当前生效的Theme对象。

1.   import { CustomColors, CustomTheme, Theme } from '@kit.ArkUI'
3.   class AppColors implements CustomColors {
4.     fontPrimary: ResourceColor = $r('app.color.brand_purple')
5.     backgroundEmphasize: ResourceColor = $r('app.color.brand_purple')
6.   }
7.   
8.   class AppColorsSec implements CustomColors {
9.     fontPrimary: ResourceColor = $r('app.color.brand')
10.     backgroundEmphasize: ResourceColor = $r('app.color.brand')
11.   }
12.   
13.   class AppTheme implements CustomTheme {
14.     public colors: AppColors = new AppColors()
15.   }
16.   
17.   class AppThemeSec implements CustomTheme {
18.     public colors: AppColors = new AppColorsSec()
19.   }
20.   
21.   @Entry
22.   @Component
23.   struct DisplayPage {
24.     @State customTheme: CustomTheme = new AppTheme()
25.     @State message: string = '设置应用局部页面自定义主题风格'
26.     count = 0;
27.   
28.     build() {
29.       WithTheme({ theme: this.customTheme }) {
30.         Row(){
31.           Column() {
32.             Text('WithTheme')
33.               .fontSize(30)
34.               .margin({bottom: 10})
35.             Text(this.message)
36.               .margin({bottom: 10})
37.             Button('change theme').onClick(() => {
38.               this.count++;
39.               if (this.count > 1) {
40.                 this.count = 0;
41.               }
42.               switch (this.count) {
43.                 case 0:
44.                   this.customTheme = new AppTheme();
45.                   break;
46.                 case 1:
47.                   this.customTheme = new AppThemeSec();
48.                   break;
49.               }
50.             })
51.           }
52.           .width('100%')
53.         }
54.         .height('100%')
55.         .width('100%')
56.       }
57.     }
58.   }

复制代码

设置应用页面局部深淡色

通过 WithTheme 可以设置深淡色模式， ThemeColorMode 有三种模式，ThemeColorMode.SYSTEM模式表现跟随系统模式，ThemeColorMode.LIGHT模式表现淡色模式，ThemeColorMode.DARK模式表现深色模式。
在WithTheme作用域内，组件的样式资源取值跟随指定的模式读取对应的深淡色模式系统和应用资源值，WithTheme作用域内的组件配色跟随指定的深浅模式生效。
在下面的示例中，通过WithTheme({ colorMode: ThemeColorMode.DARK })将作用域内的组件设置为深色模式。
设置局部深淡色时，需要在resources文件夹下添加dark目录，dark目录添加dark.json资源文件，深淡色模式才会生效。

1.   @Entry
2.   @Component
3.   struct DisplayPage {
4.     @State message: string = 'Hello World';
5.     @State colorMode: ThemeColorMode = ThemeColorMode.DARK;
7.     build() {
8.       WithTheme({ colorMode: this.colorMode }) {
9.         Row() {
10.           Column() {
11.             Text(this.message)
12.               .fontSize(50)
13.               .fontWeight(FontWeight.Bold)
14.             Button('Switch ColorMode').onClick(() => {
15.               if (this.colorMode === ThemeColorMode.LIGHT) {
16.                 this.colorMode = ThemeColorMode.DARK;
17.               } else if (this.colorMode === ThemeColorMode.DARK) {
18.                 this.colorMode = ThemeColorMode.LIGHT;
19.               }
20.             })
21.           }
22.           .width('100%')
23.         }
24.         .backgroundColor($r('sys.color.background_primary'))
25.         .height('100%')
26.         .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.END, SafeAreaEdge.BOTTOM, SafeAreaEdge.START])
27.       }
28.     }
29.   }

复制代码

系统缺省token色值

鸿蒙全栈开辟全新学习指南

有许多小伙伴不知道学习哪些鸿蒙开辟技术？不知道需要重点掌握哪些鸿蒙应用开辟知识点？而且学习时频仍踩坑，最终浪费大量时间。以是要有一份实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档用来跟着学习是非常有必要的。
针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开辟技术的学习路线，包含了鸿蒙开辟必掌握的核心知识要点，内容有（ArkTS、ArkUI开辟组件、Stage模子、多端部署、分布式应用开辟、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开辟、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。
本路线共分为四个阶段：

第一阶段：鸿蒙初中级开辟必备技能

第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH

第三阶段：应用开辟中高级就业技术

第四阶段：全网首发-工业级南向装备开辟就业技术：gitee.com/MNxiaona/733GH

《鸿蒙 (Harmony OS)开辟学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

开辟基础知识:gitee.com/MNxiaona/733GH

1.应用基础知识
2.设置文件
3.应用数据管理
4.应用安全管理
5.应用隐私掩护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开辟

1.Ability开辟
2.UI开辟
3.公共事件与关照
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.装备管理
12.装备使用信息统计
13.DFX
14.国际化开辟
15.折叠屏系列
16.……

鸿蒙开辟口试真题（含参考答案）:gitee.com/MNxiaona/733GH

鸿蒙入门讲授视频：

美团APP实战开辟讲授：gitee.com/MNxiaona/733GH

写在末了

• 假如你以为这篇内容对你还蛮有资助，我想邀请你帮我三个小忙：
  
• 点赞，转发，有你们的 『点赞和批评』，才是我创造的动力。
  
• 关注小编，同时可以期待后续文章ing