-
本模块首批接口从API version 21开始支持。后续版本的新增接口，采用上角标单独标记该接口的起始版本。
-
本模块接口仅可在Stage模型下使用。
- 入门了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用
- 分发通过华为应用市场发布你的应用，多渠道触达用户
- 推广与变现一站式流量增长与营销变现平台
- 文档获取全旅程官方文档，助力鸿蒙应用开发、上架与运营。
- 支持获取客服帮助、技术支持、活动资讯等信息
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
禁用反色能力
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
更新时间: 2026-09-09 06:54
复制页面
本文导读
设置组件是否使用反色能力，反色能力是在深浅色切换时自动对颜色值进行反色或变换，开发者可以通过主动设置不启用反色算法，以保持在深浅色切换时的原有逻辑。
说明
allowForceDark
Phone21+PC/2in121+Tablet21+TV21+Wearable21+
allowForceDark(value: boolean): T
设置组件是否使用反色能力。
说明
-
当组件主动设置不使用反色能力时，该组件及其所有子组件均不启用反色能力，不受父组件、祖先组件以及自身子组件的反色配置影响。
-
该接口仅在开启了反色能力的情况下生效，开启反色能力可参考利用反色能力快速适配深色模式。
元服务API： 从API version 21开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| value | boolean | 是 | 组件是否使用反色能力。true：组件使用反色能力；false：组件不使用反色能力。 |
返回值：
展开
| 类型 | 说明 |
|---|---|
| T | 返回当前组件。 |
示例
// 组件添加allowForceDark(false)属性后，说明对当前组件不使用反色相关能力。
@Entry
@Component
struct ComponentPage {
build() {
Column() {
Column() {
Text("Hello World")
.fontSize(20)
.fontColor(Color.Blue)
.onClick(() => {
console.info(`Text is clicked`);
})
}
.allowForceDark(false) // Column及其子组件Text不生效反色能力，不受父组件Column使用反色能力的影响。
Row() {
Button('BUTTON')
.backgroundColor(Color.Grey)
.allowForceDark(true)
.onClick(() => {
console.info(`Button is clicked`);
})
}
.allowForceDark(false) // Row及其子组件Button不生效反色能力，不受父组件Column使用反色能力的影响。
}
.allowForceDark(true)
.width('100%')
.height('100%')
}
} 
华为开发者联盟 版权所有 ©2026