logo
积分中心
鸿蒙UI开发——自定义主题色
头像 蓝亭书序 2026-11-18 13:33:01    发布
543 浏览 0 收藏

1、概述

ArkTs提供了应用内主题切换功能,支持全局主题切换,也支持局部主题切换,效果如下。本文针对主题切换做简单介绍。

图片

2、主题色

ArkTs提供了一套内置主题配色,有Colors对象持有,它包含了默认情况下,关于主题的基本资源枚举,枚举的key与说明如下:


brand  品牌色。
warning  一级警示色。
alert  二级提示色。
confirm  确认色。
fontPrimary  一级文本字体颜色。
fontSecondary  二级文本字体颜色。
fontTertiary  三级文本字体颜色。
fontFourth  四级文本字体颜色。
fontEmphasize  高亮字体颜色。
fontOnPrimary  一级文本反转颜色,用于彩色背景。
fontOnSecondary  二级文本反转颜色,用于彩色背景。
fontOnTertiary  三级文本反转颜色,用于彩色背景。
fontOnFourth  四级文本反转颜色,用于彩色背景。
iconPrimary  一级图标颜色。
iconSecondary  二级图标颜色。
iconTertiary  三级图标颜色。
iconFourth  四级图标颜色。
iconEmphasize  高亮图标颜色。
iconSubEmphasize  高亮辅助图标颜色。
iconOnPrimary  一级图标反转颜色,用于彩色背景。
iconOnSecondary  二级图标反转颜色,用于彩色背景。
iconOnTertiary  三级图标反转颜色,用于彩色背景。
iconOnFourth  四级图标反转颜色,用于彩色背景。
backgroundPrimary  一级背景颜色(实色,不透明)。
backgroundSecondary  二级背景颜色(实色,不透明)。
backgroundTertiary  三级背景颜色(实色,不透明)。
backgroundFourth  四级背景颜色(实色,不透明)。
backgroundEmphasize  高亮背景颜色(实色,不透明)。
compForegroundPrimary  前背景。
compBackgroundPrimary  白色背景。
compBackgroundPrimaryTran  白色透明背景。
compBackgroundPrimaryContrary  常亮背景。
compBackgroundGray  灰色背景。
compBackgroundSecondary  二级背景。
compBackgroundTertiary  三级背景。
compBackgroundEmphasize  高亮背景。
compBackgroundNeutral  黑色中性高亮背景颜色。
compEmphasizeSecondary  20%高亮背景颜色。
compEmphasizeTertiary  10%高亮背景颜色。
compDivider  通用分割线颜色。
compCommonContrary  通用反转颜色。
compBackgroundFocus  获焦态背景颜色。
compFocusedPrimary  获焦态一级反转颜色。
compFocusedSecondary  获焦态二级反转颜色。
compFocusedTertiary  获焦态三级反转颜色。
interactiveHover  通用悬停交互式颜色。
interactivePressed  通用按压交互式颜色。
interactiveFocus  通用获焦交互式颜色。
interactiveActive  通用激活交互式颜色。
interactiveSelect  通用选择交互式颜色。
interactiveClick  通用点击交互式颜色。


对应的颜色罗列如下:

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


我们可以在默认值的基础上对指定的颜色值做复写,其余部分将会使用默认值。假设我们需要修改几个颜色:brand、fontPrimary、iconOnPrimary、iconFourth,修改方法示意如下:


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

export class AppColors implements CustomColors {
  //自定义主题色
  brand = 0xFF75D9;
  fontPrimary = 0xFFD53032
  iconOnPrimary = 0xFFD53032
  iconFourth = 0xFFD53032
}

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

export let gAppTheme: CustomTheme = new AppTheme()


2.1、设置自定义全局主题

我们可以在UIAbility中设置ThemeControl,在onWindowStageCreate()方法中setDefaultTheme,设置应用内组件的自定义主题色。

代码如下(26行):


// EntryAbility.ets
import {AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window, CustomColors, ThemeControl } from '@kit.ArkUI';
import { gAppTheme } from './AppTheme'

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(gAppTheme)
      hilog.info(0x0000, 'testTag', '%{public}s', 'ThemeControl.setDefaultTheme done');
    });
  }

}


设置好后,我们写一个Page,代码如下:


@Entry
@Component
struct DisplayPage {
  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')
        }

        ListItem() {
          Column() {
            Text('Brightness')
              .width('100%')
              .margin({ top: '5vp', left: '14fp' })
            Slider({ value: 40, max: 100 })
          }
          .width('100%')
          .height('70vp')
          .borderRadius('10vp')
        }

        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')
        }
      }
    }
    .padding('10vp')
    .backgroundColor('#dcdcdc')
    .width('100%')
    .height('100%')
  }
}


效果如下(注意,在预览器里面看到的效果是默认主题效果,需要真机或模拟器才可以看到真实效果):

图片

默认情况下,效果如下:

图片

2.3、Page中获取自定义主题

我们可以在onWillApplyTheme回调函数获取用于使自定义组件获取当前生效的Theme对象。我们可以获取自定义的主题对象,读取指定的主题色值,代码示例如下(9 ~ 10行):


import { Theme, ThemeControl } from '@kit.ArkUI'

  @Entry
  @Component
  struct DisplayPage {
    @State menuItemColor: ResourceColor = $r('sys.color.background_primary')
    
    onWillApplyTheme(theme: Theme) {
      // theme是当前生效的主题对象
      this.menuItemColor = theme.colors.backgroundPrimary;
    }
  
    build() {
    // ...
    }
  }


2.4、局部应用主题色

我们可以通过设置WithTheme,将自定义主题Theme的配色应用于内部组件的默认样式。在WithTheme的作用范围内,组件的配色会根据Theme的配色进行调整。代码如下(29行):


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

class AppColors implements CustomColors {
  fontPrimary: Color = Color.Pink;
  backgroundEmphasize: Color = Color.Pink;
}

class AppColorsSec implements CustomColors {
  fontPrimary: Color = Color.Orange;
  backgroundEmphasize: Color = Color.Orange;
}

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('切换主题').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({ theme: this.myTheme })可将作用域内组件的配色设置为自定义主题风格。后续可以通过更新this.myTheme来更换主题风格。onWillApplyTheme回调函数用于使自定义组件能够获取当前生效的Theme对象。效果如下:

图片




©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255