openharmony 鸿蒙 capi-native-node-h-nodeattributetype-navigationrelatedcomponents

2026-08-25 浏览 (1)

ArkUI_NodeAttributeType(导航类组件相关属性)

enum ArkUI_NodeAttributeType

概述

定义ArkUI在Native侧可以设置的导航类组件相关属性样式集合,包含Swiper组件属性设置。

起始版本: 12

相关模块: ArkUI_NativeModule

所在头文件: native_node.h

NODE_SWIPER_LOOP

NODE_SWIPER_LOOP = MAX_NODE_SCOPE_NUM * ARKUI_NODE_SWIPER = 1001000

Swiper是否开启循环,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32控制是否开启循环,0表示不循环,1表示循环,默认值为1。

返回:

类型说明
.value[0].i32控制是否开启循环,0表示不循环,1表示循环,默认值为1。

NODE_SWIPER_AUTO_PLAY

NODE_SWIPER_AUTO_PLAY = 1001001

Swiper子组件是否自动播放,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32控制子组件是否自动播放,0表示不自动播放,1表示自动播放,默认值为0。
.value[1]?.i32手指按下是否停止自动播放,0表示停止,1表示不停止,默认值为0。该参数从API version 16开始支持。

返回:

类型说明
.value[0].i32控制子组件是否自动播放,0表示不自动播放,1表示自动播放,默认值为0。
.value[1].i32手指按下是否停止自动播放,0表示停止,1表示不停止。该参数从API version 16开始支持。

NODE_SWIPER_SHOW_INDICATOR

NODE_SWIPER_SHOW_INDICATOR = 1001002

Swiper是否显示导航点指示器,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否显示导航点指示器,0表示不显示导航点指示器,1表示显示导航点指示器,默认值为1。

返回:

类型说明
.value[0].i32是否显示导航点指示器,0表示不显示导航点指示器,1表示显示导航点指示器,默认值为1。

NODE_SWIPER_INTERVAL

NODE_SWIPER_INTERVAL = 1001003

设置Swiper自动播放时播放的时间间隔,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32使用自动播放时播放的时间间隔,单位为毫秒。

返回:

类型说明
.value[0].f32使用自动播放时播放的时间间隔,单位为毫秒。

NODE_SWIPER_VERTICAL

NODE_SWIPER_VERTICAL = 1001004

设置Swiper是否为纵向滑动,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否为纵向滑动,0表示横向滑动,1表示纵向滑动,默认值为0。

返回:

类型说明
.value[0].i32是否为纵向滑动,0表示横向滑动,1表示纵向滑动,默认值为0。

NODE_SWIPER_DURATION

NODE_SWIPER_DURATION = 1001005

设置Swiper子组件切换的动画时长,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32子组件切换的动画时长,单位为毫秒, 默认值为400。

返回:

类型说明
.value[0].f32子组件切换的动画时长,单位为毫秒, 默认值为400。

NODE_SWIPER_CURVE

NODE_SWIPER_CURVE = 1001006

设置Swiper的动画曲线,支持属性设置,属性重置和属性获取接口。未设置或未重置该属性时,动画曲线为interpolatingSpring(-1, 1, 328, 34);设置该属性异常时,取默认值ARKUI_CURVE_LINEAR。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置动画曲线参数,参数类型ArkUI_AnimationCurve,默认值为ARKUI_CURVE_LINEAR。

返回:

类型说明
.value[0].i32设置动画曲线参数,参数类型ArkUI_AnimationCurve,默认值为ARKUI_CURVE_LINEAR。

NODE_SWIPER_ITEM_SPACE

NODE_SWIPER_ITEM_SPACE = 1001007

设置Swiper子组件与子组件之间间隙,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32子组件与子组件之间间隙数值。

返回:

类型说明
.value[0].f32子组件与子组件之间间隙数值。

NODE_SWIPER_INDEX

NODE_SWIPER_INDEX = 1001008

设置Swiper当前在容器中显示的子组件的索引值,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32子组件的索引值。
.value[1]?.i32跳转动画模式,参数类型ArkUI_SwiperAnimationMode。仅当次调用有效。
该参数从API version 15开始支持。

返回:

类型说明
.value[0].i32子组件的索引值。

NODE_SWIPER_DISPLAY_COUNT

NODE_SWIPER_DISPLAY_COUNT = 1001009

设置Swiper一页内元素显示个数,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32视窗内显示的子元素个数。
.value[1]?.i32是否按组翻页,0:按子元素翻页,1:视窗内显示的子元素按组翻页,默认值:0。
.string?此参数只能设置为“auto”。当设置为“auto”时,value[] 参数将被忽略。
该参数从API version 19开始支持。

返回:

类型说明
.value[0].i32视窗内显示的子元素个数。
.value[1].i32是否按组翻页。该参数从API version 19开始支持。

NODE_SWIPER_DISABLE_SWIPE

NODE_SWIPER_DISABLE_SWIPE = 1001010

设置Swiper禁用组件滑动切换功能,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32是否禁用组件滑动切换功能,0表示不禁用滑动切换功能,1表示禁用滑动切换功能,默认值为0。

返回:

类型说明
.value[0].i32是否禁用组件滑动切换功能,0表示不禁用滑动切换功能,1表示禁用滑动切换功能,默认值为0。

NODE_SWIPER_SHOW_DISPLAY_ARROW

NODE_SWIPER_SHOW_DISPLAY_ARROW = 1001011

设置Swiper是否显示导航点箭头,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置是否显示导航点箭头,参数类型ArkUI_SwiperArrow,默认值为ARKUI_SWIPER_ARROW_HIDE。
.?object显示导航箭头时设置箭头样式,参数类型为ArkUI_SwiperArrowStyle。该参数从API version 19开始支持。

返回:

类型说明
.value[0].i32设置是否显示导航点箭头,参数类型ArkUI_SwiperArrow
.object箭头样式,参数类型为ArkUI_SwiperArrowStyle。该参数从API version 19开始支持。

NODE_SWIPER_EDGE_EFFECT_MODE

NODE_SWIPER_EDGE_EFFECT_MODE = 1001012

设置Swiper的边缘滑动效果,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32边缘滑动效果,参数类型ArkUI_EdgeEffect
默认值为ARKUI_EDGE_EFFECT_SPRING。

返回:

类型说明
.value[0].i32边缘滑动效果,参数类型ArkUI_EdgeEffect

NODE_SWIPER_NODE_ADAPTER

NODE_SWIPER_NODE_ADAPTER = 1001013

swiper组件适配器,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.object使用ArkUI_NodeAdapter对象作为适配器。

返回:

类型说明
.object返回值格式为ArkUI_NodeAdapter

NODE_SWIPER_CACHED_COUNT

NODE_SWIPER_CACHED_COUNT = 1001014

swiper组件Adapter缓存数量,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32配合swiper组件Adapter使用,设置adapter中的缓存数量。
.value[1]?.i32是否显示缓存节点,0:不显示,1:显示,默认值:0。该参数从API version 19开始支持。
.value[2]?.i32缓存数量是否按组计算,即预加载子组件个数以组为基本单位。1:缓存数量为真实设置数量,0:当NODE_SWIPER_DISPLAY_COUNT设置按组翻页时,缓存数量按组计算,不设置时为真实设置数量。默认值:0。该参数从API version 24开始支持。

返回:

类型说明
.value[0].i32adapter中的缓存数量。
.value[1].i32是否显示缓存节点,0:不显示,1:显示。该参数从API version 19开始支持。
.value[2].i32缓存数量是否按组计算。该参数从API version 24开始支持。 \n

NODE_SWIPER_PREV_MARGIN

NODE_SWIPER_PREV_MARGIN = 1001015

设置 Swiper 组件的前边距,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32前边距数值,单位为vp,默认值为0。
.value[1]?.i32是否忽略空白,1表示忽略空白,0表示不忽略空白。

返回:

类型说明
.value[0].f32前边距数值,单位为vp。.value[1].i32:是否忽略空白,1表示忽略空白,0表示不忽略空白。

NODE_SWIPER_NEXT_MARGIN

NODE_SWIPER_NEXT_MARGIN = 1001016

设置 Swiper 组件的后边距,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].f32后边距数值,单位为vp,默认值为0。
.value[1]?.i32是否忽略空白,1表示忽略空白,0表示不忽略空白。

返回:

类型说明
.value[0].f32后边距数值,单位为vp。.value[1].i32:是否忽略空白,1表示忽略空白,0表示不忽略空白。

NODE_SWIPER_INDICATOR

NODE_SWIPER_INDICATOR = 1001017

设置 Swiper 组件的导航指示器类型,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置导航指示器的类型,参数类型ArkUI_SwiperIndicatorType
.object导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DOT时参数类型为ArkUI_SwiperIndicator
导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DIGIT时参数类型为ArkUI_SwiperDigitIndicator
ArkUI_SwiperDigitIndicator类型从API version 19开始支持。

返回:

类型说明
.value[0].i32导航指示器的类型,参数类型ArkUI_SwiperIndicatorType
.object导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DOT时参数类型为ArkUI_SwiperIndicator
导航指示器的类型为ARKUI_SWIPER_INDICATOR_TYPE_DIGIT时参数类型为ArkUI_SwiperDigitIndicator
ArkUI_SwiperDigitIndicator类型从API version 19开始支持。

NODE_SWIPER_NESTED_SCROLL

NODE_SWIPER_NESTED_SCROLL = 1001018

设置Swiper组件和父组件的嵌套滚动模式。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32Swiper组件和父组件的嵌套滚动模式,参数类型ArkUI_SwiperNestedScrollMode
默认值为:ARKUI_SWIPER_NESTED_SRCOLL_SELF_ONLY。

返回:

类型说明
.value[0].i32Swiper组件和父组件的嵌套滚动模式,参数类型ArkUI_SwiperNestedScrollMode

NODE_SWIPER_SWIPE_TO_INDEX

NODE_SWIPER_SWIPE_TO_INDEX = 1001019

设置swiper组件翻至指定页面。
作为属性设置方法参数ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32指定页面在Swiper中的索引值。
.value[1]?.i32设置翻至指定页面时是否有动效。1表示有动效,0表示没有动效, 默认值:0。

NODE_SWIPER_INDICATOR_INTERACTIVE

NODE_SWIPER_INDICATOR_INTERACTIVE = 1001020

设置禁用组件导航点交互功能。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 12

参数:

参数项描述
.value[0].i32设置禁用组件导航点交互功能,设置为true时表示导航点可交互,设置为false时表示导航点不可交互,默认值true。

返回:

类型说明
.value[0].i32设置禁用组件导航点交互功能。

NODE_SWIPER_PAGE_FLIP_MODE

NODE_SWIPER_PAGE_FLIP_MODE = 1001021

设置组件鼠标滚轮翻页模式。
作为属性设置方法参数ArkUI_AttributeItem格式如下。

起始版本: 15

参数:

参数项描述
.value[0].i32设置组件鼠标滚轮翻页模式,参数类型ArkUI_PageFlipMode
属性获取方法返回值ArkUI_PageFlipMode格式:
.value[0].i32鼠标滚轮翻页模式。

NODE_SWIPER_AUTO_FILL

NODE_SWIPER_AUTO_FILL = 1001022

设置Swiper一页内元素显示个数根据元素最小宽度自适应,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 19

参数:

参数项描述
.value[0].f32元素显示最小宽度,单位:vp。
.value[1]?.i32是否按组翻页,0:按子元素翻页,1:视窗内显示的子元素按组翻页,默认值:0。

返回:

类型说明
.value[0].f32元素显示最小宽度,单位:vp。
.value[1].i32是否按组翻页。

NODE_SWIPER_MAINTAIN_VISIBLE_CONTENT_POSITION

NODE_SWIPER_MAINTAIN_VISIBLE_CONTENT_POSITION = 1001023

设置Swiper显示区域外插入或删除数据是否保持可见内容位置不变。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 20

参数:

参数项描述
.value[0].i32Swiper显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置,1表示保持可见内容位置,默认值为0。

返回:

类型说明
.value[0].i32Swiper显示区域外插入或删除数据是否保持可见内容位置不变。0表示不保持可见内容位置,1表示保持可见内容位置,默认值为0。

NODE_SWIPER_ITEMFILLPOLICY

NODE_SWIPER_ITEMFILLPOLICY = 1001024

Swiper组件的响应式列数布局策略,支持属性设置,属性重置和属性获取接口。
作为属性设置方法参数、属性获取方法返回值ArkUI_AttributeItem格式如下。

起始版本: 22

参数:

参数项描述
.value[0].i32在不同断点规格下的列数,数据类型ArkUI_ItemFillPolicy
.value[1]?.i32是否按组翻页,0:按子元素翻页,1:视窗内显示的子元素按组翻页,默认值:0。

返回:

类型说明
.value[0].i32在不同断点规格下的列数,数据类型ArkUI_ItemFillPolicy
.value[1].i32是否按组翻页。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 arkts-apis-uicontext-contextmenucontroller

openharmony 鸿蒙 errorcode-canvas

openharmony 鸿蒙 capi-oh-nativexcomponent-native-xcomponent-oh-nativexcomponent

openharmony 鸿蒙 errorcode-bindSheet

openharmony 鸿蒙 js-apis-arkui-uiExtension-sys

openharmony 鸿蒙 capi-arkui-accessibility-arkui-accessibilityeventinfo

openharmony 鸿蒙 capi-arkui-rendernodeutils

openharmony 鸿蒙 capi-native-node-h-nodeattributetype-layoutcomponent

openharmony 鸿蒙 js-apis-arkui-node

openharmony 鸿蒙 capi-native-node-h

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/ATCoI4nq