鸿蒙OpenHarmony【StepperItem】ArkTS导航与切换

子组件

支持单个子组件。

接口

StepperItem()

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

属性

prevLabel

prevLabel(value: string)

设置左侧文本按钮内容，第一页没有左侧文本按钮，当步骤导航器大于一页时，除第一页外默认值都为“返回”。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	string	是	左侧文本按钮内容。

nextLabel

nextLabel(value: string)

设置右侧文本按钮内容，最后一页默认值为“开始”，其余页默认值为“下一步”。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	string	是	右侧文本按钮内容。

status

status(value?: ItemState)

设置步骤导航器nextLabel的显示状态。

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	[ItemState]	否	步骤导航器nextLabel的显示状态。默认值：ItemState.Normal

说明

• StepperItem组件不支持设置通用宽度属性，其宽度默认撑满Stepper父组件。
• StepperItem组件不支持设置通用高度属性，其高度由Stepper父组件高度减去label按钮组件高度。
• StepperItem组件不支持设置aspectRadio/constrainSize影响长宽的属性。

ItemState枚举说明

元服务API：  从API version 11开始，该接口支持在元服务中使用。

系统能力：  SystemCapability.ArkUI.ArkUI.Full

名称	描述
Normal	正常状态，右侧文本按钮正常显示，可点击进入下一个StepperItem。
Disabled	不可用状态，右侧文本按钮灰度显示，不可点击进入下一个StepperItem。
Waiting	等待状态，右侧文本按钮不显示，显示等待进度条，不可点击进入下一个StepperItem。
Skip	跳过状态，右侧文本按钮默认显示“跳过”，此时可在Stepper的onSkip回调中自定义相关逻辑。