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