-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
18 changed files
with
570 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,164 @@ | ||
--- | ||
title: InputNumber 数字输入框 | ||
lang: zh-CN | ||
--- | ||
|
||
# InputNumber 数字输入框 | ||
|
||
通过鼠标或键盘,输入范围内的数值。 | ||
|
||
## 基本使用 | ||
|
||
基本使用。 | ||
|
||
<demo src="../../../../example/input-number/basic.svelte"></demo> | ||
|
||
## 三种大小 | ||
|
||
我们为`<Input />`输入框定义了三种尺寸(大、默认、小),高度分别为`40px`、`32px` 和 `24px`。 | ||
|
||
<demo src="../../../../example/input-number/size.svelte"></demo> | ||
|
||
## 前置/后置标签 | ||
|
||
使用`addonBefore`插槽自定义前置标签,`addonAfter`插槽自定义后置标签。 | ||
|
||
<demo src="../../../../example/input-number/addon.svelte"></demo> | ||
|
||
## 不可用 | ||
|
||
禁用的输入框。 | ||
|
||
<demo src="../../../../example/input-number/disabled.svelte"></demo> | ||
|
||
## 精度限制 | ||
|
||
使用`precision`属性指定精度,为`0`表示只能输入整数。 | ||
|
||
<demo src="../../../../example/input-number/precision.svelte"></demo> | ||
|
||
## 格式化展示 | ||
|
||
通过`formatter`格式化数字,以展示具有具体含义的数据。此属性只控制展示效果,如果使用了`bind:value`的话,value永远为`数字`。 | ||
|
||
需要获取`格式化数字`,可通过`input`或`change`事件获取。默认如果存在`formatter`则`input`或`change`事件返回的值是`数字`,如果需要`格式化数字`则可以使用`isParse=false`。 | ||
|
||
> 再次说明:`isParse`属性只控制`input`或`change`事件中的值,不控制`value`,`value`永远为`数字`。 | ||
<demo src="../../../../example/input-number/formatter.svelte"></demo> | ||
|
||
## 键盘行为 | ||
|
||
使用`keyboard`属性可以控制键盘行为。 | ||
|
||
<demo src="../../../../example/input-number/keyboard.svelte"></demo> | ||
|
||
## 无边框 | ||
|
||
没有边框。 | ||
|
||
<demo src="../../../../example/input-number/bordered.svelte"></demo> | ||
|
||
## 前置内容 | ||
|
||
使用`prefix`插槽自定义前置内容。 | ||
|
||
<demo src="../../../../example/input-number/prefix.svelte"></demo> | ||
|
||
## Input Props 属性 | ||
|
||
| 属性 | 说明 | 类型 | 默认值 | 版本 | | ||
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | -------- | ---- | | ||
| allowClear | 可以点击清除图标删除内容 | `boolean` | `false` | | | ||
| bordered | 是否有边框 | `boolean` | `true` | | | ||
| defaultValue | 输入框默认内容 | `string` | - | | | ||
| disabled | 设置按是否禁用状态 | `boolean` | `false` | | ||
| id | 输入框的id | `string` | - | | | ||
| maxLength | 最大长度 | `number` | - | | | ||
| showCount | 是否展示字数 | `boolean` | `false` | | | ||
| status | 设置校验状态 | `error \| warning` | - | | | ||
| size | 控件大小。 | `large \| middle \| small` | `middle` | | | ||
| type | 声明`input`类型,同原生`input`标签的`type`属性,见:[MDN](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input#%E5%B1%9E%E6%80%A7)(请直接使用`Input.TextArea`代替`type="textarea"`) | `string` | `text` | | | ||
| value | 输入框内容 | `string` | - | | | ||
|
||
## Events 事件 | ||
|
||
| 事件 | 说明 | 类型 | | ||
| ---------- | ------------------ | ----------------------------------------------------------- | | ||
| input | 输入事件 | `(value: CustomEvent<string>) => void` | | ||
| change | 输入改变事件 | `ChangeEventHandler<HTMLInputElement> \| undefined \| null` | | ||
| blur | 失去焦点事件 | `FocusEventHandler<T> \| undefined \| null` | | ||
| focus | 获取焦点事件 | `FocusEventHandler<T> \| undefined \| null` | | ||
| keyup | 键盘抬起事件 | `KeyboardEventHandler<T> \| undefined \| null` | | ||
| keydown | 键盘按下事件 | `KeyboardEventHandler<T> \| undefined \| null` | | ||
| keypress | 键盘按下并松开事件 | `KeyboardEventHandler<T> \| undefined \| null` | | ||
| mouseenter | 鼠标移入事件 | `MouseEventHandler<T> \| undefined \| null` | | ||
| mouseleave | 鼠标移出事件 | `MouseEventHandler<T> \| undefined \| null` | | ||
| mousemove | 鼠标移动事件 | `MouseEventHandler<T> \| undefined \| null` | | ||
|
||
## Slots 插槽 | ||
|
||
| 插槽名 | 说明 | | ||
| ----------- | ----------------------------- | | ||
| addonBefore | 带标签的`input`,设置前置标签 | | ||
| addonAfter | 带标签的`input`,设置后置标签 | | ||
| prefix | 带有前缀图标的`input` | | ||
| suffix | 带有后缀图标的`input` | | ||
|
||
## Input.Search Props 属性 | ||
|
||
| 属性 | 说明 | 类型 | 默认值 | 版本 | | ||
| ----------- | -------------------------------- | --------- | ------- | ---- | | ||
| enterButton | 是否有确认按钮,可设为按钮文字。 | `boolean` | `false` | | | ||
| loading | 搜索 loading | `boolean` | `false` | | | ||
|
||
其余属性和`Input`一致。 | ||
|
||
## Events 事件 | ||
|
||
| 事件 | 说明 | 类型 | | ||
| ------ | -------------------------------- | -------------------------------------- | | ||
| search | 点击搜索图标或按下回车键时的回调 | `(value: CustomEvent<string>) => void` | | ||
|
||
其余事件和`Input`一致。 | ||
|
||
## Slots 插槽 | ||
|
||
除了没有`addonAfter`插槽,其他的和`Input`一致。 | ||
|
||
## Input.Password Props 属性 | ||
|
||
| 属性 | 说明 | 类型 | 默认值 | 版本 | | ||
| ------- | ------------ | --------- | ------- | ---- | | ||
| visible | 是否显示密码 | `boolean` | `false` | | | ||
|
||
其余属性和`Input`一致。 | ||
|
||
## Events 事件 | ||
|
||
| 事件 | 说明 | 类型 | | ||
| ------------- | -------------- | --------------------------------------- | | ||
| visibleChange | 显隐密码的回调 | `(value: CustomEvent<boolean>) => void` | | ||
|
||
其余事件和`Input`一致。 | ||
|
||
## Slots 插槽 | ||
|
||
除了没有`suffix`插槽,其他的和`Input`一致。 | ||
|
||
## Input.TextArea Props 属性 | ||
|
||
| 属性 | 说明 | 类型 | 默认值 | 版本 | | ||
| ------------ | ------------------------ | ------------------ | ------- | ---- | | ||
| allowClear | 可以点击清除图标删除内容 | `boolean` | `false` | | | ||
| bordered | 是否有边框 | `boolean` | `true` | | | ||
| defaultValue | 输入框默认内容 | `string` | - | | | ||
| disabled | 设置按是否禁用状态 | `boolean` | `false` | | ||
| maxLength | 最大长度 | `number` | - | | | ||
| showCount | 是否展示字数 | `boolean` | `false` | | | ||
| status | 设置校验状态 | `error \| warning` | - | | | ||
| value | 输入框内容 | `string` | - | | | ||
|
||
## Events 事件 | ||
|
||
事件和`Input`一致。 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
<script> | ||
import { Icon, InputNumber, Space } from 'adorn-ui' | ||
</script> | ||
|
||
<Space direction="vertical" style="width: 100%;"> | ||
<InputNumber placeholder="请输入" size="small"> | ||
<span slot="addonBefore">http://</span> | ||
</InputNumber> | ||
<InputNumber placeholder="请输入" size="small"> | ||
<Icon slot="addonAfter" name="search" /> | ||
</InputNumber> | ||
<InputNumber placeholder="请输入" size="small"> | ||
<span slot="addonBefore">http://</span> | ||
<Icon slot="addonAfter" name="search" /> | ||
</InputNumber> | ||
<InputNumber placeholder="请输入" size="middle"> | ||
<span slot="addonBefore">http://</span> | ||
<Icon slot="addonAfter" name="search" /> | ||
</InputNumber> | ||
<InputNumber placeholder="请输入" size="large"> | ||
<span slot="addonBefore">http://</span> | ||
<Icon slot="addonAfter" name="search" /> | ||
</InputNumber> | ||
</Space> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
<script> | ||
import { InputNumber } from 'adorn-ui' | ||
let value = 1 | ||
</script> | ||
|
||
<InputNumber placeholder="0.0" bind:value min={1} max={10} /> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
<script> | ||
import { InputNumber } from 'adorn-ui' | ||
</script> | ||
|
||
<InputNumber bordered={false} /> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
<script> | ||
import { InputNumber } from 'adorn-ui' | ||
</script> | ||
|
||
<InputNumber placeholder="0.0" disabled defaultValue={1} /> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
<script> | ||
import { InputNumber } from 'adorn-ui' | ||
let value = 1000 | ||
$: { | ||
console.log(value) | ||
} | ||
const onInput = e => { | ||
console.log(e) | ||
} | ||
</script> | ||
|
||
<InputNumber | ||
placeholder="0.0" | ||
bind:value | ||
on:input={onInput} | ||
formatter={v => `$ ${v}`.replace(/\B(?=(\d{3})+(?!\d))/g, ',')} | ||
stringMode | ||
/> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
<script> | ||
import { Button, InputNumber, Space } from 'adorn-ui' | ||
let keyboard = false | ||
const onTrigger = () => (keyboard = !keyboard) | ||
</script> | ||
|
||
<Space> | ||
<InputNumber placeholder="0.0" min={1} max={10} {keyboard} /> | ||
<Button on:click={onTrigger}>{keyboard ? '关闭' : '开启'}Keyboard</Button> | ||
</Space> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
<script> | ||
import { InputNumber, Space } from 'adorn-ui' | ||
</script> | ||
|
||
<Space direction="vertical"> | ||
<InputNumber placeholder="0" /> | ||
<InputNumber placeholder="0.0" precision={1} /> | ||
<InputNumber placeholder="0.00" precision={2} /> | ||
</Space> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
<script> | ||
import { InputNumber, Icon } from 'adorn-ui' | ||
</script> | ||
|
||
<InputNumber placeholder="请输入"> | ||
<Icon slot="prefix" name="user" /> | ||
</InputNumber> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
<script> | ||
import { InputNumber, Space } from 'adorn-ui' | ||
</script> | ||
|
||
<Space direction="vertical" style="width: 100%;"> | ||
<InputNumber placeholder="请输入" size="small" /> | ||
<InputNumber placeholder="请输入" size="middle" /> | ||
<InputNumber placeholder="请输入" size="large" /> | ||
</Space> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -79,6 +79,7 @@ | |
}, | ||
"dependencies": { | ||
"@renzp/classes": "^0.0.3", | ||
"@renzp/number-correct": "^0.0.6", | ||
"lodash-es": "^4.17.21" | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.