用户界面外观


用户界面外观

用户界面外观提供管理系统外观的一些基础能力,目前仅包括深浅色模式配置。

说明:

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

本模块接口为系统接口。

导入模块

import uiAppearance from '@ohos.uiAppearance'
1

DarkMode

深色模式枚举。

系统能力: SystemCapability.ArkUI.UiAppearance

名称 说明
ALWAYS_DARK 0 系统始终为深色。
ALWAYS_LIGHT 1 系统始终为浅色。

uiAppearance.setDarkMode

setDarkMode(mode: DarkMode, callback: AsyncCallback<void>): void

设置系统深色模式。

需要权限: ohos.permission.UPDATE_CONFIGURATION

系统能力: SystemCapability.ArkUI.UiAppearance

参数:

参数名 类型 必填 说明
mode DarkMode 指定系统的深色模式配置
callback AsyncCallback<void> 配置深色模式的异步回调

示例:

uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (err) => {
console.info(`${err}`);
})
1
2
3

uiAppearance.setDarkMode

setDarkMode(mode: DarkMode): Promise<void>;

设置系统深色模式。

需要权限: ohos.permission.UPDATE_CONFIGURATION

系统能力: SystemCapability.ArkUI.UiAppearance

参数:

参数名 类型 必填 说明
mode DarkMode 指定系统深色模式配置

返回值:

类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

示例:

uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK).then(() => {
  console.log('Set dark-mode successfully.');
}).catch((err) => {
  console.log(`Set dark-mode failed, ${err}`);
});
1
2
3
4
5

uiAppearance.getDarkMode

getDarkMode(): DarkMode;

获取当前的深色模式配置。

需要权限: ohos.permission.UPDATE_CONFIGURATION

系统能力: SystemCapability.ArkUI.UiAppearance

返回值:

类型 说明
DarkMode 系统当前的深色模式配置

示例:

let darkMode = uiAppearance.getDarkMode();
console.log(`Get dark-mode ${darkMode}`);
1
2