stepper-item

About 11 min

stepper-item

步骤导航器子组件,作为步骤导航器某一个步骤的内容展示组件。

说明: 从API Version 5 开始支持。

权限列表

子组件

支持。

属性

除支持通用属性外,还支持如下属性:

名称

类型

默认值

必填

描述

label

Label

-

自定义步骤导航器底部步骤提示文本按钮属性,不支持动态修改。如果没有定义该属性,步骤导航器在中文语言环境下,使用“返回”和“下一步”文本按钮,在非中文语言环境下,使用“BACK”和“NEXT”文本按钮。针对第一个步骤,没有回退文本按钮,针对最后一个步骤,下一步文本按钮文本使用“开始”(中文语言)或者“START”(非中文语言)。

表 1 Label对象定义

名称

类型

默认值

描述

prevLabel

string

-

步骤导航器底部回退文本按钮的描述文本。

nextLabel

string

-

步骤导航器底部下一步文本按钮的描述文本。

status

string

normal

步骤导航器当前步骤的初始状态,可选值为:

  • normal:正常状态,右侧文本按钮正常显示,可点击进入下一个步骤。
  • disabled:不可用状态,右侧文本按钮灰度显示,不可点击进入下一个步骤。
  • waiting:等待状态,右侧文本按钮不显示,使用等待进度条,不可点击进入下一个步骤。

样式

除支持通用样式外,还支持如下样式:

名称

类型

默认值

必填

描述

color

<color>

-

文本颜色。

font-size

<length>

-

文本大小。

allow-scale

boolean

true

文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。

font-style

string

normal

文本字体样式,可选值为:

  • normal: 标准的字体样式;
  • italic: 斜体的字体样式。

font-weight

number|string

normal

文本字体粗细,number类型取值[100, 900]的整数(被100整除),默认为400,取值越大,字体越粗。string类型取值为:lighter、normal、bold、bolder。

text-decoration

string

none

文本修饰,可选值为:

  • underline: 文本下划线修饰。
  • line-through: 穿过文本的修饰线。
  • none: 标准文本。

font-family

string

sans-serif

字体列表,用逗号分隔,每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过自定义字体指定的字体,会被选中作为文本的字体。

说明:

  • 不支持长宽样式,宽和父容器stepper一样,高是父容器stepper减去底部导航按钮的高度。
  • 不支持posit样式。

事件

除支持通用事件外,还支持如下事件:

名称

参数

描述

appear

-

当该步骤出现时触发。

disappear

-

当该步骤消失时触发。

方法

不支持通用方法

示例

详见stepper示例