HarmonyOS应用开发：用户界面外观uiAppearance
用户界面外观
用户界面外观提供管理系统外观的一些基础能力，目前仅包括深浅色模式配置。
导入模块
import uiAppearance from '@ohos.uiAppearance'DarkMode
深色模式枚举。
系统能力： SystemCapability.ArkUI.UiAppearance
| 名称 | 值 | 说明 |
|---|---|---|
| ALWAYS_DARK | 0 | 系统始终为深色。 |
| ALWAYS_LIGHT | 1 | 系统始终为浅色。 |
uiAppearance.setDarkMode
setDarkMode(mode: DarkMode, callback: AsyncCallback): void
设置系统深色模式。
需要权限： ohos.permission.UPDATE_CONFIGURATION
系统能力： SystemCapability.ArkUI.UiAppearance
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mode | DarkMode | 是 | 指定系统的深色模式配置 |
| callback | AsyncCallback | 是 | 配置深色模式的异步回调 |
示例：
uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (err) => {console.info(`${err}`);})uiAppearance.setDarkMode
setDarkMode(mode: DarkMode): Promise
设置系统深色模式。
需要权限： ohos.permission.UPDATE_CONFIGURATION
系统能力： SystemCapability.ArkUI.UiAppearance
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mode | DarkMode | 是 | 指定系统深色模式配置 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise | Promise对象。无返回结果的Promise对象。 |
示例：
uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK).then(() => { console.log('Set dark-mode successfully.');}).catch((err) => { console.log(`Set dark-mode failed, ${err}`);});uiAppearance.getDarkMode
getDarkMode(): DarkMode;
获取当前的深色模式配置。
需要权限： ohos.permission.UPDATE_CONFIGURATION
系统能力： SystemCapability.ArkUI.UiAppearance
返回值：
| 类型 | 说明 |
|---|---|
| DarkMode | 系统当前的深色模式配置 |
示例：
let darkMode = uiAppearance.getDarkMode();console.log(`Get dark-mode ${darkMode}`);
