# 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` | —      | false    |
| format      | 显示格式                 | string                                                                                                                                                   | —      | HH:mm:ss |
| valueFormat | 绑定值的格式             | string                                                                                                                                                   | —      | HH:mm:ss |
| defaultTime | 默认时间                 | Date[]                                                                                                                                                   | —      | —        |
| onChange    | 值变化时触发的函数       | `OnChangeHandler`           | —      | -        |

::: details 查看 FilterFunction / OnChangeHandler 及关联类型定义
<<< @/../packages/form-schema/src/base.ts#FilterFunction{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandler{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandlerData{ts}

<<< @/../packages/form-schema/src/base.ts#ChangeRecord{ts}

<<< @/../packages/form-schema/src/base.ts#FormValue{ts}
:::


## 配置类型

::: details 查看 TimerangeConfig 配置类型定义
<<< @/../packages/form-schema/src/base.ts#TimerangeConfig{ts}

<<< @/../packages/form-schema/src/base.ts#FormItem{ts}

:::
