DatetimeSelect 日期时间选择控件
专门为配合表单组件c-form而设计,用于扩展c-datetime-picker组件。
使用时需要通过openDatetimePicker事件和c-datetime-picker组件绑定使用,详细用法请看下方示例。
平台
| App | 小程序 | H5 |
|---|---|---|
| √ | √ | √ |
属性
| 属性名 | 类型 | 默认值 | 说明 | 平台 |
|---|---|---|---|---|
| name | String | 标识,事件中返回 | All | |
| modelValue | String,Number,Object | All | ||
| format | String | null | 显示的日期格式化 | All |
| valueFormat | String | null | 值格式化,valueFormat=unix或valueOf时输出时间戳 | All |
| mode | String | datetime | 视图date/datetime/year/month | All |
| max | String,Number,Object | null | 最大时间 | All |
| min | String,Number,Object | null | 最小值时间 | All |
| placeholder | String | 请选择 | 水印 | All |
| placeholderColor | String | c-t-placeholder | 水印颜色 | All |
| title | String,Object | 标题 object请c-text组件的pros | All | |
| rightIcon | String,Boolean | arrow-right | 显示右侧的箭头 | All |
| iconProps | Object | {} | 右侧图标配置 | All |
| calendarProps | Object | {} | calendar配置 | All |
| textProps | Object | {} | 文字配置 参考c-text组件的props | All |
| cClass | String,Array,Object | null | 组件类 | All |
| cStyle | String,Array,Object | null | 组件样式 | All |
| margin | String,Number,Array | null | 外边距 | All |
| padding | String,Number,Array | null | 内边距 | All |
| bgColor | String | null | 背景色,支持c-bg-开头的背景色类 | All |
事件
| 事件名 | 说明 |
|---|---|
| update:modelValue | |
| openDatetimePicker | 传递用于打开datetime-picker的props |
| change | value,res |
| closeDatetimePicker | {name} |
插槽
| 插槽名 | 说明 |
|---|---|
| before | 前置 |
| default | 文本后面,icon图标前面 |
| after | 后置 |
组件依赖
本组件依赖c-datetime-picker组件,使用前请先引入,并通过datetimeSelectMixin进行绑定。
组合式Api:
js
<script setup>
import {useDatetimeSelect} from "../../uni_modules/cook-uni/components/c-datetime-select/datetimeSelectMixin";
const datetimePicker = ref(null);
const onDatetimeOpen = useDatetimeSelect(datetimePicker);
</script>1
2
3
4
5
2
3
4
5
选项式Api:
js
<script>
import datetimeSelectMixin from "../../uni_modules/cook-uni/components/c-datetime-select/datetimeSelectMixin";
export default {
mixins:[datetimeSelectMixin]
}
</script>1
2
3
4
5
6
2
3
4
5
6
绑定组件:
vue
<c-datetime-select @openDatetimePicker="onDatetimeOpen" />1
示例
vue
<template>
<c-form :model="formData">
<c-form-item label="日期" prop="birthday">
<!--使用组件-->
<c-datetime-select v-model="formData.birthday" @openDatetimePicker="onDatetimeOpen" />
</c-form-item>
</c-form>
<!--datetime-picker组件,必须-->
<c-datetime-picker ref="datetimePicker" />
</template>
<script setup>
import {useDatetimeSelect} from "../../uni_modules/cook-uni/components/c-datetime-select/datetimeSelectMixin";
// 绑定datetime-picker组件
const datetimePicker = ref(null);
const onDatetimeOpen = useDatetimeSelect(datetimePicker);
const formData = {
birthday:''
}
</script>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
