基于原生的应用主题开发-鸿蒙开发者社区-51CTO.COM

基于原生的应用主题开发

基于原生的应用主题开发

HarmonyOS
2024-07-25 10:21:21
浏览
收藏 0
回答 1
待解决
回答 1
按赞同
/
按时间
day_night

场景一:设置应用自定义主题颜色

方案

CustomColors自定义主题颜色资源类型。

类型

说明

Partial< Colors >

自定义主题颜色资源类型。


方法一:

  • 在ability中设置ThemeControl。
  • 约束:如果在ability中设置,需要在onWindowStageCreate()方法中setDefaultTheme。

接口名

方法/属性名

是否必填

描述(说明默认值)

所属文件

ThemeControl

setDefaultTheme(theme: CustomTheme): void

将自定义Theme应用于APP组件,实现APP组件风格跟随Theme切换。Theme后续可扩展shape, typograph

@ohos.arkui.theme.d.ts


方法二:

  • 在页面入口处统一设置。
  • 约束:要在页面build前执行ThemeControl。

案例代码

方案一:在ability中设置ThemeControl。

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit'; 
import { hilog } from '@kit.PerformanceAnalysisKit'; 
import { window, CustomColors, ThemeControl } from '@kit.ArkUI'; 
 
class RedColors implements CustomColors { 
  fontEmphasize = 0xFFD53032 
  iconEmphasize = 0xFFD53032 
  backgroundEmphasize = 0xFFD53032 
} 
 
const abilityThemeColors = new RedColors(); 
 
export default class EntryAbility extends UIAbility { 
  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) ?? ''); 
      // invoking here works good 
      ThemeControl.setDefaultTheme({ 
        colors: abilityThemeColors 
      }) 
      hilog.info(0x0000, 'testTag', '%{public}s', 'ThemeControl.setDefaultTheme done'); 
    }); 
  } 
}

方法二:在页面入口处统一设置在此之前需要自定义颜色,CustomTheme接口用于自定义Theme。CustomTheme的属性是可选的,只需要复写需要的修改的部分,其余部分会继承自系统。

// xxx.ets 
import { CustomColors, CustomTheme } from '@ohos.arkui.theme' 
 
export class AppColors implements CustomColors { 
  fontPrimary: ResourceColor = '#6A3E80' 
  fontOnPrimary: ResourceColor = '#FDECFF' 
  iconOnPrimary: ResourceColor = '#FDECFF' 
  iconFourth: ResourceColor = '#336A3E80' 
  compBackgroundTertiary: ResourceColor = '#Oc9162A8' 
  compBackgroundEmphasize: ResourceColor = '#FF75D9' 
  backgroundEmphasize: ResourceColor = '#FF75D9' 
  interactiveFocus: ResourceColor = '#FF75D9' 
  compBackgroundPrimary: ResourceColor = '#FFF1FB' 
  compBackgroundSecondary: ResourceColor = '#199162A8' 
} 
 
export class CustomTheme1 implements CustomTheme { 
} 
 
export let gCustomTheme1: CustomTheme = new CustomTheme1() 
 
export class AppTheme implements CustomTheme { 
  public colors: AppColors = new AppColors() 
} 
 
export let gAppTheme: CustomTheme = new AppTheme()
// xxx.ets 
import { ThemeControl } from '@ohos.arkui.theme' 
import { gAppTheme } from './AppTheme' 
 
// 在页面build前执行ThemeControl,就可以改变主题颜色 
ThemeControl.setDefaultTheme(gAppTheme) 
 
@Entry 
@Component 
struct DisplayPage { 
  build() { 
    // 开发者需要自己补充的主题代码 
  } 
}

场景二:设置应用局部页面自定义主题和默认主题切换

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

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

组件名

方法/属性名

是否必填

描述(说明默认值)

所属文件

WithTheme(options: WithThemeOptions)

WithThemeOptions? {theme?: CustomTheme // 自定义ThemecolorMode?: ColorMode // 深浅色模式}

WithThemeOptions为自定义Theme或指定的深浅色模式

with_them

效果

案例代码

// xxx.ets 
import { CustomTheme } from '@ohos.arkui.theme' 
import { CustomTheme1, gAppTheme, gCustomTheme1 } from './AppColors' 
import { promptAction } from '@kit.ArkUI' 
import { BusinessError } from '@kit.BasicServicesKit' 
 
@Entry 
@Component 
struct DisplayPage { 
  fontPrimary: ResourceColor | undefined = gAppTheme?.colors?.fontPrimary 
  @State myTheme: CustomTheme = gAppTheme 
  @State isCustomTheme:boolean = false; 
  build() { 
    WithTheme({ theme: this.myTheme }) { 
      Column() { 
        Button('SwitchColors') 
          .onClick(()=>{ 
            this.isCustomTheme = !this.isCustomTheme 
            if(this.isCustomTheme){ 
              this.myTheme = gCustomTheme1 
              try { 
                promptAction.showToast({ 
                  message: '系统默认主题色', 
                  duration: 1000 
                }); 
              } catch (error) { 
                let message = (error as BusinessError).message 
                let code = (error as BusinessError).code 
                console.error(`showToast args error code is ${code}, message is ${message}`); 
              }; 
            } else { 
              this.myTheme = gAppTheme 
              try { 
                promptAction.showToast({ 
                  message: '自定义主题色', 
                  duration: 1000 
                }); 
              } catch (error) { 
                let message = (error as BusinessError).message 
                let code = (error as BusinessError).code 
                console.error(`showToast args error code is ${code}, message is ${message}`); 
              }; 
            } 
          }) 
        // 开发者需要自己补充的主题代码 
      } 
      .padding('10vp') 
      .backgroundColor(this.pageBackgroundColor) 
      .width('100%') 
      .height('100%') 
    } 
  } 
}

其他常见问题

1. 场景一和场景二的区别在哪里?如代码所见,可以看到场景二的这块绘制页面代码都是被包在WithTheme之中的,所以场景二主要使用于页面内局部的主题颜色适配,而场景一是全局的。

2. 可以用Theme来设置页面局部深浅色吗?

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

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

分享
微博
QQ
微信
回复
2024-07-25 18:40:12
相关问题
基于原生能力应用跳转
745浏览 • 1回复 待解决
基于原生水印添加能力
665浏览 • 1回复 待解决
基于原生能力组件封装
365浏览 • 1回复 待解决
基于原生能力网络状态感知
439浏览 • 1回复 待解决
基于原生跨模块资源访问
605浏览 • 1回复 待解决
应用内黑白主题切换
249浏览 • 1回复 待解决
基于原生实现高级显示效果
531浏览 • 1回复 待解决
基于原生能力网络加载性能分析
669浏览 • 1回复 待解决
HarmonyOS 应用主题实现方案
274浏览 • 1回复 待解决
鸿蒙原生应用开发进展咋样了?
3952浏览 • 1回复 待解决
基于原生能力设备唯一ID方案
671浏览 • 1回复 待解决
基于原生能力实现图文混排
386浏览 • 1回复 待解决
HarmonyOS 原生应用UI设计问题
303浏览 • 1回复 待解决
服务卡片只能基于JAVA开发吗?
3307浏览 • 1回复 待解决