更新记录

1.0.0(2025-01-04) 下载此版本

日期周选择


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
× × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
×

jia-weekPicker 周选择器组件

一个用于选择指定年月中某一周的 uni-app 组件。支持设置可选日期范围、自定义主题色等功能。

特性

  • 按周选择日期
  • 支持自定义可选日期范围
  • 自定义主题色
  • 流畅的切换动画
  • 周一作为每周的第一天
  • 支持自定义标题和按钮文本

安装方法

在 uni-app 插件市场中搜索 jia-weekPicker 并导入到项目中。

基础用法

<template>
  <view>
    <button @click="openPicker">打开周选择器</button>
    <jia-weekPicker
      ref="weekPicker"
      :value="selectedDate"
      @change="handleWeekChange"
    />
  </view>
</template>
<script>
export default {
  data() {
    return {
      selectedDate: "2024-03-18", // 默认选中日期
    };
  },
  methods: {
    openPicker() {
      this.$refs.weekPicker.open();
    },
    handleWeekChange(week) {
      console.log("选中的周:", week);
      // week 结构如下:
      // {
      // startDate: '2024-03-18', // 周开始日期
      // endDate: '2024-03-24', // 周结束日期
      // timestamp: 1711209600000, // 结束日期的时间戳
      // weekNumber: 3 // 当月第几周
      // }
    },
  },
};
</script>

API

Props

属性名 类型 默认值 说明
value String 当前日期 选中周的初始值,格式为 'YYYY-MM-DD'
minDate String 当前日期前 6 个月 可选的最小日期,格式为 'YYYY-MM-DD'
maxDate String 当前日期 可选的最大日期,格式为 'YYYY-MM-DD'
themeColor String '#14af6f' 主题颜色
title String '请选择周期' 选择器标题
confirmText String '确定' 确认按钮文本
cancelText String '取消' 取消按钮文本

Events

事件名 说明 回调参数
change 选择周期后触发 week: { startDate, endDate, timestamp, weekNumber }

Methods

方法名 说明 参数
open 打开周选择器 -

week 对象结构


startDate: String, // 周开始日期,格式:YYYY-MM-DD
endDate: String, // 周结束日期,格式:YYYY-MM-DD
timestamp: Number, // 结束日期的时间戳
weekNumber: Number // 当月第几周

注意事项

  1. 日期格式必须为 'YYYY-MM-DD'
  2. minDate 不能大于 maxDate
  3. 每周默认以周一为开始日
  4. 组件需要通过 ref 调用 open 方法来显示

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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