1# StepperItem
2
3用作[Stepper](ts-basic-components-stepper.md)组件的页面子组件。
4
5
6>  **说明:**
7>
8>  该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
9
10
11## 子组件
12
13支持单个子组件。
14
15
16## 接口
17
18StepperItem()
19
20**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
21
22**系统能力:** SystemCapability.ArkUI.ArkUI.Full
23
24## 属性
25
26### prevLabel
27
28prevLabel(value: string)
29
30设置左侧文本按钮内容,第一页没有左侧文本按钮,当步骤导航器大于一页时,除第一页外默认值都为“返回”。
31
32**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
33
34**系统能力:** SystemCapability.ArkUI.ArkUI.Full
35
36**参数:**
37
38| 参数名 | 类型 | 必填 | 说明 |
39| -------- | -------- | -------- | -------- |
40| value | string | 是 | 左侧文本按钮内容。 |
41
42### nextLabel
43
44nextLabel(value: string)
45
46设置右侧文本按钮内容,最后一页默认值为“开始”,其余页默认值为“下一步”。
47
48**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
49
50**系统能力:** SystemCapability.ArkUI.ArkUI.Full
51
52**参数:**
53
54| 参数名 | 类型                            | 必填 | 说明                                                         |
55| ------ | ------------------------------- | ---- | ------------------------------------------------------------ |
56| value  | string                          | 是   | 右侧文本按钮内容。                                           |
57
58### status
59
60status(value?: ItemState)
61
62设置步骤导航器nextLabel的显示状态。
63
64**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
65
66**系统能力:** SystemCapability.ArkUI.ArkUI.Full
67
68**参数:**
69
70| 参数名 | 类型                            | 必填 | 说明                                                         |
71| ------ | ------------------------------- | ---- | ------------------------------------------------------------ |
72| value  | [ItemState](#itemstate枚举说明) | 否   | 步骤导航器nextLabel的显示状态。<br/>默认值:ItemState.Normal |
73
74>  **说明:**
75>
76>  - StepperItem组件不支持设置通用宽度属性,其宽度默认撑满Stepper父组件。
77>  - StepperItem组件不支持设置通用高度属性,其高度由Stepper父组件高度减去label按钮组件高度。
78>  - StepperItem组件不支持设置aspectRadio/constrainSize影响长宽的属性。
79## ItemState枚举说明
80
81**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
82
83**系统能力:** SystemCapability.ArkUI.ArkUI.Full
84
85|   名称    | 说明 |
86| -------- |-------- |
87| Normal |正常状态,右侧文本按钮正常显示,可点击进入下一个StepperItem。 |
88| Disabled |不可用状态,右侧文本按钮灰度显示,不可点击进入下一个StepperItem。 |
89| Waiting | 等待状态,右侧文本按钮不显示,显示等待进度条,不可点击进入下一个StepperItem。 |
90| Skip |跳过状态,右侧文本按钮默认显示“跳过”,此时可在Stepper的onSkip回调中自定义相关逻辑。 |
91
92
93## 示例
94
95见[Stepper](ts-basic-components-stepper.md)。
96
97