适用场景
datePicker,用于选择日期时间。
使用说明
区域 | 说明 | 示意图 |
内容区 |
250px|700px|reset
例如2024-06-29 17:00转换为时间戳为1719651637700 如果设置「组件值时区」为中国标准时间(UTC+8:00),则2024-06-29 17:00转换为时间戳为1719651600000
如果设置「组件值时区」为中国标准时间(UTC+8:00),则2024-06-29 17:00转换为时间戳为1719651600000 设置「展示时区」为协调世界时(UTC),则组件上会展示为2024-06-29 09:00
250px|700px|reset
| 内容区示意图 250px|700px|reset |
交互区 |
比如,文本输入组件的「form data key」配置为"first_name",表单的data信息中会包含"first_name",并且其值为该文本输入组件的值,可以通过{ { form.data.first_name } }消费该组件的值
示例:{ {self.value === 'test' ? 'error': ''} }
| 250px|700px|reset |
外观区 |
| 250px|700px|reset |
属性 API
属性 | 类型 | 默认值 | 描述 |
label | object | { textContent:"标题", tooltipText:"", wrapping:false, layout:"top", align:"left", width:4, unit:"col" } | 聚合标题相关的属性 聚合标题相关的属性,包含:
|
loading | boolean | false | 是否显示加载中 |
formDataKey | string | 默认为组件id | 值标识 |
disabled | boolean | false | 是否禁用 |
hidden | boolean | false | 是否隐藏 |
readOnly | boolean | false | 是否只读 |
rules | json | {} | 示例 rules:{ required:false, minDate:"2024-01-01", maxDate:"2024-01-02", minTime:"09:00", maxTime:"10:00", custom:"" } |
placeholder | String | 请选择 | 占位符 |
showClear | boolean | true | 是否开启清空按钮 |
dateFormat | String | "YYYY-MM-DD" | 日期格式 |
timeFormat | String | "H:mm" | 时间格式 |
format | String | "YYYY-MM-DD H:mm" | 日期时间格式 |
formattedValue | String | "" | 根据设置的日期和时间格式输入的值 |
suffixIcon | String | "icon_calendar_outlined" | 前缀图标 |
manageTimeZone | boolean | false | 是否开启时区设置 |
displayTimeZone | String | undefined | 展示时区 |
valueTimeZone | String | undefined | 组件值时区 |
step | number | 15 | 分钟步长 |
方法 API
方法 | 说明 |
setValue(value: boolean | string | number | void) | 设置组件值 |
clearValue() | 清空组件值 |
validate() | 触发校验 |
clearValidation() | 清空校验状态 |
reset() | 重置组件值 |
setDisabled(disabled: boolean) | 设置是否禁用 |
setLoading(loading:boolean) | 设置是否加载中 |
setHidden(visible:boolean) | 设置是否隐藏 |
setReadOnly(readOnly:boolean) | 设置是否只读 |