mirror of
https://github.com/Tencent/tmagic-editor.git
synced 2026-05-09 01:58:48 +00:00
3eb8cc0614
补全方法的参数类型、返回值类型与详情说明，规范字段编辑器/字段配置/运行时 API 等文档。 Co-authored-by: Cursor <cursoragent@cursor.com>
49 lines
2.9 KiB
Markdown
49 lines
2.9 KiB
Markdown
# TimeRangePicker 时间范围选择器
|
|
|
|
用于选择或输入时间范围
|
|
|
|
## 基础用法
|
|
|
|
<demo-block type="form" :config="[{
|
|
type: 'timerange',
|
|
name: 'timerange',
|
|
text: '时间范围'
|
|
}]">
|
|
<template #source>
|
|
|
|
<p>
|
|
type为'timerange'
|
|
</p>
|
|
</template>
|
|
</demo-block>
|
|
|
|
## 绑定多个字段
|
|
|
|
可以通过配置 `names` 来将时间范围绑定到两个不同的字段上。
|
|
|
|
<demo-block type="form" :config="[{
|
|
type: 'timerange',
|
|
names: ['startTime', 'endTime'],
|
|
text: '时间范围'
|
|
}]">
|
|
<template #source>
|
|
|
|
<p>
|
|
配置 names 属性，将开始时间和结束时间分别绑定到 startTime 和 endTime 字段。
|
|
</p>
|
|
</template>
|
|
</demo-block>
|
|
|
|
## Attributes
|
|
|
|
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
|
| ----------- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------- |
|
|
| name | 绑定值（数组形式） | string | — | — |
|
|
| names | 绑定值（拆分为两个字段） | string[] | — | — |
|
|
| text | 表单标签 | string | — | — |
|
|
| disabled | 是否禁用 | boolean / [FilterFunction](https://github.com/Tencent/tmagic-editor/blob/cce8b63fc3618b5b811aa33c703de21c22be8a6a/packages/form-schema/src/base.ts#L195) | — | false |
|
|
| format | 显示格式 | string | — | HH:mm:ss |
|
|
| valueFormat | 绑定值的格式 | string | — | HH:mm:ss |
|
|
| defaultTime | 默认时间 | Date[] | — | — |
|
|
| onChange | 值变化时触发的函数 | [OnChangeHandler](https://github.com/Tencent/tmagic-editor/blob/cce8b63fc3618b5b811aa33c703de21c22be8a6a/packages/form-schema/src/base.ts#L30) | — | - |
|