• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# stepper-item
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @mayaolll-->
5<!--Designer: @jiangdayuan-->
6<!--Tester: @lxl007-->
7<!--Adviser: @HelloCrease-->
8
9>  **说明:**
10> 从API version 5开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
11
12步骤导航器子组件,作为步骤导航器某一个步骤的内容展示组件。
13
14
15## 权限列表
16
1718
19
20## 子组件
21
22支持。
23
24
25## 属性
26
27除支持[通用属性](js-components-common-attributes.md)外,还支持如下属性:
28
29| 名称 | 类型 | 必填 | 描述 |
30| -------- | -------- | -------- | -------- |
31| label | Label | &nbsp;&nbsp;否&nbsp;&nbsp; | 自定义步骤导航器底部步骤提示文本按钮属性,不支持动态修改。如果没有定义该属性,步骤导航器在中文语言环境下,使用"返回"和"下一步"文本按钮,在非中文语言环境下,使用"BACK"和"NEXT"文本按钮。针对第一个步骤,没有"返回"文本按钮;针对最后一个步骤,"下一步"文本按钮文本使用"开始"(中文语言)或者"START"(非中文语言)。 |
32
33**表1** Label对象定义
34
35| 名称 | 类型 | 默认值 | 描述 |
36| -------- | -------- | -------- | -------- |
37| prevLabel | string | - | 步骤导航器底部回退文本按钮的描述文本。 |
38| nextLabel | string | - | 步骤导航器底部下一步文本按钮的描述文本。 |
39| status | string | normal | 步骤导航器当前步骤的初始状态,可选值为:<br/>-&nbsp;normal:正常状态,右侧文本按钮正常显示,可点击进入下一个步骤。<br/>-&nbsp;disabled:不可用状态,右侧文本按钮灰度显示,不可点击进入下一个步骤。<br/>-&nbsp;waiting:等待状态,右侧文本按钮不显示,使用等待进度条,不可点击进入下一个步骤。 |
40
41
42## 样式
43
44除支持[通用样式](js-components-common-styles.md)外,还支持如下样式:
45
46| 名称 | 类型 | 默认值 | 必填 | 描述 |
47| -------- | -------- | -------- | -------- | -------- |
48| color | &lt;color&gt; | - | 否 | 文本颜色。 |
49| font-size | &lt;length&gt; | - | 否 | 文本大小。 |
50| allow-scale | boolean | true | 否 | 文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。<br>默认值:true。<br>true:表示文本尺寸跟随系统设置字体缩放尺寸进行放大缩小。<br>false:表示文本尺寸不跟随系统设置字体缩放尺寸进行放大缩小。 |
51| font-style | string | normal | 否 | 文本字体样式,可选值为:<br/>-&nbsp;normal:&nbsp;标准的字体样式;<br/>-&nbsp;italic:&nbsp;斜体的字体样式。 |
52| font-weight | number\|string | normal | 否 | 文本字体粗细,number类型取值[100,&nbsp;900]的整数(被100整除),默认为400,取值越大,字体越粗。string类型取值为:lighter、normal、bold、bolder。 |
53| text-decoration | string | none | 否 | 文本修饰,可选值为:<br/>-&nbsp;underline:&nbsp;文本下划线修饰。<br/>-&nbsp;line-through:&nbsp;穿过文本的修饰线。<br/>-&nbsp;none:&nbsp;标准文本。 |
54| font-family | string | sans-serif | 否 | 字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过[自定义字体](js-components-common-customizing-font.md)指定的字体,会被选中作为文本的字体。 |
55
56>  **说明:**
57> - 不支持长宽样式,宽和父容器stepper一样,高是父容器stepper减去底部导航按钮的高度。
58>
59> - 不支持position样式。
60
61
62## 事件
63
64除支持[通用事件](js-components-common-events.md)外,还支持如下事件:
65
66| 名称 | 参数 | 描述 |
67| -------- | -------- | -------- |
68| appear | - | 当该步骤出现时触发。 |
69| disappear | - | 当该步骤消失时触发。 |
70
71
72## 方法
73
74不支持[通用方法](js-components-common-methods.md)。
75
76
77## 示例
78
79详见[stepper示例](js-components-container-stepper.md)。
80