uni.onThemeChange(CALLBACK)

监听系统主题状态变化。

相关文档：DarkMode 适配指南

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序	飞书小程序	QQ小程序	快手小程序	京东小程序	元服务
iOS 2.6.5+、Android 3.6.9+	HBuilderX 3.6.9+	基础库 2.11.0+	x	x	x	V5.3.0+	x	x	x	x

HarmonyOS Next 兼容性

HarmonyOS Next
x

CALLBACK 返回参数

参数	类型	说明
theme	String	主题名称(dark, light)

参数 HarmonyOS Next 兼容性

名称	HarmonyOS Next 兼容性
callback	-

OnThemeChangeCallbackResult 的属性值

名称	HarmonyOS Next 兼容性
theme	-

示例

uni.onThemeChange(function (res) {
	console.log(res.theme);
});

uni.offThemeChange(CALLBACK)

取消监听系统主题状态变化。

相关文档：DarkMode 适配指南

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序	飞书小程序	QQ小程序	快手小程序	京东小程序	元服务
HBuilderX 3.6.9+	HBuilderX 3.6.9+	基础库 2.11.0+	x	x	x	V5.3.0+	x	x	x	x

HarmonyOS Next 兼容性

HarmonyOS Next
x

参数

Function CallBack：onThemeChange 传入的监听函数。

示例

const callback = function (res) {
	console.log(res.theme);
}
uni.onThemeChange(callback);
uni.offThemeChange(callback); // 此时不再触发 callback 方法

注意

• 自定义基座生效
• App 端需要开启暗黑模式。5+ App uni-app 暗黑模式