mirror of
https://github.com/Tencent/tmagic-editor.git
synced 2026-05-23 08:53:36 +00:00
873a51fc87
- 升级 vitepress 到 ^2.0.0-alpha.17
- vite.optimizeDeps.rolldownOptions.transform.define 迁移至 vite.define 以适配 v2 API
- 同步升级 vitest/rolldown/vue/vite 等周边依赖
- 文档中类型链接统一改为 <<< 片段引用源码 region，避免 commit hash 链接失效
- packages/{core,editor,form-schema,schema,stage} 相关类型加 // #region 锚点
- 移除已废弃的 docs/guide/advanced/tmagic-ui.md 及侧栏入口
Co-authored-by: Cursor <cursoragent@cursor.com>
71 lines
3.2 KiB
Markdown
71 lines
3.2 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` | — | 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}
|
|
|
|
:::
|