小程序日历插件详解

一、小程序日历插件显示甲子

小程序日历插件是一个方便实用的小程序组件，可以用来显示当月的日期、节假日等信息。为了更好的体验，我们需要在小程序日历插件上显示甲子信息。方法如下：

// 在日历组件中加入 lunar calendar 相关的变量
data: {
  calendarConfig: {
    afterCalendarRender: afterCalendarRender,
    defaultDay: "2019-01-01",
    hideHeadOnWeekMode: true,
    showLunarCalendar: true, // 将这个值设为true即可显示甲子信息
    holiday: []
  }
},

当设置好showLunarCalendar为true之后，组件就会显示农历/阴历日期以及其他的详细信息。

二、微信小程序日历插件

对于微信小程序，我们可以使用官方提供的原生组件来实现日历功能。在WXML文件中添加calendar组件即可：

同时，在.js文件中加入相应的变量和函数，如下所示：

// 在 .js 中引入日历组件
import calendar from '../../components/calendar/main';

Page({
  data: {
    calendarConfig: {
      afterCalendarRender: afterCalendarRender, // 渲染后的回调函数
      defaultDay: "2019-01-01", // 默认选中的日期
      hideHeadOnWeekMode: true, // 是否在周模式下隐藏头部默认信息
      showLunarCalendar: true, // 是否显示农历/阴历信息
      holiday: [] // 支持法定节假日、特殊日期等信息的数组
    }
  },
  // 按钮点击事件触发的函数，使日历组件滚动到指定日期
  onTargetDateClick(e) {
    const dateStr = e.currentTarget.dataset.date
    this.selectComponent('#calendar').scrollToDate(dateStr)
  }
})

三、小程序日历插件显示农历

与第一点类似，只需要在日历组件中将showLunarCalendar设为true即可显示农历/阴历日期。

data: {
  calendarConfig: {
    afterCalendarRender: afterCalendarRender,
    defaultDay: "2019-01-01",
    hideHeadOnWeekMode: true,
    showLunarCalendar: true, // 将这个值设为true即可显示农历日期
    holiday: []
  }
},

四、微信小程序日历功能

日历在微信小程序中是常用的功能之一。我们可以使用日历组件来制作日程安排、签到功能等。

例如，我们可以在小程序日历组件中增加预约记录、提醒功能：

// .json 文件中引用日历组件
{
  "usingComponents": {
    "calendar": "/components/calendar/main"
  }
}

// .wxml 文件中添加日历组件

使用bindcalendarclick事件监听日历的点击事件，在事件处理函数中，我们可以为点击的日期添加预约记录、提醒功能。

onCalendarClick: function(e) {
  console.log(e.detail)
  // 添加日历记事功能
},

五、小程序日历组件

我们可以使用小程序自带的日历组件来实现日历功能。在.wxml文件中添加 即可：

与第二点几乎相同，只是这里没有使用自定义组件，而是直接使用了小程序自带的calendar标签。

六、微信小程序日历记事

日历记事功能对于一些在线教育、办公场景非常实用。我们可以在小程序日历组件中加入此功能。步骤如下：

i. 在.wxml文件中加入iconfont图标和文字输入框。

  
   {{
    calendarEventContent
  }}
  
   
    
    取消
    
    确定
  
   

  

ii. 在.js文件中编写函数以实现添加、删除、更新日历记录的功能。

Page({
  // 记录当前选择的日期
  data: {
    // ...
    calendarSelectedDate: ''
  },
  // 日程列表
  dayEventList: [],
  // 日历记事相关函数
  handleAddEvent: function (event) {
    const selectedDate = this.data.calendarSelectedDate;
    if (!selectedDate) { return false }
    this.setData({
      dialogShow: "show"
    });
  },
  handleModalCancel: function () {
    this.setData({
      dialogShow: ""
    });
  },
  handleTextContent: function (event) {
    const val = event.detail.value;
    this.setData({
      calendarEventContent: val
    });
  },
  handleSubmitEvent: async function () {
    const selectedDate = this.data.calendarSelectedDate;

    const eventContent = this.data.calendarEventContent;
    const eventList = this.dayEventList;

    if (!eventContent) { return false }

    for (let i = 0; i < eventList.length; i++) {
      if (eventList[i].date === selectedDate) {
        eventList[i].eventContent = eventContent;
        break;
      }
      if (i === eventList.length - 1) {
        eventList.push({ date: selectedDate, eventContent });
      }
    }
    this.setData({
      dayEventList: eventList,
      dialogShow: ''
    });
  },
})

iii. 在.wxml文件中监听日历组件的点击事件：bindcalendardatechange，并在事件处理函数中获取到当前选择的日期。

iv. 在事件处理函数handleCalendarChange中更新当前选择的日期并获取到该日期上的所有日历记录。

handleCalendarChange: function (event) {
  const currentSelectedDate = util.formatDate(
    new Date(event.detail.currentYear, event.detail.currentMonth - 1, event.detail.currentDay),
    "-"
  )
  this.setData({
    calendarSelectedDate: currentSelectedDate,
  });
  const dayEventList = this.dayEventList;
  let selected = null;
  for (let i = 0; i < dayEventList.length; i++) {
    if (dayEventList[i].date === currentSelectedDate) {
      selected = dayEventList[i].eventContent;
      break;
    } else {
      selected = '';
    }
  }
  this.setData({
    calendarEventContent: selected
  });
},

七、微信小程序日历日期插件

微信小程序也提供了多个日历插件，可以用于选择日期、发布任务等场景。例如，我们使用wux-calendar插件构建一个日程记录：

i. 在.wxml文件中引入插件并设置相关参数。

ii. 在.js文件中编写事件监听函数，获取到选择的日期并进行相应处理。

Page({
  // 日程相关变量
  data: {
    visible: false,
    // 初始化当前时间并格式化
    initial: moment().format("YYYY-MM-DD"),
    format: "YYYY-MM-DD",
    eventContent: ""
  },
  // 选日期的回调
  wuxcalendarchange(e) {
    console.log(e.detail.value);
    
    // 更新选择的日期
    this.setData({
      initial: e.detail.value
    });
    // 调后端接口，将确认的日期和相应内容提交给后端
  }
})

八、小程序日历签到功能

除了日历记录、提醒等功能，小程序日历还可以用于签到应用。

i. 在.wxml文件中添加签到按钮。

签到

ii. 在.js文件中编写handleCheckin函数，调用后端签到接口，实现签到功能。

Page({
  // 日历相关变量
  data: {
    checkInStatus: "unchecked" // 签到状态
  },
  // 点击签到的事件函数
  handleCheckin() {
    // TODO: 调用后端签到接口
    // 成功签到后，将 checkInStatus 设置为 checked，前端显示已签到
    this.setData({
      checkInStatus: "checked"
    });
  }
})

九、日历网小程序

除了微信小程序，我们还可以在其他小程序中查找日历组件。例如，我们使用日历网提供的小程序，可以在其中创建的日历上添加事件、设置多个提醒等功能。

i. 在.js文件中引入日历组件并设置相应参数。

import Calendar from '../../miniprogram_npm/uni-calendar/components/Calendar.vue';

export default {
  components: {
    Calendar
  },
  data() {
    return {
      // 这里添加各种变量，如下所示
      calendarEventList: [
        {
          date: "2021-03-20",
          events: [
            {
              time: "9:00",
              content: "待办事项1",
              remindList: ['8:30', '8:45', '9:45']
            },
            {
              time: "14:00",
              content: "待办事项2",
              remindList: ['13:30', '13:45', '14:45', '15:20']
            },
          ]
        },
        // 其他日期的事件信息
      ],
      isDisableSlide: false,
      isDisableSelect: false
    };
  },
  methods: {
    // 日历组件事件处理函数
    onDayClick: function (data) {
      console.log('点击日期：', data);
    },
    onSlideMonth: function (data) {
      console.log('滑动回调：', data);
    },
  }
}

ii. 在.vue文件中使用日历组件，同时调用相应的事件绑定函数。