更新记录

1.0.0（2025-11-01） 下载此版本

初版

平台兼容性

uni-app(4.84)

uni-app x(4.84)

vk-set-color-mode

鸿蒙应用颜色模式设置插件，用于设置应用的深色/浅色模式。

功能说明

该插件基于华为鸿蒙 API ApplicationContext.setColorMode() 实现，用于设置应用的颜色模式（深色模式、浅色模式或未设置）。

平台支持

• ✅ 鸿蒙 App（uni-app、uni-app-x）
• ❌ 其他平台（会返回不支持错误）

API 说明

setColorMode(options)

设置应用颜色模式

参数说明

SetColorModeOptions

ColorMode 类型

返回值

返回 Promise<SetColorModeResult>

SetColorModeResult

错误码

使用示例

1. Promise 方式

import { setColorMode } from "@/uni_modules/vk-set-color-mode"

// 设置深色模式
setColorMode({ 
  colorMode: "dark" 
}).then((res) => {
  console.log('设置成功:', res.success)
}).catch((err) => {
  console.log('设置失败:', err.errMsg)
});

// 设置浅色模式
setColorMode({ 
  colorMode: "light" 
}).then((res) => {
  console.log('设置成功:', res.success)
}).catch((err) => {
  console.log('设置失败:', err.errMsg)
});

// 设置为跟随系统
setColorMode({ 
  colorMode: "none" 
}).then((res) => {
  console.log('设置成功:', res.success)
}).catch((err) => {
  console.log('设置失败:', err.errMsg)
});

2. 回调方式

import { setColorMode } from "@/uni_modules/vk-set-color-mode"

setColorMode({
  colorMode: "dark",
  success: (res) => {
    console.log('设置成功:', res.success)
  },
  fail: (err) => {
    console.log('设置失败:', err.errMsg)
  },
  complete: (res) => {
    console.log('完成:', res)
  }
});

3. async/await 方式

import { setColorMode } from "@/uni_modules/vk-set-color-mode"

async function changeColorMode() {
  try {
    const res = await setColorMode({ 
      colorMode: "light" 
    });
    console.log('设置成功:', res.success);
  } catch (err) {
    console.log('设置失败:', err.errMsg);
  }
}

注意事项

1. 该插件仅支持鸿蒙 App 平台，其他平台调用会返回错误
2. 设置颜色模式后，应用会立即生效
3. 设置为 "none" 时，应用会跟随系统的颜色模式
4. 需要确保应用已正确初始化全局上下文 $globalContext
5. 颜色模式参数必须为 "light"、"dark" 或 "none" 之一

技术参考

• HarmonyOS ApplicationContext.setColorMode API
• HarmonyOS ConfigurationConstant.ColorMode

许可证

MIT License