更新记录
1.2.5(2024-03-20)
- 修复切换是否为范围选择器,是否为多选时原数据未清除的bug
1.2.4(2024-03-13)
- 修复默认值为长度为2的null数组时报错的问题
- 优化区间选择器返回的终点值为选择器类型的end值
1.2.3(2024-03-12)
- 修复底部弹出框弹出时的卡顿感
查看更多
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
app-vue |
× |
√ |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
× |
√ |
√ |
√ |
使用方法
<template>
<view>
<button @click="open">打开选择器</button>
<KDatePicker v-model="show" type="day" is-range @change="handleChange" formatter="YYYY-MM-DD" />
</view>
</template>
<script setup>
import KDatePicker from '../../components/k-date-picker/KDatePicker.vue'
const show = ref(false)
const date = ref('')
const open = () => {
show.value = true
}
const handleChange = (value) => {
date.value = value
}
</script>
注意 !
本插件原使用Vue3编写,经过语法降级后。作者测试Vue2也可以正常使用,但是您可能会遇到一些兼容性问题,您可以尝试自行解决,如无能为力也可以提在评论区。
属性
属性名 |
类型 |
默认值 |
可选值 |
说明 |
modelValue |
Boolean |
- |
|
控制选择器显示 |
confirmText |
String |
确认 |
|
底部按钮文字 |
title |
String |
请选择 |
|
选择器标题 |
defaultValue |
String|Number|Array |
- |
凡是可被dayjs初始化的值都可传入 |
手动控制选择器选中的值(用于回显等) |
type |
String |
- |
"day" | "month" | "year" |
选择器类型 |
isRange |
Boolean |
false |
|
选择器是否为范围选择器 |
limitStartDate |
Number | String |
- |
凡是可被dayjs初始化的值都可传入 |
限制选择器起始日期(不允许传入Number类型的年份 如:2020 改为 '2020') |
limitEndDate |
Number | String |
- |
凡是可被dayjs初始化的值都可传入 |
限制选择器结束日期(不允许传入Number类型的年份 如:2020 改为 '2020') |
multiple |
Boolean |
false |
|
多选(目前暂不支持多选时间段。) |
formatter |
String |
- |
|
change返回的数据默认为时间戳格式,通过此项配置可以格式化返回的数据。例如 'YYYY-MM-DD' |
事件
事件名 |
类型 |
说明 |
@change |
(value: number| [number,number])=>void |
选择器确认时触发 |
CSS变量
控制插件主题请直接修改CSS变量。
/** 控制提示文字的位置 **/
--bottom-offset: 10%;
/** 控制提示文字的大小 **/
--bottom-font-size: 18rpx;
/** 选中时字体的颜色**/
--seletct--text-color: white;
/** 选中时背景颜色 **/
--seletct--background-color: #005ceeff;
/** 处于区间的字体颜色 **/
--in-range--text-color: #005ceeff;
/** 处于区间的背景颜色 **/
--in-range--background-color: #f2f6fc;
/** 限制的字体颜色 **/
--limit--text-color: #a8abb2;
/** 限制的背景颜色 **/
--limit--background-color: #f5f7fa;
/** current的背景颜色 **/
--current--background-color: #e4edfe;
/** current的字体颜色 **/
--current--text-color: #7994b2;
如果这个插件有帮助到你,不妨给个好评吧!
你的好评是给作者的最大鼓励🫡