From e19b2c5ae6b88bdd13ce66b4346a8dfa6070a409 Mon Sep 17 00:00:00 2001
From: wusongqing <wusongqing@huawei.com>
Date: Tue, 26 Jul 2022 15:47:10 +0800
Subject: [PATCH] add js-apis-uiappearance (en)

Signed-off-by: wusongqing <wusongqing@huawei.com>
---
 .../reference/apis/js-apis-uiappearance.md    | 99 +++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 en/application-dev/reference/apis/js-apis-uiappearance.md

diff --git a/en/application-dev/reference/apis/js-apis-uiappearance.md b/en/application-dev/reference/apis/js-apis-uiappearance.md
new file mode 100644
index 0000000000..981e16381d
--- /dev/null
+++ b/en/application-dev/reference/apis/js-apis-uiappearance.md
@@ -0,0 +1,99 @@
+# UI Appearance
+
+The **uiAppearance** module provides basic capabilities for managing the system appearance. It allows for color mode configuration currently, and will introduce more features over time.
+
+> **NOTE**
+>
+> The APIs of this module are supported since API version 9. Updates will be marked with a superscript to indicate their earliest API version.
+> The APIs provided by this module are system APIs.
+
+
+## Modules to Import
+
+```ts
+import uiAppearance from '@ohos.uiAppearance'
+```
+
+
+## DarkMode
+
+Enumerates the color modes.
+
+
+| Name| Value| Description|
+| -- | -- | -- |
+| ALWAYS_DARK | 0 | The system is always in dark mode. |
+| ALWAYS_LIGHT | 1 | The system is always in light mode.|
+
+
+## uiAppearance.setDarkMode
+
+setDarkMode(mode: DarkMode, callback: AsyncCallback\<void>): void
+
+Sets the system color mode. This API uses an asynchronous callback to return the result.
+
+**Required permissions**: ohos.permission.UPDATE_CONFIGRATION
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+
+| Name| Type| Mandatory| Description|
+| -- | -- | -- | -- |
+| mode | [DarkMode](#darkmode) | Yes| Color mode to set.|
+| callback | AsyncCallback\<void>| Yes| Callback used to return the result.|
+
+**Example**
+  ```ts
+uiAppearance.setDarkMode(uiAppearance.DarkMode.ALWAYS_DARK, (err) => {
+  console.info(`${err}`);
+})
+  ```
+
+
+## uiAppearance.setDarkMode
+
+setDarkMode(mode: DarkMode): Promise\<void>;
+
+Sets the system color mode. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.UPDATE_CONFIGRATION
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Parameters**
+| Name| Type| Mandatory| Description|
+| -- | -- | -- | -- |
+| mode | [DarkMode](#darkmode) | Yes| Color mode to set.|
+
+**Example**
+  ```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;
+
+Obtains the system color mode.
+
+**Required permissions**: ohos.permission.UPDATE_CONFIGRATION
+
+**System capability**: SystemCapability.ArkUI.ArkUI.Full
+
+**Return value**
+
+| Type| Description|
+| -- | -- |
+|[DarkMode](#darkmode) | Color mode obtained.|
+
+**Example**
+  ```ts
+let darkMode = uiAppearance.getDarkMode();
+console.log(`Get dark-mode ${darkMode}`);
+  ```
-- 
GitLab