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