diff --git a/zh-cn/native_sdk/ace/native_node.h b/zh-cn/native_sdk/ace/native_node.h index ab352ab7e83e5ac2c12f885d39b6445848fbefd2..e952d181c7309a5a3eecbd5304ab948ee8a66435 100644 --- a/zh-cn/native_sdk/ace/native_node.h +++ b/zh-cn/native_sdk/ace/native_node.h @@ -3034,6 +3034,39 @@ typedef enum { */ NODE_SCROLL_ENABLE_PAGING, + /** + * @brief 滑动到指定index。 + * + * 开启smooth动效时,会对经过的所有item进行加载和布局计算,当大量加载item时会导致性能问题。\n + * \n + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:要滑动到的目标元素在当前容器中的索引值。\n + * .value[1]?.i32:设置滑动到列表项在列表中的索引值时是否有动效,1表示有动效,0表示没有动效。默认值:0。\n + * .value[2]?.i32:指定滑动到的元素与当前容器的对齐方式,参数类型{@link ArkUI_ScrollAlign}。 + * List中的默认值为:ScrollAlign.START。Grid中默认值为:ScrollAlign.AUTO。WaterFlow中的默认值为:ScrollAlign.START。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32:要滑动到的目标元素在当前容器中的索引值。\n + * .value[1].i32:设置滑动到列表项在列表中的索引值时是否有动效,1表示有动效,0表示没有动效。\n + * .value[2].i32:指定滑动到的元素与当前容器的对齐方式,参数类型{@link ArkUI_ScrollAlign}。 + * + */ + NODE_SCROLL_SCROLL_TO_INDEX, + + /** + * @brief 滚动到下一页或者上一页。 + * + * 属性设置方法参数{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32 是否向下翻页。1表示向下翻页,0表示向上翻页。\n + * .value[1]?.i32 是否开启翻页动画效果。1有动画,0无动画。默认值:0。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式:\n + * .value[0].i32 是否向下翻页。1表示向下翻页,0表示向上翻页。\n + * .value[1].i32 是否开启翻页动画效果。1有动画,0无动画。\n + * + */ + NODE_SCROLL_SCROLL_PAGE, + /** * @brief 设置List组件排列方向,支持属性设置,属性重置和属性获取接口。 * diff --git a/zh-cn/native_sdk/ace/native_type.h b/zh-cn/native_sdk/ace/native_type.h index d7e008c8c6336ddce82e2d298ea22e82015f6e57..f4cd060a84b4545d63a2e9a46b35a0860a495b9a 100644 --- a/zh-cn/native_sdk/ace/native_type.h +++ b/zh-cn/native_sdk/ace/native_type.h @@ -718,6 +718,22 @@ typedef enum { ARKUI_SCROLL_EDGE_END, } ArkUI_ScrollEdge; +/** + * @brief item对齐方式。 + * + * @since 12 + */ +typedef enum { + /** 首部对齐。指定item首部与List首部对齐。*/ + ARKUI_SCROLL_ALIGN_START = 0, + /** 居中对齐。指定item主轴方向居中对齐于List。*/ + ARKUI_SCROLL_ALIGN_CENTER, + /** 尾部对齐。指定item尾部与List尾部对齐。*/ + ARKUI_SCROLL_ALIGN_END, + /** 自动对齐。若指定item完全处于显示区,不做调整。否则依照滑动距离最短的原则,将指定item首部对齐或尾部对齐于List,使指定item完全处于显示区。*/ + ARKUI_SCROLL_ALIGN_AUTO, +} ArkUI_ScrollAlign; + /** * @brief 定义滑块形状。 *