鸿蒙HarmonyOS开发:构建ArkUI应用级和页面级主题设置

21 篇文章 0 订阅
21 篇文章 0 订阅

概述

针对应用,构建ArkUI应用级和页面级主题设置能力,并提供局部深浅色模式设置、动态换肤等功能。

本文提供如下场景:

  • 自定义品牌色
  • 应用级自定义品牌色
  • 局部页面自定义主题风格
  • 局部深浅色

自定义品牌色

CustomTheme用于自定义主题,属性可选,只需要复写修改的部分,未修改内容继承于系统,参考系统缺省token色值。请参考:

  import { CustomColors, CustomTheme } from '@kit.ArkUI'

  export class AppColors implements CustomColors {
    //自定义品牌色
    brand: ResourceColor = '#FF75D9';
  }

  export class AppTheme implements CustomTheme {
    public colors: AppColors = new AppColors()
  }
  
  export let gAppTheme: CustomTheme = new AppTheme()

设置应用级自定义品牌色

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

    其中,onWillApplyTheme回调函数用于自定义组件获取当前生效的Theme对象。

      import { Theme, ThemeControl } from '@kit.ArkUI'
      import { gAppTheme } from './AppTheme'
      
      //在页面build前执行ThemeControl
      ThemeControl.setDefaultTheme(gAppTheme)
    
      @Entry
      @Component
      struct DisplayPage {
        @State menuItemColor: ResourceColor = $r('sys.color.background_primary')
        
        onWillApplyTheme(theme: Theme) {
          this.menuItemColor = theme.colors.backgroundPrimary;
        }
      
        build() {
          Column() {
            List({ space: 10 }) {
              ListItem() {
                Column({ space: '5vp' }) {
                  Text('Color mode')
                    .margin({ top: '5vp', left: '14fp' })
                    .width('100%')
                  Row() {
                    Column() {
                      Text('Light')
                        .fontSize('16fp')
                        .textAlign(TextAlign.Start)
                        .alignSelf(ItemAlign.Center)
                      Radio({ group: 'light or dark', value: 'light' })
                        .checked(true)
                    }
                    .width('50%')
    
                    Column() {
                      Text('Dark')
                        .fontSize('16fp')
                        .textAlign(TextAlign.Start)
                        .alignSelf(ItemAlign.Center)
                      Radio({ group: 'light or dark', value: 'dark' })
                    }
                    .width('50%')
                  }
                }
                .width('100%')
                .height('90vp')
                .borderRadius('10vp')
                .backgroundColor(this.menuItemColor)
              }
    
              ListItem() {
                Column() {
                  Text('Brightness')
                    .width('100%')
                    .margin({ top: '5vp', left: '14fp' })
                  Slider({ value: 40, max: 100 })
                }
                .width('100%')
                .height('70vp')
                .borderRadius('10vp')
                .backgroundColor(this.menuItemColor)
              }
    
              ListItem() {
                Column() {
                  Row() {
                    Column({ space: '5vp' }) {
                      Text('Touch sensitivity')
                        .fontSize('16fp')
                        .textAlign(TextAlign.Start)
                        .width('100%')
                      Text('Increase the touch sensitivity of your screen' +
                        ' for use with screen protectors')
                        .fontSize('12fp')
                        .fontColor(Color.Blue)
                        .textAlign(TextAlign.Start)
                        .width('100%')
                    }
                    .alignSelf(ItemAlign.Center)
                    .margin({ left: '14fp' })
                    .width('75%')
      
                    Toggle({ type: ToggleType.Switch, isOn: true })
                      .margin({ right: '14fp' })
                      .alignSelf(ItemAlign.Center)
                  }
                  .width('100%')
                  .height('80vp')
                }
                .width('100%')
                .borderRadius('10vp')
                .backgroundColor(this.menuItemColor)
              }
            }
          }
          .padding('10vp')
          .backgroundColor('#dcdcdc')
          .width('100%')
          .height('100%')
        }
      }
  • 在Ability中设置ThemeControl,需要在onWindowStageCreate()方法中setDefaultTheme。

      import {AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
      import { hilog } from '@kit.PerformanceAnalysisKit';
      import { window, CustomColors, ThemeControl } from '@kit.ArkUI';
    
      class AppColors implements CustomColors {
        fontPrimary = 0xFFD53032
        iconOnPrimary = 0xFFD53032
        iconFourth = 0xFFD53032
      }
      
      const abilityThemeColors = new AppColors();
      
      export default class EntryAbility extends UIAbility {
        onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
          hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
        }
      
        onDestroy() {
          hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
        }
      
        onWindowStageCreate(windowStage: window.WindowStage) {
          // Main window is created, set main page for this ability
          hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
        
          windowStage.loadContent('pages/Index', (err, data) => {
            if (err.code) {
              hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
              return;
            }
            hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
            // 在onWindowStageCreate()方法中setDefaultTheme
            ThemeControl.setDefaultTheme({ colors: abilityThemeColors })
            hilog.info(0x0000, 'testTag', '%{public}s', 'ThemeControl.setDefaultTheme done');
          });
        }
      
      }

注:如果setDefaultTheme的参数为undefined时,默认token值对应的色值参考系统缺省token色值

设置应用局部页面自定义主题风格

将自定义Theme的配色通过设置WithTheme作用于内组件缺省样式,WithTheme作用域内组件配色跟随Theme的配色生效。

在下面示例中,通过WithTheme({ theme: this.myTheme })将作用域内的组件配色设置为自定义主题风格。后续可通过更改this.myTheme更换主题风格。

onWillApplyTheme回调函数用于自定义组件获取当前生效的Theme对象。

  import { CustomColors, CustomTheme, Theme } from '@kit.ArkUI'

  class AppColors implements CustomColors {
    fontPrimary: ResourceColor = $r('app.color.brand_purple')
    backgroundEmphasize: ResourceColor = $r('app.color.brand_purple')
  }
  
  class AppColorsSec implements CustomColors {
    fontPrimary: ResourceColor = $r('app.color.brand')
    backgroundEmphasize: ResourceColor = $r('app.color.brand')
  }
  
  class AppTheme implements CustomTheme {
    public colors: AppColors = new AppColors()
  }
  
  class AppThemeSec implements CustomTheme {
    public colors: AppColors = new AppColorsSec()
  }
  
  @Entry
  @Component
  struct DisplayPage {
    @State customTheme: CustomTheme = new AppTheme()
    @State message: string = '设置应用局部页面自定义主题风格'
    count = 0;
  
    build() {
      WithTheme({ theme: this.customTheme }) {
        Row(){
          Column() {
            Text('WithTheme')
              .fontSize(30)
              .margin({bottom: 10})
            Text(this.message)
              .margin({bottom: 10})
            Button('change theme').onClick(() => {
              this.count++;
              if (this.count > 1) {
                this.count = 0;
              }
              switch (this.count) {
                case 0:
                  this.customTheme = new AppTheme();
                  break;
                case 1:
                  this.customTheme = new AppThemeSec();
                  break;
              }
            })
          }
          .width('100%')
        }
        .height('100%')
        .width('100%')
      }
    }
  }

设置应用页面局部深浅色

通过WithTheme可以设置深浅色模式,ThemeColorMode有三种模式,ThemeColorMode.SYSTEM模式表示跟随系统模式,ThemeColorMode.LIGHT模式表示浅色模式,ThemeColorMode.DARK模式表示深色模式。

在WithTheme作用域内,组件的样式资源取值跟随指定的模式读取对应的深浅色模式系统和应用资源值,WithTheme作用域内的组件配色跟随指定的深浅模式生效。

在下面的示例中,通过WithTheme({ colorMode: ThemeColorMode.DARK })将作用域内的组件设置为深色模式。

设置局部深浅色时,需要添加dark.json资源文件,深浅色模式才会生效。

  @Entry
  @Component
  struct DisplayPage {
    @State message: string = 'Hello World';
    @State colorMode: ThemeColorMode = ThemeColorMode.DARK;

    build() {
      WithTheme({ colorMode: this.colorMode }) {
        Row() {
          Column() {
            Text(this.message)
              .fontSize(50)
              .fontWeight(FontWeight.Bold)
            Button('Switch ColorMode').onClick(() => {
              if (this.colorMode === ThemeColorMode.LIGHT) {
                this.colorMode = ThemeColorMode.DARK;
              } else if (this.colorMode === ThemeColorMode.DARK) {
                this.colorMode = ThemeColorMode.LIGHT;
              }
            })
          }
          .width('100%')
        }
        .backgroundColor($r('sys.color.background_primary'))
        .height('100%')
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.END, SafeAreaEdge.BOTTOM, SafeAreaEdge.START])
      }
    }
  }

系统缺省token色值

Token场景类别LightDark
theme.colors.brand品牌色#ff0a59f7

#ff317af7

theme.colors.warning一级警示色#ffe84026

#ffd94838

theme.colors.alert二级警示色#ffed6f21

#ffdb6b42

theme.colors.confirm确认色#ff64bb5c

#ff5ba854

theme.colors.fontPrimary一级文本#e5000000

#e5ffffff

theme.colors.fontSecondary二级文本#99000000

#99ffffff

theme.colors.fontTertiary三级文本#66000000

#66ffffff

theme.colors.fontFourth四级文本#33000000

#33ffffff

theme.colors.fontEmphasize高亮文本#ff0a59f7

#ff317af7

theme.colors.fontOnPrimary一级文本反色#ffffffff

#ff000000

theme.colors.fontOnSecondary二级文本反色#99ffffff

#99000000

theme.colors.fontOnTertiary三级文本反色#66ffffff

#66000000

theme.colors.fontOnFourth四级文本反色#33ffffff

#33000000

theme.colors.iconPrimary一级图标#e5000000

#e5ffffff

theme.colors.iconSecondary二级图标#99000000

#99ffffff

theme.colors.iconTertiary三级图标#66000000

#66ffffff

theme.colors.iconFourth四级图标#33000000

#33ffffff

theme.colors.iconEmphasize高亮图标#ff0a59f7

#ff317af7

theme.colors.iconSubEmphasize高亮辅助图标#660a59f7

#66317af7

theme.colors.iconOnPrimary一级图标反色#ffffffff

#ff000000

theme.colors.iconOnSecondary二级图标反色#99ffffff

#99000000

theme.colors.iconOnTertiary三级图标反色#66ffffff

#66000000

theme.colors.iconOnFourth四级图标反色#33ffffff

#33000000

theme.colors.backgroundPrimary一级背景(实色/不透明色)#ffffffff

#ffe5e5e5

theme.colors.backgroundSecondary二级背景(实色/不透明色)#fff1f3f5

#ff191a1c

theme.colors.backgroundTertiary三级背景(实色/不透明色)#ffe5e5ea

#ff202224

theme.colors.backgroundFourth四级背景(实色/不透明色)#ffd1d1d6

#ff2e3033

theme.colors.backgroundEmphasize高亮背景(实色/不透明色)#ff0a59f7

#ff317af7

theme.colors.compForegroundPrimary前背景#ff000000

#ffe5e5e5

theme.colors.compBackgroundPrimary白色背景#ffffffff

#ffffffff

theme.colors.compBackgroundPrimaryTran白色透明背景#ffffffff

#33ffffff

theme.colors.compBackgroundPrimaryContrary常亮背景#ffffffff

#ffe5e5e5

theme.colors.compBackgroundGray灰色背景#fff1f3f5

#ffe5e5ea

theme.colors.compBackgroundSecondary二级背景#19000000

#19ffffff

theme.colors.compBackgroundTertiary三级背景#0c000000

#0cffffff

theme.colors.compBackgroundEmphasize高亮背景#ff0a59f7

#ff317af7

theme.colors.compBackgroundNeutral黑色中性高亮背景#ff000000

#ffffffff

theme.colors.compEmphasizeSecondary20%高亮背景#330a59f7

#33317af7

theme.colors.compEmphasizeTertiary10%高亮背景#190a59f7

#19317af7

theme.colors.compDivider分割线颜色#33000000

#33ffffff

theme.colors.compCommonContrary通用反色#ffffffff

#ff000000

theme.colors.compBackgroundFocus获焦态背景色#fff1f3f5

#ff000000

theme.colors.compFocusedPrimary获焦态一级反色#e5000000

#e5ffffff

theme.colors.compFocusedSecondary获焦态二级反色#99000000

#99ffffff

theme.colors.compFocusedTertiary获焦态三级反色#66000000

#66ffffff

theme.colors.interactiveHover通用悬停交互式颜色#0c000000

#0cffffff

theme.colors.interactivePressed通用按压交互式颜色#19000000

#19ffffff

theme.colors.interactiveFocus通用获焦交互式颜色#ff0a59f7

#ff317af7

theme.colors.interactiveActive通用激活交互式颜色#ff0a59f7

#ff317af7

theme.colors.interactiveSelect通用选择交互式颜色#33000000

#33ffffff

theme.colors.interactiveClick通用点击交互式颜色#19000000

#19ffffff

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。 

点击→【纯血版鸿蒙全套最新学习资料】希望这一份鸿蒙学习资料能够给大家带来帮助!~


 鸿蒙(HarmonyOS NEXT)最新学习路线

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发,不仅补充了华为官网未涉及的解决方案

路线图适合人群:

IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术

点击→纯血版全套鸿蒙HarmonyOS学习资料

2.视频学习资料+学习PDF文档

这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、(南向驱动、嵌入式等)鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。

HarmonyOS Next 最新全套视频教程

​​

 

 大厂面试必问面试题

​​

鸿蒙南向开发技术

​​

鸿蒙APP开发必备

​​

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

​​

《鸿蒙开发基础》

​​

《鸿蒙开发进阶》

《鸿蒙进阶实战》

​​


点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说,华为鸿蒙不再兼容安卓,对程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,才能在这个变革的时代中立于不败之地。 

  • 8
    点赞
  • 16
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值