进度条 Progress

用来展示当前事件进度。

百分比

通过percent属性设置进度条当前进度,取值0~100,默认为0.

基本使用方法

示例代码

  1. <l-progress percent="20"></l-progress>
  2. <l-progress percent="50"></l-progress>

宽度

通过stroke-width属性设置进度条的宽度。默认12,单位rpx.

宽度

示例代码

  1. <l-progress percent="20"></l-progress>
  2. <l-progress percent="50" stroke-width='20'></l-progress>

圆角

通过border-radius属性设置进度条的圆角数值,默认为6,单位rpx.

圆角

示例代码

  1. <l-progress percent="20" stroke-width='20' border-radius='8'></l-progress>
  2. <l-progress percent="50" stroke-width='20' border-radius='15'></l-progress>

已选择的进度条颜色

通过active-color属性可以设置已选择的进度条颜色,默认为主题色。(关于主题色设置请阅读入门介绍-主题色更改进度条 Progress - 图4

已选进度条颜色

示例代码

  1. <l-progress percent="20"></l-progress>
  2. <l-progress percent="50" active-color="red"></l-progress>

背景色

通过background-color属性可以设置未选择的进度条颜色,默认颜色#EBEBEB

背景颜色

示例代码

  1. <l-progress percent="20"></l-progress>
  2. <l-progress percent="50" background-color='#FF00FF'></l-progress>

显示数值

通过设置show-info属性为true,可以显示当前百分比数值,默认为false.

  1. <l-progress percent='20' show-info="{{true}}">

文字显示位置

通过text-position属性可以设置百分比数值的显示位置,可选值有”left”,”right”。默认为”right”。

文字位置

示例代码

  1. <l-progress percent="20" show-info="{{true}}"></l-progress>
  2. <l-progress percent="50" show-info="{{true}}" text-position="left"></l-progress>

文字颜色

通过text-color属性,可以设置文字颜色,默认为主题色。(关于主题色设置请阅读入门介绍-主题色更改进度条 Progress - 图8

文字颜色

示例代码

  1. <l-progress percent="50" show-info="{{true}}" text-color='red'></l-progress>

文字和进度条间隔

通过interval属性,可以设置文字和进度条之间的间隔距离。默认值20,单位rpx

自定义子节点

进度条头部的样式可通过slot自定义传入,通过传入slot=”header”自定义进度条头部样式。

自定义header

示例代码

  1. <l-progress>
  2. <view slot='header' style="width:50rpx;height:50rpx;border-radius:50%;background-color:red;display:block;"></view>
  3. </l-progress>
  4. <l-progress percent="50" l-slot-class='slot-class'>
  5. <image src="imoji.jpg" slot='header' style="width:50rpx;height:50rpx;border-radius:50%;display:block;" />
  6. </l-progress>

TIP

slot传递的组件,需要标注display:block;属性

进度条属性(Progress Attributes)

参数说明类型可选值默认值版本
percent百分比Number0~10000.8.0
stroke-width进度条线的宽度number/string-60.8.0
border-radius圆角大小number/string-60.8.0
active-color已选择的进度条的颜色String-主题色0.8.0
background-color未选择的进度条的颜色String-#EBEBEB0.8.0
show-info显示当前百分比数值boolean-false0.8.0
text-position文字显示位置String‘left’,’right’‘right’0.8.0
text-color文字颜色String--0.8.0
interval文字和进度条间隔距离Number-20,单位rpx0.8.0
active进度条从左往右的动画Booleanfalse0.8.0
duration进度增加1%所需毫秒数Number30,单位毫秒0.8.0

外部样式类(Progress ExternalClasses)

外部样式类说明备注版本
l-class进度条整体的外部样式类
l-text-class文本的外部样式类
l-active-class覆盖已选择进度的外部样式类
l-background-class覆盖背景进度条的外部样式类

插槽 (Progress Slots)

插槽名说明备注
header自定义header