diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-page-overview.md b/zh-cn/application-dev/application-models/arkts-ui-widget-page-overview.md index 4b06082466bb94fbfaa731f5d4ebf5f0185d3034..9bf2604618175cedc60ed52e589e27b00fbdec8b 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-page-overview.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-page-overview.md @@ -12,150 +12,11 @@ ArkTS卡片具备JS卡片的全量能力，并且新增了动效能力和自定 ## ArkTS卡片支持的页面能力 -ArkTS卡片支持的页面能力如下，详细介绍请参见[ArkTS声明式开发范式API参考](../reference/arkui-ts/Readme-CN.md)。 +ArkTS卡片支持的页面能力详见[学习ArkTS语言](../quick-start/arkts-create-custom-components.md)和[ArkTS声明式开发范式](../reference/arkui-ts/ts-components-summary.md)。 -在这些能力中，只有标识“支持在ArkTS卡片中使用”的具体能力可用于ArkTS卡片，同时请留意卡片场景下的能力差异说明。 +只有标识“支持在ArkTS卡片中使用”的接口可用于ArkTS卡片，同时请留意卡片场景下的能力差异说明。 -- 属性动画 +例如：以下说明表示@Component装饰器可在ArkTS卡片中使用。 -- 显式动画 +![WidgetSupportApi](figures/WidgetSupportApi.png) -- 组件内转场 - -- 像素单位 - -- Blank组件 - -- Button组件 - -- Checkbox组件 - -- CheckboxGroup组件 - -- DataPanel组件 - -- Divider组件 - -- Gauge组件 - -- Image组件 - -- LoadingProgress组件 - -- Marquee组件 - -- Progress组件 - -- Qrcode组件 - -- Radio组件 - -- Rating组件 - -- Slider组件 - -- Span组件 - -- Text组件 - -- Toggle组件 - -- Canvas绘制上下文对象 - -- Canvas组件 - -- 渐变对象 - -- ImageBitmap对象 - -- ImageData对象 - -- Path2D对象 - -- ForEach组件 - -- Badge容器组件 - -- Column容器组件 - -- Counter容器组件 - -- Flex容器组件 - -- GridCol容器组件 - -- GridRow容器组件 - -- List容器组件 - -- ListItem容器组件 - -- RelativeContainer容器组件 - -- Row容器组件 - -- Stack容器组件 - -- Circle绘制组件 - -- Ellipse绘制组件 - -- Line绘制组件 - -- Path绘制组件 - -- Polygon绘制组件 - -- Polyline绘制组件 - -- Rect绘制组件 - -- Shape绘制组件 - -- Background通用属性 - -- BackgroundBlurStyle通用属性 - -- BorderImage通用属性 - -- Border通用属性 - -- ComponentId通用属性 - -- Enable通用属性 - -- FlexLayout通用属性 - -- GradientColor通用属性 - -- ImageEffect通用属性 - -- LayoutConstraints通用属性 - -- Location通用属性 - -- Opacity通用属性 - -- Overlay通用属性 - -- PolymorphicStyle通用属性 - -- SharpClipping通用属性 - -- Size通用属性 - -- Touch-target通用属性 - -- Transformation通用属性 - -- Visibility通用属性 - -- ZOrder通用属性 - -- 点击事件 - -- 挂载卸载事件 - -- 组件生命周期 - -- 状态管理 diff --git a/zh-cn/application-dev/application-models/figures/WidgetSupportApi.png b/zh-cn/application-dev/application-models/figures/WidgetSupportApi.png new file mode 100644 index 0000000000000000000000000000000000000000..3d982414376d34a5b12b6f78d6bf97fa8c139a95 Binary files /dev/null and b/zh-cn/application-dev/application-models/figures/WidgetSupportApi.png differ diff --git a/zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md b/zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md index d9caebec07283074b7a647b53c5cd4b3bc866efe..a5c2509c19fc680b838bbe5ba221e8597cbd9fc2 100644 --- a/zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md +++ b/zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md @@ -3,6 +3,9 @@ ForEach基于数组类型数据执行循环渲染。 +> **说明：** +> +> 从API version 9开始，该接口支持在ArkTS卡片中使用。 ## 接口描述 diff --git a/zh-cn/application-dev/quick-start/arkts-rendering-control-ifelse.md b/zh-cn/application-dev/quick-start/arkts-rendering-control-ifelse.md index 67a2da23ceed5ffec09fc7038bc4f0eb13537c90..80565882488ebc61723a5db3ff88338d29f0e1f6 100644 --- a/zh-cn/application-dev/quick-start/arkts-rendering-control-ifelse.md +++ b/zh-cn/application-dev/quick-start/arkts-rendering-control-ifelse.md @@ -3,6 +3,9 @@ ArkTS提供了渲染控制的能力。条件渲染可根据应用的不同状态，使用if、else和else if渲染对应状态下的UI内容。 +> **说明：** +> +> 从API version 9开始，该接口支持在ArkTS卡片中使用。 ## 使用规则 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md b/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md index 3f1da9b0dcd14ea60b7d1a91ea9171d0cde0e647..44971cf244a982f7e7d8cd88ddeb2d4505c2b181 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md @@ -15,6 +15,7 @@ aboutToAppear?(): void aboutToAppear函数在创建自定义组件的新实例后，在执行其build()函数之前执行。允许在aboutToAppear函数中改变状态变量，更改将在后续执行build()函数中生效。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 ## aboutToDisappear @@ -22,6 +23,7 @@ aboutToDisappear?(): void aboutToDisappear函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量，特别是\@Link变量的修改可能会导致应用程序行为不稳定。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 ## onPageShow diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md b/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md index 59f96f604254073822dc4bdc98be4694f1b40418..b2ae6d899c62fc7d28c04d633f6f85905059f63c 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-state-management.md @@ -376,6 +376,8 @@ constructor(initializingProperties?: Object) 创建一个新的LocalStorage实例。使用Object.keys(initializingProperties)返回的属性和其数值，初始化LocalStorage实例。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -394,6 +396,8 @@ static GetShared(): LocalStorage 获取当前stage共享的LocalStorage实例。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **模型约束：**此接口仅可在Stage模型下使用。 **返回值：** @@ -414,6 +418,8 @@ has(propName: string): boolean 判断propName对应的属性是否在LocalStorage中存在。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -439,6 +445,8 @@ get<T>(propName: string): T | undefined 获取propName在LocalStorage中对应的属性。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -464,6 +472,8 @@ set<T>(propName: string, newValue: T): boolean 在LocalStorage中设置propName对应属性的值。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -491,6 +501,8 @@ setOrCreate<T>(propName: string, newValue: T): boolean propName如果已经在LocalStorage中存在，则设置propName对应是属性的值为newValue。如果不存在，则创建propName属性，初始化为newValue。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -523,6 +535,8 @@ link<T>(propName: string): SubscribedAbstractProperty<T> 如果LocalStorage中不存在propName，则返回undefined。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -550,6 +564,8 @@ setAndLink<T>(propName: string, defaultValue: T): SubscribedAbstractProper 与Link接口类似，如果给定的propName在LocalStorage存在，则返回该propName对应的属性的双向绑定数据。如果不存在，则使用defaultValue在LocalStorage创建和初始化propName，返回其双向绑定数据。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -577,6 +593,8 @@ prop<S>(propName: string): SubscribedAbstractProperty<S> 如果给定的propName在LocalStorage存在，则返回与LocalStorage中propName对应属性的单向绑定数据。如果LocalStorage中不存在propName，则返回undefined。单向绑定数据的修改不会被同步回LocalStorage中。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -604,6 +622,8 @@ setAndProp<S>(propName: string, defaultValue: S): SubscribedAbstractProper propName在LocalStorage存在，则返回该propName对应的属性的单向绑定数据。如果不存在，则使用defaultValue在LocalStorage创建和初始化propName对应的属性，返回其单向绑定数据。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -632,6 +652,8 @@ delete(propName: string): boolean 属性的订阅者是link，prop接口绑定的propName，以及\@LocalStorageLink('propName')和\@LocalStorageProp('propName')。如果自定义组件Component中使用或者SubscribedAbstractProperty（link和prop接口的返回类型）依旧有同步关系，则该属性不能从LocalStorage中删除。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **参数：** | 参数名 | 类型 | 必填 | 参数描述 | @@ -661,6 +683,8 @@ keys(): IterableIterator<string> 返回AppStorage中所有的属性名。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **返回值：** | 类型 | 描述 | @@ -680,6 +704,8 @@ size(): number 返回LocalStorage中的属性数量。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 + **返回值：** | 类型 | 描述 | @@ -700,6 +726,7 @@ clear(): boolean 清除LocalStorage的所有的属性。在LocalStorage中清除所有属性的前提是已经没有任何订阅者。如果有则返回false；清除成功返回true。 +从API version 9开始，该接口支持在ArkTS卡片中使用。 **返回值：**