mirror of https://github.com/ElemeFE/element
181 lines
3.8 KiB
Markdown
181 lines
3.8 KiB
Markdown
![]() |
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num1: 1,
|
||
|
num2: 1,
|
||
|
num3: 5,
|
||
|
num4: 1,
|
||
|
num5: 1,
|
||
|
num6: 1,
|
||
|
num7: 1,
|
||
|
num8: 1
|
||
|
}
|
||
|
},
|
||
|
methods: {
|
||
|
handleChange(value) {
|
||
|
console.log(value);
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
|
||
|
<style>
|
||
|
.demo-box.demo-input-number {
|
||
|
.el-input-number + .el-input-number {
|
||
|
margin-left: 10px;
|
||
|
}
|
||
|
}
|
||
|
</style>
|
||
|
|
||
|
## InputNumber
|
||
|
|
||
|
Input numerical values with a customizable range.
|
||
|
|
||
|
### Basic usage
|
||
|
|
||
|
:::demo Bind a variable to `v-model` in `<el-input-number>` element and you are set.
|
||
|
|
||
|
```html
|
||
|
<template>
|
||
|
<el-input-number v-model="num1" @change="handleChange" :min="1" :max="10"></el-input-number>
|
||
|
</template>
|
||
|
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num1: 1
|
||
|
};
|
||
|
},
|
||
|
methods: {
|
||
|
handleChange(value) {
|
||
|
console.log(value)
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
```
|
||
|
:::
|
||
|
|
||
|
### Disabled
|
||
|
|
||
|
:::demo The `disabled` attribute accepts a `boolean`, and if the value is `true`, the component is disabled. If you just need to control the value within a range, you can add `min` attribute to set the minimum value and `max` to set the maximum value. By default, the minimum value is `0`.
|
||
|
|
||
|
```html
|
||
|
<template>
|
||
|
<el-input-number v-model="num2" :disabled="true"></el-input-number>
|
||
|
</template>
|
||
|
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num2: 1
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
```
|
||
|
:::
|
||
|
|
||
|
### Steps
|
||
|
|
||
|
Allows you to define incremental steps.
|
||
|
|
||
|
:::demo Add `step` attribute to set the step.
|
||
|
|
||
|
```html
|
||
|
<template>
|
||
|
<el-input-number v-model="num3" :step="2"></el-input-number>
|
||
|
</template>
|
||
|
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num3: 5
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
```
|
||
|
:::
|
||
|
|
||
|
### Size
|
||
|
|
||
|
Use attribute `size` to set additional sizes with `medium`, `small` or `mini`.
|
||
|
|
||
|
:::demo
|
||
|
|
||
|
```html
|
||
|
<template>
|
||
|
<el-input-number v-model="num4"></el-input-number>
|
||
|
<el-input-number size="medium" v-model="num5"></el-input-number>
|
||
|
<el-input-number size="small" v-model="num6"></el-input-number>
|
||
|
<el-input-number size="mini" v-model="num7"></el-input-number>
|
||
|
</template>
|
||
|
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num4: 1,
|
||
|
num5: 1,
|
||
|
num6: 1,
|
||
|
num7: 1
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
```
|
||
|
:::
|
||
|
|
||
|
### Controls Position
|
||
|
|
||
|
:::demo Set `controls-position` to decide the position of control buttons.
|
||
|
```html
|
||
|
<template>
|
||
|
<el-input-number v-model="num8" controls-position="right" @change="handleChange" :min="1" :max="10"></el-input-number>
|
||
|
</template>
|
||
|
<script>
|
||
|
export default {
|
||
|
data() {
|
||
|
return {
|
||
|
num8: 1
|
||
|
};
|
||
|
},
|
||
|
methods: {
|
||
|
handleChange(value) {
|
||
|
console.log(value);
|
||
|
}
|
||
|
}
|
||
|
};
|
||
|
</script>
|
||
|
```
|
||
|
:::
|
||
|
|
||
|
### Attributes
|
||
|
|
||
|
| Attribute | Description | Type | Accepted Values | Default |
|
||
|
|----| ----| ---| ----| -----|
|
||
|
|value | binding value| number | — | — |
|
||
|
|min | the minimum allowed value | number | — | 0 |
|
||
|
|max | the maximum allowed value | number | — | `Infinity` |
|
||
|
|step | incremental step | number | — | 1 |
|
||
|
|size | size of the component | string | large/small| — |
|
||
|
|disabled| whether the component is disabled | boolean | — | false |
|
||
|
|controls| whether to enable the control buttons | boolean | — | true |
|
||
|
|debounce| debounce delay when typing, in milliseconds | number | — | 300 |
|
||
|
|controls-position | position of the control buttons | string | right | - |
|
||
|
|name | same as `name` in native input | string | — | — |
|
||
|
|label | label text | string | — | — |
|
||
|
### Events
|
||
|
|
||
|
| Event Name | Description | Parameters |
|
||
|
|----| ---- | -----|
|
||
|
|change | triggers when the value changes | value after change |
|
||
|
| blur | triggers when Input blurs | (event: Event) |
|
||
|
| focus | triggers when Input focuses | (event: Event) |
|
||
|
|
||
|
### Methods
|
||
|
| Method | Description | Parameters |
|
||
|
|------|--------|-------|
|
||
|
| focus | focus the Input component | - |
|