提交 d30c01c7 编写于 作者: G ge-yafang

update docs

Signed-off-by: Nge-yafang <geyafang@huawei.com>
上级 730a6f34
...@@ -3,7 +3,6 @@ ...@@ -3,7 +3,6 @@
## 基本概念 ## 基本概念
窗口沉浸式能力:指对状态栏、导航栏等系统窗口进行控制,减少状态栏导航栏等系统界面的突兀感,从而使用户获得最佳体验的能力。 窗口沉浸式能力:指对状态栏、导航栏等系统窗口进行控制,减少状态栏导航栏等系统界面的突兀感,从而使用户获得最佳体验的能力。
沉浸式能力只在应用主窗口作为全屏窗口时生效。通常情况下,应用子窗口(弹窗、悬浮窗口等辅助窗口)和处于自由窗口下的应用主窗口无法使用沉浸式能力。 沉浸式能力只在应用主窗口作为全屏窗口时生效。通常情况下,应用子窗口(弹窗、悬浮窗口等辅助窗口)和处于自由窗口下的应用主窗口无法使用沉浸式能力。
## 场景介绍 ## 场景介绍
...@@ -48,6 +47,7 @@ ...@@ -48,6 +47,7 @@
### 开发步骤 ### 开发步骤
1. 创建/获取子窗口对象。 1. 创建/获取子窗口对象。
- 可以通过`window.create`接口创建子窗口。 - 可以通过`window.create`接口创建子窗口。
- 可以通过`window.getTopWindow`来获取最后显示的窗口得到子窗口。 - 可以通过`window.getTopWindow`来获取最后显示的窗口得到子窗口。
- 也可以通过`window.find`接口来查找已经创建的窗口从而得到子窗口。 - 也可以通过`window.find`接口来查找已经创建的窗口从而得到子窗口。
...@@ -86,6 +86,7 @@ ...@@ -86,6 +86,7 @@
``` ```
2. 设置子窗口属性。 2. 设置子窗口属性。
子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。 子窗口创建成功后,可以改变其大小、位置等,还可以根据应用需要设置窗口背景色、亮度等属性。
...@@ -109,6 +110,7 @@ ...@@ -109,6 +110,7 @@
``` ```
3. 加载显示子窗口的具体内容。 3. 加载显示子窗口的具体内容。
使用`loadContent``show`接口加载显示子窗口的具体内容。 使用`loadContent``show`接口加载显示子窗口的具体内容。
...@@ -132,6 +134,7 @@ ...@@ -132,6 +134,7 @@
``` ```
4. 销毁子窗口。 4. 销毁子窗口。
当不再需要某些子窗口时,可根据场景的具体实现逻辑,使用`destroy`接口销毁子窗口。 当不再需要某些子窗口时,可根据场景的具体实现逻辑,使用`destroy`接口销毁子窗口。
...@@ -158,6 +161,7 @@ ...@@ -158,6 +161,7 @@
### 开发步骤 ### 开发步骤
1. 获取主窗口对象。 1. 获取主窗口对象。
沉浸式能力需要在成功获取应用主窗口对象的前提下进行。使用`window.getTopWindow`接口来获取得到主窗口。 沉浸式能力需要在成功获取应用主窗口对象的前提下进行。使用`window.getTopWindow`接口来获取得到主窗口。
...@@ -177,6 +181,7 @@ ...@@ -177,6 +181,7 @@
``` ```
2. 实现沉浸式效果。有以下三种方式: 2. 实现沉浸式效果。有以下三种方式:
- 方式一:调用`setFullScreen`接口,设置应用主窗口为全屏显示,此时导航栏、状态栏将隐藏,从而达到沉浸式效果。 - 方式一:调用`setFullScreen`接口,设置应用主窗口为全屏显示,此时导航栏、状态栏将隐藏,从而达到沉浸式效果。
- 方式二:调用`setSystemBarEnable`接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。 - 方式二:调用`setSystemBarEnable`接口,设置导航栏、状态栏不显示,从而达到沉浸式效果。
- 方式三:调用`setLayoutFullScreen`接口,设置应用主窗口为全屏布局;然后调用`setSystemPropertites`接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。 - 方式三:调用`setLayoutFullScreen`接口,设置应用主窗口为全屏布局;然后调用`setSystemPropertites`接口,设置导航栏、状态栏的透明度、背景/文字颜色以及高亮图标等属性,使之保持与主窗口显示协调一致,从而达到沉浸式效果。
...@@ -230,6 +235,7 @@ ...@@ -230,6 +235,7 @@
``` ```
3. 加载显示沉浸式窗口的具体内容。 3. 加载显示沉浸式窗口的具体内容。
使用`loadContent``show`接口加载显示沉浸式窗口的具体内容。 使用`loadContent``show`接口加载显示沉浸式窗口的具体内容。
......
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
| 实例名 | 接口名 | 描述 | | 实例名 | 接口名 | 描述 |
| -------- | -------- | -------- | | -------- | -------- | -------- |
| window静态方法 | create(ctx:Context,id:string,type:WindowType,callback:AsyncCallback&lt;Window&gt;):void | 创建窗口。<br/>-`ctx`:为应用上下文信息。当`Context`[ServiceExtensionContext](..reference/apis/js-apis-service-extension-context.md)时,创建系统窗口。<br/>-`type`:为创建的窗口类型。 | | window静态方法 | create(ctx:Context,id:string,type:WindowType,callback:AsyncCallback&lt;Window&gt;):void | 创建窗口。<br/>-`ctx`:为应用上下文信息。当`Context`[ServiceExtensionContext](../reference/apis/js-apis-service-extension-context.md)时,创建系统窗口。<br/>-`type`:为创建的窗口类型。 |
| Window | resetSize(width:number,height:number,callback:AsyncCallback&lt;void&gt;):void | 改变当前窗口大小。 | | Window | resetSize(width:number,height:number,callback:AsyncCallback&lt;void&gt;):void | 改变当前窗口大小。 |
| Window | moveTo(x:number,y:number,callback:AsyncCallback&lt;void&gt;):void | 移动当前窗口位置。 | | Window | moveTo(x:number,y:number,callback:AsyncCallback&lt;void&gt;):void | 移动当前窗口位置。 |
| Window | loadContent(path:string,callback:AsyncCallback&lt;void&gt;):void | 为当前窗口加载具体页面。 | | Window | loadContent(path:string,callback:AsyncCallback&lt;void&gt;):void | 为当前窗口加载具体页面。 |
...@@ -28,9 +28,11 @@ ...@@ -28,9 +28,11 @@
1. 创建系统窗口。 1. 创建系统窗口。
[ServiceExtensionContext](..reference/apis/js-apis-service-extension-context.md)下,使用`window.create`接口创建音量条系统窗口。
[ServiceExtensionContext](../reference/apis/js-apis-service-extension-context.md)下,使用`window.create`接口创建音量条系统窗口。
2. 操作或设置系统窗口的属性。 2. 操作或设置系统窗口的属性。
系统窗口创建成功后,可以改变其大小、位置等,还可以根据需要设置系统窗口的背景色、亮度等属性。 系统窗口创建成功后,可以改变其大小、位置等,还可以根据需要设置系统窗口的背景色、亮度等属性。
3. 加载显示系统窗口的具体内容。 3. 加载显示系统窗口的具体内容。
...@@ -38,6 +40,7 @@ ...@@ -38,6 +40,7 @@
通过`loadContent``show`接口加载显示音量条窗口的具体内容。 通过`loadContent``show`接口加载显示音量条窗口的具体内容。
4. 隐藏/销毁系统窗口。 4. 隐藏/销毁系统窗口。
当不再需要音量条窗口时,可根据具体实现逻辑,使用`hide`接口或`destroy`接口对其进行隐藏或销毁。 当不再需要音量条窗口时,可根据具体实现逻辑,使用`hide`接口或`destroy`接口对其进行隐藏或销毁。
```ts ```ts
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册