更新记录
1.3.1(2024-09-09)
下载此版本
- 修复一些 bug
1.3.0(2024-09-06)
下载此版本
1.新增 isDisabled 属性
1.2.6(2024-08-01)
下载此版本
- 修复选中当前日期时 current 标签展示错误。
查看更多
平台兼容性
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" :is-disabled="isDisabled"
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
}
const isDisabled = (value) => {
return value < new Date().getTime()
}
</script>
注意 !
本插件原使用Vue3编写,经过语法降级后。作者测试Vue2也可以正常使用,但是您可能会遇到一些兼容性问题,您可以尝试自行解决,如无能为力也可以提在评论区。
属性
属性名 |
类型 |
默认值 |
可选值 |
说明 |
modelValue |
Boolean |
- |
|
控制选择器显示 |
confirmText |
String |
确认 |
|
底部按钮文字 |
title |
String |
请选择 |
|
选择器标题 |
defaultValue |
String|Number|Array |
- |
凡是可被dayjs初始化的值都可传入 |
手动控制选择器选中的值(用于回显等) |
type |
String |
- |
"day" | "month" | "year" |
选择器类型 |
range |
Boolean |
false |
|
选择器是否为范围选择器 |
limitStartDate |
Number | String |
- |
凡是可被dayjs初始化的值都可传入 |
限制选择器起始日期(不允许传入Number类型的年份 如:2020 改为 '2020'),vue3用户推荐使用 isDisabled |
limitEndDate |
Number | String |
- |
凡是可被dayjs初始化的值都可传入 |
限制选择器结束日期(不允许传入Number类型的年份 如:2020 改为 '2020'),vue3用户推荐使用 isDisabled |
multiple |
Boolean |
false |
|
多选(目前暂不支持多选时间段。) |
formatter |
String |
- |
|
change返回的数据默认为时间戳格式,通过此项配置可以格式化返回的数据。例如 'YYYY-MM-DD' |
isDisabled |
(value: number)=> boolean |
- |
- |
value 是时间戳,返回ture则不可选择,false 反之。仅限 vue3 可用,因为 uniapp vue2不允许传递 Function,vue2用户还是继续使用 limitStartDate ,limitEndDate |
事件
事件名 |
类型 |
说明 |
@change |
(value: number| [number,number])=>void |
选择器确认时触发 |
CSS变量
控制插件主题请直接修改CSS变量。
/** 控制提示文字的位置 **/
--bottom-offset:
10
%;
/** 控制提示文字的大小 **/
--bottom-font-size:
18
rpx
;
/** 选中时字体的颜色**/
--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
;
如果这个插件有帮助到你,不妨给个好评吧!
你的好评是给作者的最大鼓励🫡