element/examples/docs/zh-CN/input-number.md

139 lines
2.9 KiB
Markdown
Raw Normal View History

2016-07-27 06:15:02 +00:00
<script>
export default {
data() {
return {
num1: 1,
num2: 1,
2017-01-16 02:42:32 +00:00
num3: 5,
num4: 1,
num5: 1,
num6: 1
2016-07-27 06:15:02 +00:00
}
2016-09-01 07:56:04 +00:00
},
methods: {
handleChange(value) {
console.log(value);
}
2016-07-27 06:15:02 +00:00
}
};
</script>
<style>
.demo-box.demo-input-number {
.el-input-number + .el-input-number {
margin-left: 10px;
}
}
</style>
## InputNumber 计数器
2016-07-27 06:15:02 +00:00
2016-09-01 07:56:04 +00:00
仅允许输入标准的数字值,可定义范围
2016-09-01 07:56:04 +00:00
### 基础用法
2016-07-27 06:15:02 +00:00
:::demo 要使用它,只需要在`el-input-number`元素中使用`v-model`绑定变量即可,变量的初始值即为默认值。
2016-07-27 06:15:02 +00:00
```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
};
2016-11-06 08:09:02 +00:00
},
methods: {
handleChange(value) {
console.log(value);
}
}
};
</script>
2016-07-27 06:15:02 +00:00
```
:::
2016-07-27 06:15:02 +00:00
### 禁用状态
2016-07-27 06:15:02 +00:00
:::demo `disabled`属性接受一个`Boolean`,设置为`true`即可禁用整个组件,如果你只需要控制数值在某一范围内,可以设置`min`属性和`max`属性,不设置`min`和`max`时,最小值为 0。
2016-07-27 06:15:02 +00:00
```html
2016-11-06 08:09:02 +00:00
<template>
<el-input-number v-model="num2" :disabled="true"></el-input-number>
</template>
<script>
export default {
data() {
return {
num2: 1
}
}
};
</script>
2016-07-27 06:15:02 +00:00
```
:::
2016-07-27 06:15:02 +00:00
2016-09-01 07:56:04 +00:00
### 步数
2016-07-27 06:15:02 +00:00
2016-09-01 07:56:04 +00:00
允许定义递增递减的步数控制
:::demo 设置`step`属性可以控制步长,接受一个`Number`。
2016-07-27 06:15:02 +00:00
```html
2016-11-06 08:09:02 +00:00
<template>
<el-input-number v-model="num3" :step="2"></el-input-number>
</template>
<script>
export default {
data() {
return {
num3: 5
}
}
};
</script>
2016-07-27 06:15:02 +00:00
```
:::
2016-07-27 06:15:02 +00:00
2017-01-16 02:42:32 +00:00
### 尺寸
额外提供了 `large`、`small` 两种尺寸的数字输入框
:::demo
```html
<template>
<el-input-number size="large" v-model="num4"></el-input-number>
<el-input-number v-model="num5"></el-input-number>
<el-input-number size="small" v-model="num6"></el-input-number>
</template>
<script>
export default {
data() {
return {
num4: 1,
num5: 1,
num6: 1
}
}
};
</script>
```
:::
### Attributes
2016-07-27 06:15:02 +00:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|----------|-------------- |----------|-------------------------------- |-------- |
2016-09-01 07:56:04 +00:00
| value | 绑定值 | number | — | — |
| min | 设置计数器允许的最小值 | number | — | 0 |
| max | 设置计数器允许的最大值 | number | — | Infinity |
| step | 计数器步长 | number | — | 1 |
| size | 计数器尺寸 | string | large, small | — |
| disabled | 是否禁用计数器 | boolean | — | false |
| controls | 是否使用控制按钮 | boolean | — | true |
2016-09-01 07:56:04 +00:00
### Events
| 事件名称 | 说明 | 回调参数 |
|---------|--------|---------|
| change | 绑定值被改变时触发 | 最后变更的值 |