Skip to content
在新窗口打开实时预览

LineProgress 线形进度条 ​

以线形进度展示操作或任务的当前进度,比如上传文件,支持主题色预设、条纹与百分比展示。

平台兼容性 ​

H5App微信小程序支付宝小程序
√√√√

基础用法 ​

vue
<snake-line-progress :percent="40" />
<snake-line-progress :percent="60" :active-color="'#06D290'" />

条纹与预设 ​

vue
<!-- 主题预设,type 设置后 activeColor 失效 -->
<snake-line-progress :percent="30" type="primary" />
<!-- 静态/动态条纹 -->
<snake-line-progress :percent="50" striped />
<snake-line-progress :percent="70" striped striped-active />

进度条内部默认展示百分比,通过 show-percent="false" 关闭;传入默认插槽可完全替换内部内容。

percent 会按 0–100 使用;上传场景将接口回调的进度直接传入即可,完成后再由业务切换成功状态或关闭进度条。

API ​

Props ​

参数说明类型默认值
percent进度百分比,数值 0-100number | string0
round两端是否显示半圆形booleantrue
type主题预设,设置后 activeColor 失效primary | success | warning | error | info''
activeColor激活部分的颜色string--snake-color-success
inactiveColor进度条的底色string--snake-color-divider
showPercent是否在进度条内部显示百分比booleantrue
height进度条高度,数值按 rpx 处理number | string28
striped是否显示激活部分的条纹booleanfalse
stripedActive条纹是否具有动态效果booleanfalse

Slots ​

名称说明
default替换进度条内部默认百分比

主题变量 ​

变量名说明
--snake-color-divider轨道默认颜色
--snake-color-primaryprimary 预设颜色
--snake-color-success默认激活色及 success 预设
--snake-color-warningwarning 预设颜色
--snake-color-errorerror 预设颜色
--snake-color-infoinfo 预设颜色
--snake-color-white进度文字颜色
--snake-color-text-light条纹装饰颜色

为 uni-app 商城与 CMS 场景设计