32632e796e
Change-Id: I76d0f72679cd75085f5ffd42f641daa198cafe11 docs: update docs for alert/autocomplete/carousel, etc. Change-Id: Ib7507f4979024f53c127e4b64b88560b93999db7 fix: update for autocomplete filter Change-Id: Ie54556715fa52838aeb6caaa19b4f9a9f14b490f docs: add docs for calendar/transfer/cascader Change-Id: I655b3cb3d25dd0649de9ae7e224e7063a40dd079 fix: add more demos for input/textarea Change-Id: Iada527ca82643a435a4775110b332155512d62a7 docs: add docs for uploader,select,table, etc. Change-Id: Ib034fd5cc9d9a420d4e002956ae925175783c5f3 docs: adjust formatting and punc. docs: adjust docs for uploader, etc. Change-Id: If06c8c1102eafce43f5802a333676fc9e62cd474 docs: add docs for nav Change-Id: If56a653ec53f19239606128fd30cae80f8e10025 docs: improve anchor demos Change-Id: I6ac1c08cc8905924d0062def1f8921fe1f302f15 docs: refine wording and format docs: update docs for check-button-group desc Change-Id: Ica7d6d0692250f0be6bd330b1ad4cc41938afd46
117 lines
2.9 KiB
Markdown
117 lines
2.9 KiB
Markdown
# NumberInput <small>数字输入</small>
|
||
|
||
## 示例
|
||
|
||
### 尺寸
|
||
|
||
可选的尺寸 [`ui`](#props-ui) 属性值:`xs` / `s` / `m`。
|
||
|
||
[[ demo src="/demo/number-input/size.vue" ]]
|
||
|
||
### 只读状态
|
||
|
||
设置 `readonly` 来使数字输入框处于只读状态。
|
||
|
||
[[ demo src="/demo/number-input/readonly.vue" ]]
|
||
|
||
### 禁用状态
|
||
|
||
设置 `disabled` 来使数字输入框处于禁用状态。
|
||
|
||
[[ demo src="/demo/number-input/disabled.vue" ]]
|
||
|
||
### 精度位数和递增/递减
|
||
|
||
设置 `decimal-place` 来指定数值的小数精度位数。
|
||
|
||
设置 `step` 来指定每次递增/减的数值。
|
||
|
||
[[ demo src="/demo/number-input/decimal.vue" ]]
|
||
|
||
## API
|
||
|
||
### 属性
|
||
|
||
| 名称 | 类型 | 默认值 | 描述 |
|
||
| -- | -- | -- | -- |
|
||
| ``ui`` | `string=` | - | [^ui] |
|
||
| ``value`` | `number` | - | [^value] |
|
||
| ``readonly`` | `boolean=` | `false` | 数字输入框是否为只读状态。 |
|
||
| ``disabled`` | `boolean=` | `false` | 数字输入框是否为禁用状态。 |
|
||
| ``placeholder`` | `string` | - | 输入占位符。 |
|
||
| ``select-on-focus`` | `boolean` | `false` | 聚焦时是否自动选中数字输入框文本。 |
|
||
| ``max`` | `number` | - | 允许的最大值。 |
|
||
| ``min`` | `number` | - | 允许的最小值。 |
|
||
| ``decimal-place`` | `number` | 0 | 数值的小数精度位数,默认精确到整数位,`-1` 表示不处理精度。 |
|
||
| ``step`` | `number` | 1 | 每次递增/递减的数值。 |
|
||
|
||
^^^ui
|
||
预设样式。
|
||
|
||
+++枚举值
|
||
| 值 | 描述 |
|
||
| -- | -- |
|
||
| `xs` | 超小尺寸样式。 |
|
||
| `s` | 小尺寸样式。 |
|
||
| `m` | 中尺寸样式。 |
|
||
+++
|
||
^^^
|
||
|
||
^^^value
|
||
:::badges
|
||
`v-model`
|
||
:::
|
||
|
||
数字输入框的值。
|
||
^^^
|
||
|
||
### 插槽
|
||
|
||
| 名称 | 描述 |
|
||
| -- | -- |
|
||
| ``before`` | 数字输入框前置内容。 |
|
||
| ``after`` | 数字输入框后置内容。位于增减按钮之后。 |
|
||
|
||
:::warning
|
||
注意,插槽宽度会挤压输入框宽度。
|
||
:::
|
||
|
||
### 事件
|
||
|
||
| 名称 | 描述 |
|
||
| -- | -- |
|
||
| ``change`` | [^event-change] |
|
||
| ``input`` | [^event-input] |
|
||
|
||
^^^event-change
|
||
原生 `change` 事件,回调参数为 `(value, event)`。
|
||
|
||
+++参数详情
|
||
| 名称 | 类型 | 描述 |
|
||
| -- | -- | -- |
|
||
| `value` | `number` | 数字输入框的值。 |
|
||
| `event` | `Event` | 原生事件对象。 |
|
||
+++
|
||
^^^
|
||
|
||
^^^event-input
|
||
:::badges
|
||
`v-model`
|
||
:::
|
||
|
||
有效输入时触发,受数字格式化影响,若当前值格式化为无效值,则不触发。回调参数为 `(value: string)`,`value` 为数字输入框的 `value` 值。
|
||
^^^
|
||
|
||
此外,`NumberInput` 支持如下的原生事件:
|
||
|
||
`auxclick`、`click`、`contextmenu`、`dblclick`、`mousedown`、`mouseenter`、`mouseleave`、`mousemove`、`mouseover`、`mouseout`、`mouseup`、`select`、`wheel`、`keydown`、`keypress`、`keyup`、`focus`、`blur`、`focusin`、`focusout`。
|
||
|
||
回调函数的参数都为原生事件对象。
|
||
|
||
### 图标
|
||
|
||
| 名称 | 描述 |
|
||
| -- | -- |
|
||
| ``increase`` | 增加按钮。 |
|
||
| ``decrease`` | 减少按钮。 |
|