更新记录

1.2.5(2024-03-20)

  1. 修复切换是否为范围选择器,是否为多选时原数据未清除的bug

1.2.4(2024-03-13)

  1. 修复默认值为长度为2的null数组时报错的问题
  2. 优化区间选择器返回的终点值为选择器类型的end值

1.2.3(2024-03-12)

  1. 修复底部弹出框弹出时的卡顿感
查看更多

平台兼容性

Vue2 Vue3
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;

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

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

隐私、权限声明

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

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

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

许可协议

MIT协议

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