mirror of
https://github.com/Tencent/tmagic-editor.git
synced 2026-05-13 12:04:08 +00:00
3eb8cc0614
补全方法的参数类型、返回值类型与详情说明，规范字段编辑器/字段配置/运行时 API 等文档。 Co-authored-by: Cursor <cursoragent@cursor.com>
67 lines
3.4 KiB
Markdown
67 lines
3.4 KiB
Markdown
# InputNumber 计数器
|
||
|
||
仅允许输入标准的数字值，可定义范围
|
||
|
||
## 基础用法
|
||
|
||
<demo-block type="form" :config="[{
|
||
type: 'number',
|
||
name: 'number',
|
||
text: '计数器'
|
||
}]">
|
||
<template #source>
|
||
|
||
<p>
|
||
type为'number'
|
||
</p>
|
||
</template>
|
||
</demo-block>
|
||
|
||
## 禁用状态
|
||
|
||
<demo-block type="form" :config="[{
|
||
type: 'number',
|
||
name: 'number',
|
||
text: '计数器',
|
||
disabled: () => true
|
||
}]">
|
||
<template #source>
|
||
|
||
<p>
|
||
disabled 属性接受一个 Boolean，设置为 true 即可禁用整个组件，也可以接受一个返回 Boolean 的函数，如果你只需要控制数值在某一范围内，可以设置 min 属性和 max 属性，不设置 min 和 max 时，最小值为 0。
|
||
</p>
|
||
</template>
|
||
</demo-block>
|
||
|
||
## 步数
|
||
|
||
允许定义递增递减的步数控制
|
||
|
||
<demo-block type="form" :config="[{
|
||
type: 'number',
|
||
name: 'number',
|
||
text: '计数器',
|
||
step: 10
|
||
}]">
|
||
<template #source>
|
||
|
||
<p>
|
||
设置 step 属性可以控制步长，接受一个 Number 。
|
||
</p>
|
||
</template>
|
||
</demo-block>
|
||
|
||
## Attributes
|
||
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
| ----------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------- |
|
||
| name | 绑定值 | string | — | — |
|
||
| text | 表单标签 | string | — | — |
|
||
| placeholder | 输入框占位文本 | string | — | — |
|
||
| disabled | 是否禁用 | boolean / [FilterFunction](https://github.com/Tencent/tmagic-editor/blob/cce8b63fc3618b5b811aa33c703de21c22be8a6a/packages/form-schema/src/base.ts#L195) | — | false |
|
||
| min | 设置计数器允许的最小值 | number | — | -Infinity |
|
||
| max | 设置计数器允许的最大值 | number | — | Infinity |
|
||
| step | 计数器步长 | number | — | 1 |
|
||
| tooltip | 输入框提示信息 | string | — | — |
|
||
| onChange | 值变化时触发的函数 | [OnChangeHandler](https://github.com/Tencent/tmagic-editor/blob/cce8b63fc3618b5b811aa33c703de21c22be8a6a/packages/form-schema/src/base.ts#L30) | — | - |
|