未验证 提交 d45bba2b 编写于 作者: O openharmony_ci 提交者: Gitee

!23110 StaticCard

Merge pull request !23110 from dujingcheng/staticDoc
......@@ -54,7 +54,7 @@
| formVisibleNotify | 标识是否允许卡片使用卡片可见性通知。 | 字符串 | 可缺省,缺省值为空。 |
| metadata | 表示卡片的自定义信息,包含customizeData数组标签。 | 对象 | 可缺省,缺省值为空。 |
| dataProxyEnabled | 表示卡片是否支持[卡片代理刷新](./arkts-ui-widget-update-by-proxy.md),取值范围:<br/>-&nbsp;true:表示支持代理刷新。<br/>-&nbsp;false:表示不支持代理刷新。<br/>设置为true时,[定时刷新和下次刷新不生效,但不影响定点刷新](./arkts-ui-widget-update-by-time.md) | 布尔类型 | 可缺省,缺省值为false。 |
| isDynamic | 表示此卡片是否为动态卡片(仅针对ArkTS卡片生效)。<br/>-&nbsp;true:为动态卡片。<br/>-&nbsp;false:为静态卡片,当卡片添加成功后,将以静态图显示。 | 布尔类型 | 可缺省,缺省值为true。 |
| isDynamic | 表示此卡片是否为动态卡片(仅针对ArkTS卡片生效)。 <br/>-&nbsp;true:为动态卡片 。<br/>-&nbsp;false:为静态卡片。<br/>&gt;&nbsp;**说明:**<br/>&nbsp;为了降低卡片不必要的内存资源开销,将卡片分为动态卡片和静态卡片。<br/>-&nbsp; 动态卡片:支持onClick等事件机制,卡片内容可以根据用户的点击、滑动等动作有不同的反应和感知。<br/>-&nbsp; 静态卡片:不支持onClick等事件机制,卡片内容以静态图显示,仅可以通过[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)组件跳转到指定UIAbility。| 布尔类型 | 可缺省,缺省值为true。 |
**表2** window对象的内部结构说明
......
......@@ -4,6 +4,7 @@
许多应用希望借助卡片的能力,实现和应用在前台时相同的功能。例如音乐卡片,卡片上提供播放、暂停等按钮,点击不同按钮将触发音乐应用的不同功能,进而提高用户的体验。在卡片中使用**postCardAction**接口的call能力,能够将卡片提供方应用的指定的UIAbility拉到后台。同时,call能力提供了调用应用指定方法、传递数据的功能,使应用在后台运行时可以通过卡片上的按钮执行不同的功能。
说明:<br/> 本文主要介绍动态卡片的事件开发。对于静态卡片,请参见[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)<br/>
通常使用按钮控件来触发call事件,示例代码如下:
......
# 通过message事件刷新卡片内容
说明:<br/> 本文主要介绍动态卡片的事件开发。对于静态卡片,请参见[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)<br/>
在卡片页面中可以通过**postCardAction**接口触发message事件拉起FormExtensionAbility,然后由FormExtensionAbility刷新卡片内容,下面是这种刷新方式的简单示例。
......
# 卡片事件能力说明
ArkTS卡片中提供了postCardAction()接口用于卡片内部和提供方应用间的交互,当前支持router、message和call三种类型的事件,仅在卡片中可以调用。
![WidgetPostCardAction](figures/WidgetPostCardAction.png)
针对动态卡片,ArkTS卡片中提供了postCardAction()接口用于卡片内部和提供方应用间的交互,当前支持router、message和call三种类型的事件,仅在卡片中可以调用。
<br/>针对静态卡片,ArkTS卡片提供了[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)用于卡片内部和提供方应用间的交互。
接口定义:postCardAction(component: Object, action: Object): void
## 动态卡片事件能力说明
![WidgetPostCardAction](figures/WidgetPostCardAction.png)
<br/>接口定义:postCardAction(component: Object, action: Object): void
接口参数说明:
......@@ -63,5 +64,5 @@ Button('拉至后台')
})
```
以下介绍通过卡片事件实现的典型开发场景。
## 静态卡片事件能力说明
请参见[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)
......@@ -5,7 +5,8 @@
![WidgerCameraCard](figures/WidgerCameraCard.png)
通常使用按钮控件来实现页面拉起,示例代码如下:
说明:<br/> 本文主要介绍动态卡片的事件开发。对于静态卡片,请参见[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)<br/>
通常使用按钮控件来实现页面拉起,示例代码如下:
- 在卡片页面中布局两个按钮,点击其中一个按钮时调用postCardAction向指定UIAbility发送router事件,并在事件内定义需要传递的内容。
......
......@@ -5,6 +5,7 @@
## 通过router事件刷新卡片内容
说明:<br/> 本文主要介绍动态卡片的事件开发。对于静态卡片,请参见[FormLink](../../application-dev/reference/arkui-ts/ts-container-formlink.md)<br/>
- 在卡片页面通过注册Button的onClick点击事件回调,并在回调中调用**postCardAction**接口触发router事件拉起UIAbility。
```ts
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册