鸿蒙5.0开发进阶:ArkTS组件-主题(WithTheme)

HarmonyOS NEXT实战开发:自定义扩展(设置主题换肤) 对于使用ets声明式前端开发的应用,提供应用内组件的主题能力,支持局部深浅色、动态换肤功能。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


WithTheme

WithTheme组件用于设置应用局部页面自定义主题风格,可设置子组件深浅色模式和自定义配色。

说明

该组件从API Version 12开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

支持单个子组件。

接口

WithTheme(options: WithThemeOptions)

参数:

参数名参数类型必填参数描述
optionsWithThemeOptions是设置作用域内组件配色。

属性

不支持通用属性。

事件

不支持通用事件。

WithThemeOptions

设置WithTheme作用域内组件缺省样式及深浅色模式。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数名参数类型必填参数描述
themeCustomTheme否

用于自定义WithTheme作用域内组件缺省配色。

默认值:undefined,缺省样式跟随系统token默认样式。

colorModeThemeColorMode否

用于指定WithTheme作用域内组件配色深浅色模式。

默认值:ThemeColorMode.System。

ThemeColorMode10+枚举说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称描述
SYSTEM跟随系统深浅色模式。
LIGHT固定使用浅色模式。
DARK固定使用深色模式。

示例

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

dark.json数据示例:

  {
    "color": [
      {
        "name": "start_window_background",
        "value": "#FFFFFF"
      }
    ]
  }
// 指定局部深浅色模式
@Entry
@Component
struct Index {
  build() {
    Column() {
    // 系统默认
      Column() {
        Text('无WithTheme')
          .fontSize(40)
          .fontWeight(FontWeight.Bold)
      }
      .justifyContent(FlexAlign.Center)
      .width('100%')
      .height('33%')
      .backgroundColor($r('sys.color.background_primary'))
      // 设置组件为深色模式
      WithTheme({ colorMode: ThemeColorMode.DARK }) {
        Column() {
          Text('WithTheme')
            .fontSize(40)
            .fontWeight(FontWeight.Bold)
          Text('DARK')
            .fontSize(40)
            .fontWeight(FontWeight.Bold)
        }
        .justifyContent(FlexAlign.Center)
        .width('100%')
        .height('33%')
        .backgroundColor($r('sys.color.background_primary'))
      }
      // 设置组件为浅色模式
      WithTheme({ colorMode: ThemeColorMode.LIGHT }) {
        Column() {
          Text('WithTheme')
            .fontSize(40)
            .fontWeight(FontWeight.Bold)
          Text('LIGHT')
            .fontSize(40)
            .fontWeight(FontWeight.Bold)
        }
        .justifyContent(FlexAlign.Center)
        .width('100%')
        .height('33%')
        .backgroundColor($r('sys.color.background_primary'))
      }
    }
    .height('100%')
    .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.END, SafeAreaEdge.BOTTOM, SafeAreaEdge.START])
  }
}

// 自定义WithTheme作用域内组件缺省配色
import { CustomTheme, CustomColors } from '@kit.ArkUI';

class GreenColors implements CustomColors {
  fontPrimary = '#ff049404';
  fontEmphasize = '#FF00541F';
  fontOnPrimary = '#FFFFFFFF';
  compBackgroundTertiary = '#1111FF11';
  backgroundEmphasize = '#FF00541F';
  compEmphasizeSecondary = '#3322FF22';
}

class RedColors implements CustomColors {
  fontPrimary = '#fff32b3c';
  fontEmphasize = '#FFD53032';
  fontOnPrimary = '#FFFFFFFF';
  compBackgroundTertiary = '#44FF2222';
  backgroundEmphasize = '#FFD00000';
  compEmphasizeSecondary = '#33FF1111';
}

class PageCustomTheme implements CustomTheme {
  colors?: CustomColors

  constructor(colors: CustomColors) {
    this.colors = colors
  }
}

@Entry
@Component
struct IndexPage {
  static readonly themeCount = 3;
  themeNames: string[] = ['System', 'Custom (green)', 'Custom (red)'];
  themeArray: (CustomTheme | undefined)[] = [
    undefined, // System
    new PageCustomTheme(new GreenColors()),
    new PageCustomTheme(new RedColors())
  ]
  @State themeIndex: number = 0;

  build() {
    Column() {
      Column({ space: '8vp' }) {
        Text(`未使用WithTheme`)
        // 点击按钮切换局部换肤
        Button(`切换theme配色:${this.themeNames[this.themeIndex]}`)
          .onClick(() => {
            this.themeIndex = (this.themeIndex + 1) % IndexPage.themeCount;
          })

        // 系统默认按钮配色
        Button('Button.style(NORMAL) with System Theme')
          .buttonStyle(ButtonStyleMode.NORMAL)
        Button('Button.style(EMP..ED) with System Theme')
          .buttonStyle(ButtonStyleMode.EMPHASIZED)
        Button('Button.style(TEXTUAL) with System Theme')
          .buttonStyle(ButtonStyleMode.TEXTUAL)
      }
      .margin({
        top: '50vp'
      })

      WithTheme({ theme: this.themeArray[this.themeIndex] }) {
        // WithTheme作用域
        Column({ space: '8vp' }) {
          Text(`使用WithTheme`)
          Button('Button.style(NORMAL) with Custom Theme')
            .buttonStyle(ButtonStyleMode.NORMAL)
          Button('Button.style(EMP..ED) with Custom Theme')
            .buttonStyle(ButtonStyleMode.EMPHASIZED)
          Button('Button.style(TEXTUAL) with Custom Theme')
            .buttonStyle(ButtonStyleMode.TEXTUAL)
        }
        .width('100%')
      }
    }
  }
}

【HarmonyOS NEXT】鸿蒙系统应用深浅色适配 当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,应用应适配深浅色模式。 阅读详情

相关推荐

鸿蒙5.0版开发:ArkTS组件-WithTheme

WithTheme组件用于设置应用局部页面自定义主题风格,可设置子组件深浅色模式和自定义配色。

m0_69424697的博客 552

鸿蒙OpenHarmony【WithTheme】主题

WithTheme组件用于设置应用局部页面自定义主题风格,可设置子组件深浅色模式和自定义配色。

hhhhhh2323的博客 582

鸿蒙5.0版开发:ArkTS基础组件(WithTheme)

WithTheme组件用于设置应用局部页面自定义主题风格,可设置子组件深浅色模式和自定义配色。

m0_69424697的博客 638

鸿蒙UI开发——使用WidthTheme实现局部深浅色

在实际的应用开发中,我们可能需要在界面中局部应用深色或者浅色的界面样式,与全局的深色、亮色同时生效。场景例如:深/亮色预览。此时,我们可以使用WithTheme能力来达到我们的效果。

harmonyClassRoom的博客 858

【鸿蒙实战开发】混合开发-web组件入门和实战

/ 网页是否在加载中// 网页加载进度// 当前访问页面历史记录索引@BuilderRow() {.width(18)// 刷新网页}).width(50)test 方法,获取网页调用后传参select 方法,选择原生相册,获取选择图片结果显示到网页中// 测试方法// 选择相册// 2\. JSBridge代理// 参数 1:注入应用侧JavaScript对象// 参数 2:注入对象的名称,与window中调用的对象名一致。

HarmonyOSMN的博客 1960

求助:有没有基于pscad的锂电池仿真模型

求助:有没有基于pscad的锂电池仿真模型 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章,了解一下Markdown的基本语法知识。 新的改变没有 我们对Markdown编辑器进行了一些功能拓展与语法支持,除了标准的Markdown编辑器功能,我们增加了如下几点新功能,帮助你用它写...

qq_38922523的博客 1223

基于原生的应用主题开发

hongxiaomeng的博客 538

JavaScript比较与逻辑运算符底层原理详解

JavaScript中的比较运算符(如==、===、>)和逻辑运算符(如&&、||)并非简单返回布尔值,而是基于类型转换规则(ToNumber、ToPrimitive、ToBoolean)执行抽象操作的确定性过程。理解其背后的标准协议——抽象相等比较、严格相等判断、关系运算数值化,以及逻辑运算的短路与原值返回机制,是避免隐式转换陷阱、写出可预测代码的关键。这些机制直接支撑着条件判断、默认值处理、安全访问等高频工程实践,广泛应用于表单校验、API响应处理、状态管理及UI渲染逻辑中。

weixin_32075843的博客 332

鸿蒙6.0应用开发——切换主题

对于采用ArkTS开发的应用,提供了应用内组件的主题换肤功能,支持局部的深浅色切换及动态换肤。目前,该功能只支持设置应用内主题换肤,暂不支持在UIAbility或窗口层面进行主题设置,同时也不支持C-API和Node-API。

高心星的专栏 4382

Vivado FIR Complier_IP核使用方法

文章依靠该IP核对应手册PG149写的,因为笔者需求简单,没有深入挖掘功能,可以自行下载学习。

2302_80180551的博客 4001

VS2022跨平台开发实战:SSH远程调试Linux程序全攻略

本文详细介绍了如何使用Visual Studio 2022进行跨平台开发,通过SSH协议远程调试部署在Linux服务器上的C/C++程序。文章提供了从环境搭建、连接配置、项目创建到编译调试的完整实战指南,帮助Windows开发者无缝衔接Linux环境,显著提升问题定位与开发效率。

weixin_28826521的博客 431

【鸿蒙next开发】ArkUI框架:ArkTS组件-WithTheme

该组件通过WithThemeOptions参数配置,可指定ThemeColorMode(系统/浅色/深色模式)和CustomTheme自定义配色。

m0_73088370的博客 923

无刷电机控制基础(2)——有感和无感驱动、调速

上一篇文章我们讲了一些无刷电机的基础知识,包括无刷电机的内部结构,驱动原理等,我们知道了只需要按照转子的当前位置,来按顺序给定子线圈通电,就能让电机转动起来。但是,上一篇中我们跳过了一个关键步骤,就是如何检测转子的位置。本篇我们就讲讲常用的位置检测方法,以及引出的一些相关问题。我们知道,获取磁铁的位置可以用霍尔传感器,无刷电机的转子就是永磁体,因此只要在合适的位置安装霍尔传感器,就能知道转子的旋转位置。在无刷电机中,一般用3个开关型霍尔器件就能检测转子的位置。

小白白学电子 2万+

鸿蒙UI开发——自定义主题色

我们可以在UIAbility中设置ThemeControl,在onWindowStageCreate()方法中setDefaultTheme,设置应用内组件的自定义主题色。代码如下(26行):​​?'');return;?'');

harmonyClassRoom的博客 2258

回归预测 | MATLAB实现SVR(支持向量机回归)K折交叉验证

回归预测 | MATLAB实现SVR(支持向量机回归)K折交叉验证 目录回归预测 | MATLAB实现SVR(支持向量机回归)K折交叉验证基本介绍划分原理留一划分交叉验证K折交叉数据下载程序设计参考资料致谢 基本介绍 在机器学习里,通常来说我们不能将全部用于数据训练模型,否则我们将没有数据集对该模型进行验证,从而评估我们的模型的预测效果。为了解决这一问题,有如下常用的方法: 第一种是最简单的,也是很容易就想到的。我们可以把整个数据集分成两部分,一部分用于训练,一部分用于验证,这也就是我们经常提到的训练集

机器学习之心的博客,关注并私信文章链接,获取对应文章源码和数据。 6379

YOLOv13涨点改进 | 全网独家创新、HyperACE改进、注意力改进篇 | CVPR 2025| 引入LRSA局部区域自注意力模块,能提升其在细节捕捉、小目标检测和长距离依赖建模方面的能力

本文提出将LRSA(局部区域自注意力)模块集成到YOLOv13中,通过局部特征交互增强细节捕捉能力、小物体检测精度和长距离依赖建模。LRSA模块采用重叠图像块处理策略,在保持计算效率的同时提升复杂背景下的检测性能。文章详细介绍了模块结构、原理优势,并提供了三种改进方案:1)在主干网络添加LRSA层;2)将关键模块替换为DSC3k2_LRSA;3)采用HyperACE_LRSA结构。配套提供了完整的PyTorch实现代码和YAML配置文件,展示了该模块如何通过局部注意力机制平衡检测精度与推理速度。

Ai缝合怪、助力小伙伴高效发论文 345

鸿蒙0基础学习【设置应用内主题换肤】ArkUI

对于采用ArkTS开发的应用,提供了应用内组件的主题换肤功能,支持局部的深浅色切换及动态换肤。目前,该功能只支持设置应用内主题换肤,暂不支持在UIAbility或窗口层面进行主题设置,同时也不支持C-API和Node-API。

zhenggaoxiao232的博客 810

AD9914数字斜坡模式使用

类似的,如果DRG输出处于负斜率斜坡中间,DRCTL引脚由逻辑0变为逻辑1,那么DRG会立即切换成正斜率参数,恢复在两个限值之间振荡输出。当两个非驻留位同时设置时,每次DRG输出达到编程设定的上限值或下限值后(假定DRG过输出使能位(0x01[13])已设置),DROVER信号会产生一个正脉冲(两个DDS时钟周期)。不过,在非驻留操作中,DRG输出不一定保持在上下限值。例如,设置数字斜坡非驻留高位,则当达到上限值时,DRG会自动(立即)跳到下限值(这一过程并非以斜坡方式返回下限值,而是直接跳至下限值)。

wangjie36的博客 3866

鸿蒙中 自定义主题色以及换肤

ArkTS框架支持应用内组件级别的主题换肤功能,包括自定义主题色和局部深浅色切换。开发者可通过CustomTheme接口定义主题色,使用ThemeControl.setDefaultTheme()全局应用,或通过WithTheme容器实现局部主题设置。系统提供预定义Token支持深浅色自动适配,但需注意不支持UIAbility/窗口级设置,且在BuilderNode中使用需手动更新。深色模式需准备对应的资源文件。该功能为应用界面提供了灵活的换肤能力,同时保持与系统主题的一致性。

梦想不只是梦与想的博客 1188

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

《主题颜色自定义》四、ArkTS编译错误修复指南

错误信息触发代码Circle().fill({})根因分析不是 ArkUI 的全局枚举。在 ArkUI 中,渐变是通过等组件方法实现的,而不是通过fill()方法传入渐变对象。方法接受的参数类型是(包括ColorstringnumberResource),不支持渐变对象。修复方案// ❌ 编译错误:fill() 不支持渐变对象Circle().fill({})// ✅ 方案一:使用纯色 + 透明度模拟层次Circle()

army16的专栏 351

Outlook Express 6 (OE6) for Win7/Win8/Win10

英文版 Outlook Express6.0, 兼容Win7/Win10/WinXP,解压就可用。

styled-components:一本通

初体验 styled方法:将React组件包装成Styled组件 ()的三种情况 tagged template literal interpolations 插值表达式 mixin StyledComponent相关特性 extend 继承 withComponent component-selector innerRef isStyledComponent attr方法:给...

weixin_33860553的博客 967

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

Android 设置背景色或者主题。

转载自:Android 设置背景色或者主题。 Android设置布局背景为白色的三种方法: 一、在xml文件里可以直接设置:android:background="#ffffff"//白色其他颜色可以看Android开发:setAlpha()方法和常用RGB颜色表—-颜色, r g b分量数值(int), 16进制表示 一一对应 二、在Java文件里设置:LinearLayout myLay

三颗猴面包树 1359

鸿蒙HarmonyOS DevEcoStudio 设置模拟机主题样式 (去除模拟机标题头)

鸿蒙HarmonyOS DevEcoStudio 设置模拟机主题样式 (去除模拟机标题头)

二DUAN帝的博客 658

harmonyos的js UI框架简述

概述 JS UI框架是一种跨设备的高性能UI开发框架,支持声明式编程和跨设备多态UI。 阅读本开发指南前,开发者需要掌握以下基础知识: HTML5 CSS JavaScript 基础能力 声明式编程 JS UI框架采用类HTML和CSS声明式编程语言作为页面布局和页面样式的开发语言,页面业务逻辑则支持ECMAScript规范的JavaScript语言。JS UI框架提供的声明式编程,可以让开发者避免编写UI状态切换的代码,视图配置信息更加直观。 跨设备 开发框架架构上支持UI跨设备显示能力,运

漏网之鱼的博客 4374

HarmonyOS开发去掉title

在module节点中添加如下代码: "metaData":{ "customizeData":[ { "name": "hwc-theme", "value": "androidhwext:style/Theme.Emui.NoTitleBar", "extra":"" } ] }

qq_44693961的博客 620
上一篇: 鸿蒙5.0开发进阶:ArkTS组件-SaveButton
下一篇: 鸿蒙5.0开发进阶:ArkTS组件-元服务(AtomicServiceNavigation)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值