更新记录

1.0.0(2024-12-10) 下载此版本

更新日志

v1.0.0 (2024-12-09)

  • 初始发布
    • 集成 uni-calendar 组件,支持日期选择功能。
    • 添加了 时间段设置 功能,用户可以为每个日期设置多个时间段(包括开始时间和结束时间)。
    • 提供了 放号数量输入 功能,允许用户为每个时间段设置放号数量。
    • 提供 删除时间段 功能,用户可以删除已设置的时间段。
    • 时间段管理抽屉:通过抽屉界面,用户可以选择和管理时间段,并保存更改。
    • 支持日期选择后自动加载对应日期的时间段数据。
    • 支持 只读模式,在只读模式下禁用所有编辑功能。
    • 数据通过 v-model 双向绑定,确保父组件可以获取和更新时间段设置。
    • 默认展示当前日期,用户选择日期后,时间段列表会自动更新。
    • 优化了 UI 样式,提升了用户体验。

平台兼容性

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

hucaofeng-calendar-set 插件使用说明

📖 插件简介

该插件提供日期选择和时间段管理功能,支持为特定日期设置多个时间段及对应的放号数量,适用于日程管理、预约系统等场景。


🛠 使用步骤

🥇 1. 引入插件

在组件中引入插件及其依赖组件:

import HucaofengCalendarSet from "@/components/hucaofeng-calendar-set/hucaofeng-calendar-set.vue";

🥈 2. 在父组件中注册

export default {
  components: {
    HucaofengCalendarSet
  },
  data() {
    return {
      scheduleData: {}, // 放号数据
      timeSlotsArr: [   // 可选时间段列表
        { value: '08:00 - 09:00' },
        { value: '09:00 - 10:00' },
        { value: '10:00 - 11:00' }
      ]
    };
  },
  methods: {
    updateSchedule(newData) {
      console.log('更新后的放号数据:', newData);
      this.scheduleData = newData;
    }
  }
};

🥉 3. 在模板中使用

<hucaofeng-calendar-set
  :value="scheduleData"
  :readonly="false"
  :timeSlotsArr="timeSlotsArr"
  @update="updateSchedule"
/>

📋 属性说明

属性名 类型 默认值 说明
value Object {} 放号数据对象,键为日期,值为时间段数组
readonly Boolean false 是否为只读模式,true 时禁用编辑功能
timeSlotsArr Array [] 时间段选项列表,格式为 [{value: '开始时间 - 结束时间'}]

🎉 事件说明

事件名 参数 说明
update scheduleData: Object 时间段数据发生变化时触发,参数为最新数据

🌟 功能特点

  1. 日期切换:支持通过日历组件选择日期,并根据日期动态展示时间段。
  2. 时间段管理:可选择预定义的时间段并动态更新时间段列表。
  3. 数量设置:每个时间段可设置对应的放号数量。
  4. 实时更新:组件内数据与父组件数据实时同步。
  5. 只读模式:通过设置 readonly 属性可禁用所有编辑功能,适用于展示场景。

🎨 样式自定义

组件内部样式支持通过类名自定义,以下是主要样式类名的作用说明:

类名 作用
container 外层容器样式
calendar 日历组件样式
time-settings 时间段设置区域样式
time-settings-header 时间段设置区域头部样式
time-info 单个时间段显示的样式
selected-date 当前选中日期的文本样式
add-button 添加或保存按钮的样式
time-slot 单个时间段外层容器样式
delete-button 删除按钮的样式
drawer-content 抽屉内容区域的样式
drawer-footer 抽屉底部区域的样式

提示:根据项目需求,您可以覆盖这些类名的样式来定制外观。


🚨 注意事项

  1. timeSlotsArr 的格式要求: 必须为数组,数组的每一项为对象,格式如:{ value: '08:00 - 10:00' }。 确保时间段值格式正确,组件会直接使用这些值进行展示和操作。

  2. 只读模式: 当 readonly 属性设置为 true 时,组件的所有编辑功能(如管理时间段、删除时间段)将被禁用。

  3. 父组件通信value 属性必须是对象格式,键为日期(如 2024-12-10),值为时间段数组,确保格式正确。

  4. 样式覆盖: 样式覆盖可通过局部样式或全局样式实现。避免直接修改组件内部样式代码。

🙋‍♀️ 如有问题请在评论区留言,谢谢!

“代码无忧,开发无惧!” 如果在使用中遇到任何问题,或者有任何改进建议,请随时在评论区留言,我们非常乐意与您沟通交流! 🎈

隐私、权限声明

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

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

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

许可协议

MIT协议

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