From ac32bc8f97695ba3e116df5cc986782c7db366fc Mon Sep 17 00:00:00 2001
From: liukaii <liukai240@huawei.com>
Date: Wed, 15 Mar 2023 16:19:24 +0800
Subject: [PATCH] add uiappearance doc.

Signed-off-by: liukaii <liukai240@huawei.com>
---
 .../reference/apis/Readme-CN.md               |   1 +
 .../reference/apis/js-apis-uiappearance.md    | 106 ++++++++++++++++++
 2 files changed, 107 insertions(+)
 create mode 100644 zh-cn/application-dev/reference/apis/js-apis-uiappearance.md

diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md
index b6da677fcd..26a14b69ab 100755
--- a/zh-cn/application-dev/reference/apis/Readme-CN.md
+++ b/zh-cn/application-dev/reference/apis/Readme-CN.md
@@ -98,6 +98,7 @@
   - [@ohos.mediaquery (媒体查询)](js-apis-mediaquery.md)
   - [@ohos.prompt (弹窗)](js-apis-prompt.md)
   - [@ohos.router (页面路由)](js-apis-router.md)
+  - [@ohos.uiAppearance(用户界面外观)](js-apis-uiappearance.md)
 - 图形图像
 
   - [@ohos.animation.windowAnimationManager (窗口动画管理)](js-apis-windowAnimationManager.md)
diff --git a/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md b/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md
new file mode 100644
index 0000000000..28402007b0
--- /dev/null
+++ b/zh-cn/application-dev/reference/apis/js-apis-uiappearance.md
@@ -0,0 +1,106 @@
+# 用户界面外观
+
+用户界面外观提供管理系统外观的一些基础能力，目前仅包括深浅色模式配置。
+
+> **说明：**
+>
+> 从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>
+> 本模块接口为系统接口。
+
+
+## 导入模块
+
+```ts
+import uiAppearance from '@ohos.uiAppearance'
+```
+
+
+## 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](#darkmode) | 是 | 指定系统的深色模式配置 |
+| callback | AsyncCallback\<void>| 是 | 配置深色模式的异步回调 |
+
+**示例：** 
+  ```ts
+uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (err) => {
+  console.info(`${err}`);
+})
+  ```
+
+
+## uiAppearance.setDarkMode
+
+setDarkMode(mode: DarkMode): Promise\<void>;
+
+设置系统深色模式。
+
+**需要权限：** ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力：** SystemCapability.ArkUI.UiAppearance
+
+**参数：** 
+| 参数名 | 类型 | 必填 | 说明 |
+| -- | -- | -- | -- |
+| mode | [DarkMode](#darkmode) | 是 | 指定系统深色模式配置 |
+
+**返回值：**
+
+| 类型   | 说明                           |
+| ------ | ------------------------------ |
+| Promise\<void> | Promise对象。无返回结果的Promise对象。|
+
+**示例：** 
+  ```ts
+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](#darkmode) | 系统当前的深色模式配置 |
+
+**示例：** 
+  ```ts
+let darkMode = uiAppearance.getDarkMode();
+console.log(`Get dark-mode ${darkMode}`);
+  ```
\ No newline at end of file
-- 
GitLab