Click here to Skip to main content
15,072,134 members
Articles / Web Development / HTML
Article
Posted 24 Feb 2014

Stats

635.6K views
1.4K downloads
357 bookmarked

HTML5 Event Calendar/Scheduler

Rate me:
Please Sign up or sign in to vote.
4.93/5 (122 votes)
1 Jun 2021Apache6 min read
Weekly HTML5 event calendar with CSS themes, drag and drop support, date navigator. PHP and ASP.NET MVC REST API backends.
In this article, we will build a simple HTML5 event calendar web application. The client-side (HTML5/JavaScript) part is universal. We will use sample PHP and ASP.NET Core backends. This article will look at: changing the calendar date using a date picker (on the left side), drag and drop event creating, moving and resizing, changing the look in a single click using a CSS theme, PHP backend, and ASP.NET Core backend (REST API).

HTML5 Event Calendar/Scheduler (Open-Source)

In this article, we will build a simple HTML5 event calendar web application. The client-side (HTML5/JavaScript) part is universal. We will use sample PHP and ASP.NET MVC backends.

Features:

  • Weekly HTML5 event calendar/scheduler
  • Changing the calendar using a date navigator (on the left side)
  • Drag and drop event creating, moving and resizing
  • Changing the look in a single click using a CSS theme
  • PHP REST backend
  • ASP.NET Core REST backend

We will use DayPilot Lite for JavaScript [javascript.daypilot.org] to build the event calendar. DayPilot Lite for JavaScript is open-source - available under Apache License 2.0.

Scheduler CSS Themes

DayPilot Lite for JavaScript comes with several pre-built CSS themes.

You can create your own theme using the online CSS theme designer [themes.daypilot.org].

Default CSS Theme

HTML5 Event Calendar - Default CSS Theme

Green CSS Theme

HTML5 Event Calendar - Green CSS Theme

Google-Like CSS Theme

HTML5 Event Calendar - Google-Like CSS Theme

Traditional CSS Theme

HTML5 Scheduler - Traditional CSS Theme

Transparent CSS Theme

HTML5 Scheduler - Transparent CSS Theme

White CSS Theme

HTML5 Scheduler - White CSS Theme

Step 1: Event Calendar JavaScript Library

Include daypilot-all.min.js. No other dependencies are required for the basic look (the default CSS theme is embedded).

HTML
<script src="js/daypilot/daypilot-all.min.js" type="text/javascript"></script> 

Step 2: Event Calendar Placeholder

Add a placeholder <div> to the HTML5 page:

HTML
<div id="dp"></div> 

Step 3: Initialize the Scheduler

Initialize the scheduler using Daypilot.Calendar class:

HTML
<script type="text/javascript">
  const dp = new DayPilot.Calendar("dp");
  dp.viewType = "Week";
  dp.init();
</script>

These simple steps will render an empty scheduler:

HTML5 Event Calendar (Empty)

Step 4: Load Data

We will load the data to the event calendar using a simple AJAX call:

JavaScript
function loadEvents() {
  DayPilot.Http.ajax({
    url: "backend_events.php?start=" + dp.visibleStart() + 
         "&end=" + dp.visibleEnd(),   // in .NET, use "/api/CalendarEvents"
    success: function(data) {
        dp.events.list = data;
        dp.update();
    }
  });
}

Since version 2018.2.232, you can also use a built-in shortcut method to load events:

JavaScript
function loadEvents() {
  dp.events.load("backend_events.php"); // in .NET, use "api/CalendarEvents"
}

We will detect the currently-visible date range using visibleStart() and visibleEnd() methods and send it to backend_events.php as parameters.

The backend_event.php endpoint returns the calendar event data in the following format:

JavaScript
[
  {
    "id":"1",
    "text":"Calendar Event 1",
    "start":"2022-02-25T10:30:00",
    "end":"2022-02-25T16:30:00"
  },
  {
    "id":"2",
    "text":"Calendar Event 2",
    "start":"2022-02-24T09:00:00",
    "end":"2022-02-24T14:30:00"
  },
  {
    "id":"3",
    "text":"Calendar Event 3",
    "start":"2022-02-27T12:00:00",
    "end":"2022-02-27T16:00:00"
  }
]

PHP backend (backend_events.php):

PHP
<?php
require_once '_db.php';
    
$stmt = $db->prepare('SELECT * FROM events WHERE NOT ((end <= :start) OR (start >= :end))');

$stmt->bindParam(':start', $_GET['start']);
$stmt->bindParam(':end', $_GET['end']);

$stmt->execute();
$result = $stmt->fetchAll();

class Event {}
$events = array();

foreach($result as $row) {
  $e = new Event();
  $e->id = $row['id'];
  $e->text = $row['name'];
  $e->start = $row['start'];
  $e->end = $row['end'];
  $events[] = $e;
}

echo json_encode($events);

?>

ASP.NET Core backend (CalendarEventsController.cs):

C#
// GET: api/CalendarEvents
[HttpGet]
public async Task<ActionResult<IEnumerable<CalendarEvent>>> 
       GetEvents([FromQuery] DateTime start, [FromQuery] DateTime end)
{
    return await _context.Events
        .Where(e => !((e.End <= start) || (e.Start >= end)))
        .ToListAsync();
} 

Read more about loading the calendar event data [doc.daypilot.org].

Step 5: Event Moving

HTML5 Event Calendar - Drag and Drop Moving

The drag and drop user actions (selecting a time range, event moving, event resizing) are enabled by default in the scheduler.

We just need to add custom handler to submit the changes to the server side using an AJAX call.

JavaScript event handler (for PHP):

JavaScript
dp.onEventMoved = args => {
  DayPilot.Http.ajax({
    url: "backend_move.php",
    data: {
      id: args.e.data.id,
      newStart: args.newStart,
      newEnd: args.newEnd
    },
    success: function () {
      console.log("Event was moved.");
    }
  });
};

PHP backend (backend_move.php):

PHP
<?php

require_once '_db.php';

$json = file_get_contents('php://input');
$params = json_decode($json);

$insert = "UPDATE events SET start = :start, end = :end WHERE id = :id";

$stmt = $db->prepare($insert);

$stmt->bindParam(':start', $params->newStart);
$stmt->bindParam(':end', $params->newEnd);
$stmt->bindParam(':id', $params->id);

$stmt->execute();

class Result {}

$response = new Result();
$response->result = 'OK';
$response->message = 'Update was successful';

header('Content-Type: application/json');
echo json_encode($response);

JavaScript event handler (for ASP.NET Core):

JavaScript
dp.onEventMoved = args => {
    DayPilot.Http.ajax({
        url: "/api/CalendarEvents/" + args.e.id(),
        method: "PUT",
        data: {
            id: args.e.data.id,
            start: args.newStart,
            end: args.newEnd,
            text: args.e.data.text
        },
        success: function () {
            console.log("Event was Resized.");
        }
    });
};

ASP.NET Core backend (CalendarEventsController.cs):

C#
// PUT: api/CalendarEvents/5
[HttpPut("{id}")]
public async Task<IActionResult> PutCalendarEvent(int id, CalendarEvent calendarEvent)
{
    if (id != calendarEvent.Id)
    {
        return BadRequest();
    }

    _context.Entry(calendarEvent).State = EntityState.Modified;

    try
    {
        await _context.SaveChangesAsync();
    }
    catch (DbUpdateConcurrencyException)
    {
        if (!CalendarEventExists(id))
        {
            return NotFound();
        }
        else
        {
            throw;
        }
    }

    return NoContent();
} 

Read more about drag and drop event moving [doc.daypilot.org].

Step 6: Event Editing

Image 10

You can use DayPilot Modal dialog to edit the events details. DayPilot Modal is an open-source library for building modal forms from code (online Modal Dialog Builder application for visual modal dialog design is also available).

First, we add an onEventClick event handler that is fired when users click an existing event.

Our modal dialog will have just a single form field (text value called "Name"):

JavaScript
const form = [
  {name: "Name", id: "text"}
];

Now we can open the modal dialog using DayPilot.Modal.form() method. The second parameter specifies the source data object. The data object will be used to fill the initial values (the id value of the form item specifies the property/field of the data object).

The DayPilot.Modal.form() method returns a promise. That means we can use the await syntax to wait for the result and simplify the code:

JavaScript
const modal = await DayPilot.Modal.form(form, args.e.data);
if (modal.canceled) {
  return;
}

The result is available as modal.result object. It's a copy of the original object, with the updated values applied.

This is our onEventClick event handler:

JavaScript
dp.onEventClick = async args => {
  const form = [
    {name: "Name", id: "text"}
  ];

  const modal = await DayPilot.Modal.form(form, args.e.data);
  if (modal.canceled) {
    return;
  }

  DayPilot.Http.ajax({
    url: "backend_update.php",  
    // use `url: "/api/CalendarEvents/" + args.e.id(),` in ASP.NET Core
    // use `method: "PUT",` in ASP.NET Core
    data: {
      id: args.e.id(),
      text: modal.result.text
    },
    success: () => {
      dp.events.update({
        ...args.e.data,
        text: modal.result.text
      });
      console.log("Updated.");
    }
  });
};

PHP backend (backend_update.php)

PHP
<?php
require_once '_db.php';

$json = file_get_contents('php://input');
$params = json_decode($json);

$insert = "UPDATE events SET name = :text WHERE id = :id";

$stmt = $db->prepare($insert);

$stmt->bindParam(':text', $params->text);

$stmt->execute();

class Result {}

$response = new Result();
$response->result = 'OK';
$response->message = 'Update successful';

header('Content-Type: application/json');
echo json_encode($response);

Step 7: Apply the CSS Theme

HTML5 Event Calendar - CSS Theme

If you want to use a custom CSS theme, you need to include the stylesheet:

HTML
<link type="text/css" rel="stylesheet" href="themes/calendar_transparent.css" /> 

And set the theme property during initialization:

HTML
<script type="text/javascript">
  const dp = new DayPilot.Calendar("dp");
  dp.viewType = "Week";
  dp.theme = "calendar_transparent";
  dp.init();
</script> 

You can choose one of the included CSS themes or you can create your own using the online CSS theme designer.

Monthly Event Calendar

HTML5 Monthly Event Calendar

DayPilot also includes a monthly event calendar view. The API of the monthly view control uses the same design as the daily/weekly calendar:

HTML
<div id="dp"></div>

<script type="text/javascript">
  const dp = new DayPilot.Month("dp");
  dp.startDate = "2021-01-01";
  dp.init();
</script>

Event Calendar Localization

HTML5 Event Calendar Localization

You can switch the event calendar locale easily using .locale property:

HTML
<script type="text/javascript">
  const dp = new DayPilot.Calendar("dp");
  dp.locale = "de-de";
  dp.init();
</script>  

The calendar includes built-in support for the following locales:

  • ca-es
  • cs-cz
  • da-dk
  • de-at
  • de-ch
  • de-de
  • de-lu
  • en-au
  • en-ca
  • en-gb
  • en-us
  • es-es
  • es-mx
  • eu-es
  • fi-fi
  • fr-be
  • fr-ch
  • fr-fr
  • fr-lu
  • gl-es
  • it-it
  • it-ch
  • ja-jp
  • nb-no
  • nl-nl
  • nl-be
  • nn-no
  • pt-br
  • pl-pl
  • pt-pt
  • ru-ru
  • sk-sk
  • sv-se
  • zh-cn

You can also create and register your own locale:

JavaScript
DayPilot.Locale.register(
  new DayPilot.Locale('en-us', 
  {
    'dayNames':['Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday'],
    'dayNamesShort':['Su','Mo','Tu','We','Th','Fr','Sa'],
    'monthNames':['January','February','March','April','May',
                  'June','July','August','September','October','November','December'],
    'monthNamesShort':['Jan','Feb','Mar','Apr','May','Jun',
                       'Jul','Aug','Sep','Oct','Nov','Dec'],
    'timePattern':'h:mm tt',
    'datePattern':'M/d/yyyy',
    'dateTimePattern':'M/d/yyyy h:mm tt',
    'timeFormat':'Clock12Hours',
    'weekStarts':0
  }
)); 

Changing the Scheduler Date

Image 14

You can use the DayPilot.Navigator control (on the left side in the screenshot above) to change the scheduler dates (the visible week):

HTML
<div id="nav"></div>

<script type="text/javascript">
  const nav = new DayPilot.Navigator("nav");
  nav.showMonths = 3;
  nav.skipMonths = 3;
  nav.selectMode = "week";
  nav.onTimeRangeSelected = args => {
      dp.startDate = args.day;
      dp.update();
      loadEvents();
  };
  nav.init();
</script>

Duration Bar

HTML5 event calendar with duration bar support

Version 1.1 of the DayPilot Lite HTML5 event calendar supports a duration bar (an indicator of real calendar event duration on the left side of the event). It is enabled by default and you can style it using the CSS theme.

Event Customization (HTML, CSS)

HTML5 Event Calendar Customization

Since version 1.3 SP3, DayPilot Lite supports event customization using onBeforeEventRender event handler:

HTML
<div id="dp"></div>

<script type="text/javascript">

    const dp = new DayPilot.Calendar("dp");

    // view
    dp.startDate = "2016-06-06";
    dp.viewType = "Week";
    dp.durationBarVisible = false;

    dp.events.list = [
        {
            "start": "2016-06-07T10:00:00",
            "end": "2016-06-07T13:00:00",
            "id": "29b7a553-d44f-8f2c-11e1-a7d5f62eb123",
            "text": "Event 3",
            "backColor": "#B6D7A8",
            "borderColor": "#6AA84F"
        },
        {
            "start": "2016-06-07T14:00:00",
            "end": "2016-06-07T17:00:00",
            "id": "ff968cfb-eba1-8dc1-7396-7f0d4f465c8a",
            "text": "Event 4",
            "backColor": "#EA9999",
            "borderColor": "#CC0000",
            "tags": {
                "type": "important"
            }
        }
    ];

    dp.onBeforeEventRender = args => {
        if (args.data.tags && args.data.tags.type === "important"){
            args.data.html = "<b>Important Event</b><br>" + args.data.text;
            args.data.fontColor = "#fff";
            args.data.backColor = "#E06666";
        }
    };

    dp.init();


</script>

You can use it to customize the following properties:

  • backColor
  • barBackColor
  • barColor
  • barHidden
  • borderColor
  • cssClass
  • fontColor
  • html
  • toolTip

Demo:

Monthly Calendar Event Customization

HTML5 Monthly Event Calendar Customization

Event customization support was added to the monthly calendar control in DayPilot Lite for JavaScript 1.3 SP4.

DayPilot Month supports customization of the following event properties:

  • backColor
  • borderColor
  • cssClass
  • fontColor
  • html
  • toolTip

Demo:

Example:

HTML
<div id="dp"></div>

<script type="text/javascript">
    const dp = new DayPilot.Month("dp");

    // ...
    
    dp.events.list = [
        {
            "start": "2021-03-03T00:00:00",
            "end": "2021-03-03T12:00:00",
            "id": "5a8376d2-8e3d-9739-d5d9-c1fba6ec02f9",
            "text": "Event 3"
        },
        {
            "start": "2021-02-25T00:00:00",
            "end": "2021-02-27T12:00:00",
            "id": "1fa34626-113a-ccb7-6a38-308e6cbe571e",
            "text": "Event 4",
            "tags": {
                "type": "important"
            }
        },
        // ...
    ];

    dp.onBeforeEventRender = args => {
        var type = args.data.tags && args.data.tags.type;
        switch (type) {
            case "important":
                args.data.fontColor = "#fff";
                args.data.backColor = "#E06666";
                args.data.borderColor = "#E06666";
                break;
            // ...
        }
    };

    dp.init();

</script>

AngularJS Plugin

Since version 1.2, DayPilot Lite includes an AngularJS Event Calendar plugin that allows using the event calendar in AngularJS.

See also AngularJS Event Calendar Tutorial [code.daypilot.org].

jQuery Plugin

DayPilot includes a jQuery event calendar plugin that allows initialization of the calendar using jQuery API.

See Also

History

License

This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0

Share

About the Author

Dan Letecky
Czech Republic Czech Republic

Comments and Discussions

 
QuestionMessage Closed Pin
12-Sep-21 17:05
Memberacmatrix12-Sep-21 17:05 
QuestionCan be configured to have more than one resource? Pin
Toutsaint24-Jul-19 12:36
MemberToutsaint24-Jul-19 12:36 
QuestionColliding events Pin
Member 1447118426-May-19 9:24
MemberMember 1447118426-May-19 9:24 
QuestionRecurring events? RRULE? Pin
21Junipers19-Jun-18 12:06
Member21Junipers19-Jun-18 12:06 
QuestionIs it free and can use commercial product Pin
Mou_kol27-Feb-18 20:54
MemberMou_kol27-Feb-18 20:54 
AnswerRe: Is it free and can use commercial product Pin
Dan Letecky18-Jun-18 4:45
MemberDan Letecky18-Jun-18 4:45 
QuestionOverlapping Events? Pin
Connie DeCinko15-Dec-16 4:28
MemberConnie DeCinko15-Dec-16 4:28 
QuestionOverlapping Events? Pin
Connie DeCinko15-Dec-16 4:28
MemberConnie DeCinko15-Dec-16 4:28 
Questioncanendar does not show if I change index.cshtml Pin
petercli17-Sep-16 4:53
Memberpetercli17-Sep-16 4:53 
GeneralCalendar/Scheduler event coding system Pin
Member 1270290925-Aug-16 0:25
MemberMember 1270290925-Aug-16 0:25 
QuestionJuste thanks for sharing Pin
JulienduWeb9-Jun-16 3:12
MemberJulienduWeb9-Jun-16 3:12 
AnswerRe: Juste thanks for sharing Pin
Dan Letecky9-Jun-16 21:17
MemberDan Letecky9-Jun-16 21:17 
QuestionRead only mode available Pin
Member 412512527-Apr-16 20:22
MemberMember 412512527-Apr-16 20:22 
AnswerRe: Read only mode available Pin
Dan Letecky29-Apr-16 4:13
MemberDan Letecky29-Apr-16 4:13 
GeneralMy vote of 5 Pin
csharpbd26-Apr-16 10:39
professionalcsharpbd26-Apr-16 10:39 
GeneralRe: My vote of 5 Pin
Dan Letecky26-Apr-16 10:46
MemberDan Letecky26-Apr-16 10:46 
GeneralMy vote of 5 Pin
JH645-Nov-15 2:21
MemberJH645-Nov-15 2:21 
GeneralRe: My vote of 5 Pin
Dan Letecky5-Nov-15 2:31
MemberDan Letecky5-Nov-15 2:31 
QuestionMy Vote of 5 Pin
Robert Marck4-Nov-15 4:08
MemberRobert Marck4-Nov-15 4:08 
AnswerRe: My Vote of 5 Pin
Dan Letecky4-Nov-15 9:27
MemberDan Letecky4-Nov-15 9:27 
QuestionLocalization and header format Pin
Member 1047687316-Oct-15 7:28
MemberMember 1047687316-Oct-15 7:28 
AnswerRe: Localization and header format Pin
Dan Letecky2-Nov-15 4:56
MemberDan Letecky2-Nov-15 4:56 
QuestionMy vote of 5 Pin
Gloold4-Oct-15 22:12
MemberGloold4-Oct-15 22:12 
AnswerRe: My vote of 5 Pin
Dan Letecky2-Nov-15 4:59
MemberDan Letecky2-Nov-15 4:59 
QuestionDayPilot Calendar cannot Update clientState If i Navigate... Pin
Victor Ebe21-May-15 6:12
MemberVictor Ebe21-May-15 6:12 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.