2020-08-13 15:18:26 +08:00
## Progreso
Progreso es usado para mostrar el estado de la operación actual e informar al usuario acerca de ésta.
### Barra de progreso lineal
:::demo Usa el atributo `percentage` para asignar el porcentaje. Este es **requerido** y tiene que ser un valor entre `0-100` . Puede personalizar el formato de texto estableciendo `format` .
```html
< el-progress :percentage = "50" > < / el-progress >
< el-progress :percentage = "100" :format = "format" > < / el-progress >
< el-progress :percentage = "100" status = "success" > < / el-progress >
< el-progress :percentage = "100" status = "warning" > < / el-progress >
< el-progress :percentage = "50" status = "exception" > < / el-progress >
< script >
export default {
methods: {
format(percentage) {
return percentage === 100 ? 'Full' : `${percentage}%` ;
}
}
};
< / script >
```
:::
### Porcentaje interno
En este caso el porcentaje no toma espacio adicional.
:::demo El atributo `stroke-width` decide el ancho de la barra de progreso, y usa el atributo `text-inside` para poner la descripción dentro de la misma.
```html
< el-progress :text-inside = "true" :stroke-width = "26" :percentage = "70" > < / el-progress >
< el-progress :text-inside = "true" :stroke-width = "24" :percentage = "100" status = "success" > < / el-progress >
< el-progress :text-inside = "true" :stroke-width = "22" :percentage = "80" status = "warning" > < / el-progress >
< el-progress :text-inside = "true" :stroke-width = "20" :percentage = "50" status = "exception" > < / el-progress >
```
:::
### Color personalizado
Puede utilizar el atributo `color` para establecer el color de la barra de progreso.
:::demo
```html
< el-progress :percentage = "percentage" :color = "customColor" > < / el-progress >
< el-progress :percentage = "percentage" :color = "customColorMethod" > < / el-progress >
< el-progress :percentage = "percentage" :color = "customColors" > < / el-progress >
< div >
< el-button-group >
< el-button icon = "el-icon-minus" @click =" decrease " ></ el-button >
< el-button icon = "el-icon-plus" @click =" increase " ></ el-button >
< / el-button-group >
< / div >
< 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 >
```
:::
### Barra de progreso circular
:::demo Puede asignar el atributo `type` como `circle` para usar la barra circular de progreso, y usar el atributo `width` para cambiar el tamaño del círculo.
```html
< el-progress type = "circle" :percentage = "0" > < / el-progress >
< el-progress type = "circle" :percentage = "25" > < / el-progress >
< el-progress type = "circle" :percentage = "100" status = "success" > < / el-progress >
< el-progress type = "circle" :percentage = "70" status = "warning" > < / el-progress >
< el-progress type = "circle" :percentage = "50" status = "exception" > < / el-progress >
```
:::
### Barra de progreso del panel de control
:::demo También puede especificar el atributo `type` a `dashboard` para usar la barra de progreso del panel de control.
```html
< el-progress type = "dashboard" :percentage = "percentage" :color = "colors" > < / el-progress >
< div >
< el-button-group >
< el-button icon = "el-icon-minus" @click =" decrease " ></ el-button >
< el-button icon = "el-icon-plus" @click =" increase " ></ el-button >
< / el-button-group >
< / div >
< 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 >
```
:::
2021-02-05 16:27:44 +08:00
### Customized content
:::demo Use default slot to add customized content.
```html
< el-progress :percentage = "50" >
< el-button type = "text" > Content< / el-button >
< / el-progress >
< el-progress :text-inside = "true" :stroke-width = "20" :percentage = "50" status = "exception" >
< span > Content< / span >
< / el-progress >
< el-progress type = "circle" :percentage = "100" status = "success" >
< el-button type = "success" icon = "el-icon-check" circle > < / el-button >
< / el-progress >
< el-progress type = "dashboard" :percentage = "80" >
< template #default ="{ percentage }" >
< span class = "percentage-value" > {{ percentage }}%< / span >
< span class = "percentage-label" > Progressing< / span >
< / template >
< / el-progress >
```
:::
2021-04-21 13:47:29 +08:00
### Indeterminate progress
:::demo Use `indeterminate` attribute to set indeterminate progress, with `duration` to control the animation duration.
```html
< el-progress :percentage = "50" :indeterminate = "true" > < / el-progress >
< el-progress :percentage = "100" :format = "format" :indeterminate = "true" > < / el-progress >
< el-progress :percentage = "100" status = "success" :indeterminate = "true" :duration = "5" > < / el-progress >
< el-progress :percentage = "100" status = "warning" :indeterminate = "true" :duration = "1" > < / el-progress >
< el-progress :percentage = "50" status = "exception" :indeterminate = "true" > < / el-progress >
< script >
export default {
methods: {
format(percentage) {
return percentage === 100 ? 'Full' : `${percentage}%` ;
}
}
};
< / script >
```
:::
2020-08-13 15:18:26 +08:00
### Atributos
| Atributo | Descripción | Tipo | Valores aceptado | Por defecto |
| ------------ | ---------------------------------------- | ------- | ----------------- | ----------- |
| percentage | porcentaje, requerido | number | 0-100 | 0 |
| type | tipo de barra de progreso | string | line/circle/dashboard | line |
| stroke-width | ancho de la barra de progreso | number | — | 6 |
| text-inside | mostrar el porcentaje dentro de la barra de progreso, solo funciona cuando `type` es 'line' | boolean | — | false |
| status | estado actual de la barra de progreso | string | success/exception/warning | — |
2021-04-21 13:47:29 +08:00
| indeterminate | set indeterminate progress | boolean | - | false |
| duration | control the animation duration of indeterminate progress | number | - | 3 |
2020-08-13 15:18:26 +08:00
| color | color de fondo de la barra de progreso. Sobreescribe la propiedad `status` | string/function/array | — | '' |
| width | ancho del canvas que contiene la barra de progreso circula | number | — | 126 |
| show-text | mostrar porcentaje | boolean | — | true |
2021-01-05 16:22:33 +08:00
| stroke-linecap | circle/dashboard type shape at the end path | string | butt/round/square | round |
| format | personalizar el formato de texto estableciendo format | function(percentage) | — | — |
2021-02-05 16:27:44 +08:00
### Slot
| name | Description |
|------|--------|
| default | Customized content, parameter is { percentage } |