2017-11-06 19:22:02 +08:00
## InputNumber
2017-11-12 06:05:26 +08:00
Input de valores numéricos con un rango personalizable.
2017-11-06 19:22:02 +08:00
2017-11-12 06:05:26 +08:00
### Uso básico
2017-11-06 19:22:02 +08:00
2019-03-01 18:35:08 +08:00
:::demo Vincule una variable con `v-model` en el elemento `<el-input-number>` y estará listo.
2017-11-06 19:22:02 +08:00
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num" @change =" handleChange " :min = "1" :max = "10" ></ el-input-number >
2017-11-06 19:22:02 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num: 1
2017-11-06 19:22:02 +08:00
};
},
methods: {
handleChange(value) {
console.log(value)
}
}
};
< / script >
```
:::
### Disabled
2017-11-12 06:05:26 +08:00
:::demo El atributo `disabled` acepta un valor `boolean` , y si el valor es `true` , el componente queda deshabilitado. Si sólo necesita controlar el valor dentro de un rango, puede añadir un atributo `min` para establecer el valor mínimo y un valor `max` para establecer el valor máximo. Por defecto, el valor mínimo es `0` .
2017-11-06 19:22:02 +08:00
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num" :disabled = "true" > < / el-input-number >
2017-11-06 19:22:02 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num: 1
2017-11-06 19:22:02 +08:00
}
}
};
< / script >
```
:::
### Steps
2017-11-12 06:05:26 +08:00
Le permite definir el nivel de incremento de los saltos.
2017-11-06 19:22:02 +08:00
2017-11-12 06:05:26 +08:00
:::demo Añada el atributo `step` para establecer el salto.
2017-11-06 19:22:02 +08:00
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num" :step = "2" > < / el-input-number >
2017-11-06 19:22:02 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num: 5
2017-11-06 19:22:02 +08:00
}
}
};
< / script >
```
:::
2018-05-23 14:10:34 +08:00
### Precision
:::demo Add `precision` attribute to set the precision of input value.
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num" :precision = "2" :step = "0.1" :max = "10" > < / el-input-number >
2018-05-23 14:10:34 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num: 1
2018-05-23 14:10:34 +08:00
}
}
};
< / script >
```
:::
:::tip
2018-08-07 18:33:58 +08:00
The value of `precision` must be a non negative integer and should not be less than the decimal places of `step` .
2018-05-23 14:10:34 +08:00
:::
2017-11-12 06:05:26 +08:00
### Tamaño
2017-11-06 19:22:02 +08:00
2017-11-12 06:05:26 +08:00
Utilice el atributo `size` para establecer tamaños adicionales con `medium` , `small` o `mini` .
2017-11-06 19:22:02 +08:00
:::demo
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num1" > < / el-input-number >
< el-input-number size = "medium" v-model = "num2" > < / el-input-number >
< el-input-number size = "small" v-model = "num3" > < / el-input-number >
< el-input-number size = "mini" v-model = "num4" > < / el-input-number >
2017-11-06 19:22:02 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num1: 1,
num2: 1,
num3: 1,
num4: 1
2017-11-06 19:22:02 +08:00
}
}
};
< / script >
```
:::
2017-11-12 06:05:26 +08:00
### Posición de los controles
:::demo Establezca `controls-position` para decidir la posición de los botones de control.
2017-11-06 19:22:02 +08:00
```html
< template >
2019-04-12 15:23:20 +08:00
< el-input-number v-model = "num" controls-position = "right" @change =" handleChange " :min = "1" :max = "10" ></ el-input-number >
2017-11-06 19:22:02 +08:00
< / template >
< script >
export default {
data() {
return {
2019-04-12 15:23:20 +08:00
num: 1
2017-11-06 19:22:02 +08:00
};
},
methods: {
handleChange(value) {
console.log(value);
}
}
};
< / script >
```
:::
2017-11-12 06:05:26 +08:00
### Atributos
2017-12-03 18:03:06 +08:00
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| ----------------- | ---------------------------------------- | ------- | ----------------- | ----------- |
2019-01-23 11:34:19 +08:00
| value / v-model | valor vinculado | number | — | 0 |
2018-01-26 10:53:53 +08:00
| min | el valor mínimo permitido | number | — | `-Infinity` |
2017-12-03 18:03:06 +08:00
| max | el valor maximo permitido | number | — | `Infinity` |
| step | incremento (salto) | number | — | 1 |
2018-05-29 10:45:38 +08:00
| precision | precisión del valor del input | number | — | — |
2017-12-03 18:03:06 +08:00
| size | tamaño del componente | string | large/small | — |
| disabled | si el componente esta deshabilitado | boolean | — | false |
| controls | si se activan los botones de control | boolean | — | true |
| controls-position | posición de los botones de control | string | right | - |
| name | lo mismo que `name` en un input nativo | string | — | — |
| label | texto de la etiqueta | string | — | — |
2018-11-05 15:36:36 +08:00
| placeholder | placeholder in input | string | - | - |
2017-11-12 06:05:26 +08:00
### Eventos
2017-12-03 18:03:06 +08:00
| Nombre | Descripción | Parámetros |
| ------ | ---------------------------------------- | ------------------ |
| change | se produce cuando el valor cambia | value after change |
| blur | se produce cuando el componente pierde el foco | (event: Event) |
| focus | se produce cuando el componente obtiene el foco | (event: Event) |
2017-11-12 06:05:26 +08:00
### Métodos
2017-12-03 18:03:06 +08:00
| Método | Descripción | Parámetro |
| ------ | ------------------------------------ | --------- |
| focus | coloca el foco en el elemento actual | - |
2018-11-19 10:59:58 +08:00
| select | selecciona el contenido del input | - |
2018-11-05 19:21:24 +08:00