在Vue项目中用fullcalendar制作日程表

前言

最近老牌日历插件fullcalendar更新了v4版本，而且添加了Vue支持，所以用最新的fullcalendar v4制作一个完整日历体验一下，效果图：

安装

FullCalendar的功能被分解为“插件”。如果您需要它提供的功能，您只需要包含一个插件。

也就是说，FullCalendar v4所有插件都得单独安装引用。

npm install --save @fullcalendar/vue @fullcalendar/core @fullcalendar/daygrid

引用并初始化

引用、注册FullCalendar组件，得到一个月视图的日历。

<script>
import FullCalendar from '@fullcalendar/vue'
import dayGridPlugin from '@fullcalendar/daygrid'

export default {
  components: {
    FullCalendar
  },
  data() {
    return {
      calendarPlugins: [ dayGridPlugin ]
    }
  }
}

</script>

<template>
  <FullCalendar defaultView="dayGridMonth" :plugins="calendarPlugins" />
</template>

<style lang='less'>
    //用什么插件必须引入相应的样式表，否则不能正常显示
    @import '~@fullcalendar/core/main.css';
    @import '~@fullcalendar/daygrid/main.css';
</style>

功能定制

为了完成复杂功能，需要引用更多插件，插件列表：

https://fullcalendar.io/docs/plugin-index

• 语言设置简体中文

    <FullCalendar locale="zh-cn" />

如果表头加了button的话，button文字要单独做处理，给每个button的英文名称加一个中文的映射，例：

    <FullCalendar
      locale="zh-cn"
      :header="{
        left: 'prev,next today',
        center: 'title',
        right: 'dayGridMonth,timeGridWeek,timeGridDay,listWeek'
      }"
      :buttonText="buttonText" 
      />

  data () {
    return {
      buttonText: {
        today: '今天',
        month: '月',
        week: '周',
        day: '天'
      }
    }
  }

• 动态获取日历事件

当切换月份或者进行其他操作时，需要动态获取events，可以将events的来源设置成一个function，例：

    <FullCalendar
      locale="zh-cn"
      :header="{
        left: 'prev,next today',
        center: 'title',
        right: 'dayGridMonth,timeGridWeek,timeGridDay,listWeek'
        }"
      :buttonText="buttonText"
      :events="getCalendarEvents"
      />

  methods: {
    getCalendarEvents(info, successCallback, failureCallback){
      let events=[
        ...this.calendarEvents,
        {
          title: info.startStr,
          start: info.start.valueOf(),
        }
      ]
      successCallback(events)
    }
  }

参数说明：

successCallback是成功回调，failureCallback是失败回调，info是一个对象，内容如下：

• 点击日历添加事件

想要触发dateClick事件必须先安装引用interaction插件，文档链接：https://fullcalendar.io/docs/dateClick

npm install --save @fullcalendar/interaction

    <FullCalendar @dateClick="handleDateClick" />

    handleDateClick (arg) {
      if (confirm('Would you like to add an event to ' + arg.dateStr + ' ?')) {
        this.calendarEvents.push({ // add new event data
          title: 'New Event',
          start: arg.date,
          allDay: arg.allDay
        })
        this.calendarApi.refetchEvents()
      }
    }

• 点击事件查看详情

    <FullCalendar @eventClick="handleEventClick" />

    handleEventClick (info) {
      alert('Event: ' + info.event.title)
    }

完整例子在我的github项目里，项目地址：https://github.com/inspiration1/asteroid

官方文档：

https://fullcalendar.io/docs/vue

https://fullcalendar.io/docs#toc