FullCalendar插件基本使用--基于vue

另一篇讲的挺详细的:fullCalendar基本使用 ,不过是用原生js写。

fullCalendar插件官网地址

我将补充基于vue的使用,以及一些未提到的用法:
安装引用以及基本使用,见官网如下地址

fullCalendar基于vue

使用
1、大体效果选择
选择自己想要的大体效果,可在整体效果里查看,自己想要拖拽、编辑事件、点击等效果,查看对应模块的效果实现。demo地址

2、Api选择
全部api都会在这里显示:所有api

3、使用
HTML

<template>
  <div class="container">
    <div @click="backToday">返回今天</div>
    <FullCalendar
      class="demo-app-calendar"
      ref="fullCalendar" // 做标记,以方便在事件中取用插件中的方法
      :plugins="calendarPlugins" // 引入的插件,比如fullcalendar/daygrid,fullcalendar/timegrid引入后才可显示月,周,日
      :slotEventOverlap="false"  // 事件时间重合时,是否覆盖
      defaultView="dayGridMonth" // 默认视图,设为dayGridMonth,月日程
      locale="zh-cn" // 切换语言,当前为中文
      :timeGridEventMinHeight="20" //设置事件的最小高度
      :allDaySlot="false" // 周,日视图时,all-day 不显示
      :eventLimit="true" //设置月日程,与all-day slot的最大显示数量,超过的通过弹窗显示
      :eventLimitText="eventLimitText" //设置超过事件时的“更多”字样提示,点击后显示弹窗,eventLimitText可设置字样
      :nowIndicator="true" // 当前是否有红线标识
      height="parent" 
      :views="eventLimitNum" // 在views中设置事件显示数量
      :displayEventEnd="false" // 是否显示事件结束时间
      :slotLabelFormat="{ // 周,日视图时,左侧的显示的时间格式,以下为:00:00,00:30...5:30
        hour: 'numeric',
        minute: '2-digit',
        omitZeroMinute: false,
        meridiem: 'short',
        hour12: false
      }"
      :displayEventTime="false" //是否显示时间时间
      :header="{ // 顶部按钮,以及他们的排列顺序
                  left:'today',
                  center: 'prev,title,next',
                  right: 'dayGridMonth,timeGridWeek,timeGridDay,listWeek'
              }"
      :buttonText="{ // 顶部按钮的文字显示
          today: '回到今天',
          month: '月',
          week: '周',
          day: '日'
        }"
      :columnHeaderText="columnHeaderText" // 表格的表头显示字样,默认为sun,mon,tue.... 中文则显示:周日,周一,周二....
      :events="calendarEventsNew" // 存放数据的入口(面板中显示的事件,一般我们创建或者获取到的事件,按规定格式放入,即可显示在面板中)
      @datesRender="datesRender" // 日期渲染时,触发的事件,默认传入info,一个包含view和el的对象
      :selectable="true" //是否支持选择
      @eventPositioned="eventPositioned" //事件被放置在日历的最终位置后触发。可在此调整事件的存放位置
      @eventClick="eventClick" // 事件被点击时触发
      @eventMouseEnter="eventMouseEnter" // 划入事件时触发
    />

  </div>
</template>


引入

import FullCalendar from '@fullcalendar/vue'
import dayGridPlugin from '@fullcalendar/daygrid'
import timeGridPlugin from '@fullcalendar/timegrid'
import interactionPlugin from '@fullcalendar/interaction'

JS

export default {
  components: { FullCalendar }, // 引入后注册
  data() {
    return {
      calendarPlugins: [// 插件引入后在此声明后,才可使用
        // plugins must be defined in the JS
        dayGridPlugin,
        timeGridPlugin,
        interactionPlugin // needed for dateClick
      ],
      eventLimitNum: {
        // 事件显示数量限制
        dayGrid: {
          eventLimit: 6
        },
        timeGrid: {
          eventLimit: 2 // adjust to 6 only for timeGridWeek/timeGridDay
        }
      },
      columnHeaderText: function(date) {
        let day = date.getDay()
        let map = {
          0: '周日',
          1: '周一',
          2: '周二',
          3: '周三',
          4: '周四',
          5: '周五',
          6: '周六'
        }
        return map[day]
      },
      calendarEvents: [
        // 面板中的事件
      ]
    }
  },
 methods: {
    eventPositioned(info) {
         console.log('事件被放置在日历的最终位置后触发')
     },
     eventLimitText() {
      return '更多,或者其他字样'
    },
    datesRender(info) {
      console.log('当呈现一组新的日期时触发。')
    },
    eventMouseEnter({ el, event }) { //可从info中解构我们需要的东西
      console.log('划入事件时触发。')
    },
   // ...
   // 获取插件中的方法,比如回到今天的today()方法,下面的为自定义的
   backToday() {
      let calendarApi = this.$refs.fullCalendar.getApi() //通过getApi()方法获取
      calendarApi.today()  //调用回到今天的today()方法
    },

 }
}

CSS
需要引入相应的css文件

<style lang='scss'>

@import '~@fullcalendar/core/main.css';
@import '~@fullcalendar/timeline/main.css';
@import '~@fullcalendar/resource-timeline/main.css';

</style>

4、踩坑

事件hover效果: eventMouseEnter
eventMouseLeave,在vue中,配合使用时,划入日程event中,会同时触发eventMouseEnter与eventMouseLeave,而且会多次重复,经查看是因为在eventMouseEnter与eventMouseLeave改变了数据(然而就是要通过触发它来改变数据 的【手动白眼】),用原生js则不会出现这个问题。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,922评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,591评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,546评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,467评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,553评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,580评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,588评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,334评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,780评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,092评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,270评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,925评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,573评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,194评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,437评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,154评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,127评论 2 352