更新记录

1.3.1(2024-09-09) 下载此版本

  1. 修复一些 bug

1.3.0(2024-09-06) 下载此版本

1.新增 isDisabled 属性

1.2.6(2024-08-01) 下载此版本

  1. 修复选中当前日期时 current 标签展示错误。
查看更多

平台兼容性

uni-app

Vue2 Vue3
?
app-vue app-nvue app-android app-ios
? ? ? ?
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
? ? ? ? ? ? ? ? ?
微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 钉钉小程序 快手小程序 飞书小程序 京东小程序
? ? ? ? ? ? ? ? ?
快应用-华为 快应用-联盟
? ?

uni-app x

app-android app-ios
? ?
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用户还是继续使用 limitStartDatelimitEndDate

事件

事件名 类型 说明
@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

;

如果这个插件有帮助到你,不妨给个好评吧!

你的好评是给作者的最大鼓励🫡

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问