# Progress 进度条

用于展示操作进度,告知用户当前状态和预期。

# 线形进度条

Progress 组件设置percentage属性即可,表示进度条对应的百分比,必填,必须在 0-100。通过 format 属性来指定进度条文字内容。

<template>
  <div class="progress-wrapper">
    <jp-progress :percentage="50"></jp-progress>
    <jp-progress :percentage="100" :format="format"></jp-progress>
    <jp-progress :percentage="100" status="success"></jp-progress>
    <jp-progress :percentage="100" status="warning"></jp-progress>
    <jp-progress :percentage="50" status="exception"></jp-progress>
  </div>
</template>

<script>
export default {
  methods: {
    format(percentage) {
      return percentage === 100 ? '满' : `${percentage}%`
    }
  }
}
</script>

<style scoped>
.jp-progress {
  width: 30vw;
  margin-top: 12px;
}
</style>
显示代码

# 百分比内显

百分比不占用额外控件,适用于文件上传等场景。

Progress 组件可通过 stroke-width 属性更改进度条的高度,并可通过 text-inside 属性来将进度条描述置于进度条内部。

<template>
  <div>
    <jp-progress :text-inside="true" :stroke-width="26" :percentage="70"></jp-progress>
    <jp-progress :text-inside="true" :stroke-width="24" :percentage="100" status="success"></jp-progress>
    <jp-progress :text-inside="true" :stroke-width="22" :percentage="80" status="warning"></jp-progress>
    <jp-progress :text-inside="true" :stroke-width="20" :percentage="50" status="exception"></jp-progress>
  </div>
</template>

<script>
export default {
  methods: {}
}
</script>
<style scoped>
.jp-progress {
  width: 30vw;
  margin-top: 12px;
}
</style>
显示代码

# 自定义颜色

可以通过 color 设置进度条的颜色,color 可以接受颜色字符串,函数和数组。

<template>
  <div>
    <jp-progress :percentage="percentage" :color="customColor"></jp-progress>

    <jp-progress :percentage="percentage" :color="customColorMethod"></jp-progress>

    <jp-progress :percentage="percentage" :color="customColors"></jp-progress>
    <div>
      <jp-button-group>
        <jp-button icon="jp-icon-minus" @click="decrease"></jp-button>
        <jp-button icon="jp-icon-plus" @click="increase"></jp-button>
      </jp-button-group>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      percentage: 20,
      customColor: '#409eff',
      customColors: [
        { color: '#f56c6c', percentage: 20 },
        { color: '#e6a23c', percentage: 40 },
        { color: '#5cb87a', percentage: 60 },
        { color: '#1989fa', percentage: 80 },
        { color: '#6f7ad3', percentage: 100 }
      ]
    }
  },
  methods: {
    customColorMethod(percentage) {
      if (percentage < 30) {
        return '#909399'
      } else if (percentage < 70) {
        return '#e6a23c'
      } else {
        return '#67c23a'
      }
    },
    increase() {
      this.percentage += 10
      if (this.percentage > 100) {
        this.percentage = 100
      }
    },
    decrease() {
      this.percentage -= 10
      if (this.percentage < 0) {
        this.percentage = 0
      }
    }
  }
}
</script>

<style scoped>
.jp-progress {
  width: 30vw;
  margin-top: 12px;
}
</style>
显示代码

# 环形进度条

Progress 组件可通过 type 属性来指定使用环形进度条,在环形进度条中,还可以通过 width 属性来设置其大小。

<template>
  <div class="progress-wrapper">
    <jp-progress type="circle" :percentage="0"></jp-progress>
    <jp-progress type="circle" :percentage="25"></jp-progress>
    <jp-progress type="circle" :percentage="100" status="success"></jp-progress>
    <jp-progress type="circle" :percentage="70" status="warning"></jp-progress>
    <jp-progress type="circle" :percentage="50" status="exception"></jp-progress>
  </div>
</template>

<script>
export default {
  methods: {}
}
</script>

<style scoped></style>
显示代码

# 仪表盘形进度条

通过 type 属性来指定使用仪表盘形进度条。

<template>
  <div>
    <jp-progress type="dashboard" :percentage="percentage" :color="colors"></jp-progress>
    <div>
      <jp-button-group>
        <jp-button icon="jp-icon-minus" @click="decrease"></jp-button>
        <jp-button icon="jp-icon-plus" @click="increase"></jp-button>
      </jp-button-group>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      percentage: 10,
      colors: [
        { color: '#f56c6c', percentage: 20 },
        { color: '#e6a23c', percentage: 40 },
        { color: '#5cb87a', percentage: 60 },
        { color: '#1989fa', percentage: 80 },
        { color: '#6f7ad3', percentage: 100 }
      ]
    }
  },
  methods: {
    increase() {
      this.percentage += 10
      if (this.percentage > 100) {
        this.percentage = 100
      }
    },
    decrease() {
      this.percentage -= 10
      if (this.percentage < 0) {
        this.percentage = 0
      }
    }
  }
}
</script>
显示代码

# Attributes

参数 说明 类型 可选值 默认值
percentage 百分比(必填) number 0-100 0
type 进度条类型 string line/circle/dashboard line
stroke-width 进度条的宽度,单位 px number 6
text-inside 进度条显示文字内置在进度条内(只在 type=line 时可用) boolean false
status 进度条当前状态 string success/exception/warning
color 进度条背景色(会覆盖 status 状态颜色) string/function/array ''
width 环形进度条画布宽度(只在 type 为 circle 或 dashboard 时可用) number 126
show-text 是否显示进度条文字内容 boolean true
stroke-linecap circle/dashboard 类型路径两端的形状 string butt/round/square round
format 指定进度条文字内容 function(percentage)