# LineProgress 线形进度条

展示操作或任务的当前进度,比如上传文件,是一个线形的进度条。

# 基本使用

  • 通过percentage设置当前的进度值,该值区间为0-100.
  • 通过activeColor设置进度条的颜色
<template>
	<un-line-progress :percentage="30" activeColor="#ff0000" inactiveColor="#f5f5f5"></un-line-progress>
</template>
✅ Copy success!

# 不显示百分比

不显示百分比值信息

  • show-text参数配置是否显示进度条内百分值
<template>
	<un-line-progress :percentage="30" :showText="false" inactiveColor="#f5f5f5"></un-line-progress>
</template>
✅ Copy success!

# 自定义高度

  • height进度条高度
<template>
	<un-line-progress :percentage="30" height="8" inactiveColor="#f5f5f5"></un-line-progress>
</template>
✅ Copy success!

# 自定义样式(不支持安卓环境的nvue)

  • 自定义的数值样式嵌套在默认插槽里
<template>
	<un-line-progress :percentage="30" inactiveColor="#f5f5f5">
		<text class="u-percentage-slot">{{30}}%</text>
	</un-line-progress>
</template>
<style lang="css" scoped>
.u-percentage-slot {
	padding: 1px 5px;
	background-color: #ff9900;
	color: #fff;
	border-radius: 100px;
	font-size: 10px;
	margin-right: -5px;
}
</style>
✅ Copy success!

# 手动加减

  • 通过控制percentage参数数值达到增减
<template>
	<view style="margin-top: 50px;">
		<un-line-progress :percentage="percentage" inactiveColor="#f5f5f5" />
		<view style="display: flex;margin-top: 100px;">
			<button @click="computedWidth('minus')">减少</button>
			<button @click="computedWidth('plus')">增加</button>
		</view>
	</view>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const percentage = ref(30)

const computedWidth = (type: string) => {
	if(type === 'plus') {
		percentage.value = uni.$u.range(0, 100, percentage.value + 10)
	} else {
		percentage.value = uni.$u.range(0, 100, percentage.value - 10)
	}
}
</script>
✅ Copy success!

# API

# Props

参数 说明 类型 默认值 可选值
activeColor 进度条激活部分的颜色 string #19be6b -
inactiveColor 进度条的底色,默认为灰色 string #ececec -
percentage 进度百分比,数值 string | number 0 -
showText 是否在进度条内部显示百分比的值 boolean true false
height 进度条的高度,默认单位px string | number 12 -

# Slots

名称 说明
default 传入自定义的显示内容,将会覆盖默认显示的百分比值
上次更新时间: 2025/10/24 23:49:22
当前文档拷贝至3.x版本,尚不完善,我们正在努力完善中,欢迎您的反馈和参与改进。
×