---
title: "JQuery Timeline Truck Dispatch Planning Example | Mobiscroll"
component: "Timeline"
framework: "jQuery"
library_version: "6.2.0"
url: "https://demo.mobiscroll.com/jquery/timeline/truck-transport-planning-and-dispatch"
---
# Truck Dispatch Planning - jQuery Timeline demo
Assign transports on the JQuery timeline — hide trucks with capacity or time-window conflicts during drag and snap failed drops to the nearest valid slot.
- [Live demo](https://demo.mobiscroll.com/jquery/timeline/truck-transport-planning-and-dispatch)
- [View code on GitHub](https://github.com/acidb/mobiscroll-demos-jquery/tree/main/src/demos/eventcalendar/timeline/truck-transport-planning-and-dispatch)
- This demo in other frameworks: [JavaScript](https://demo.mobiscroll.com/javascript/timeline/truck-transport-planning-and-dispatch.md), [Angular](https://demo.mobiscroll.com/angular/timeline/truck-transport-planning-and-dispatch.md), [React](https://demo.mobiscroll.com/react/timeline/truck-transport-planning-and-dispatch.md), [Vue](https://demo.mobiscroll.com/vue/timeline/truck-transport-planning-and-dispatch.md)
## Description
Managing a fleet of delivery trucks means constantly matching incoming jobs against available vehicles - checking cargo capacity, time windows, and maintenance schedules, all at once. This demo brings that workflow onto an interactive timeline where dispatchers can drag unscheduled jobs from a sidebar directly onto a truck row without leaving the screen.
To enable external drops from the sidebar, set [`externalDrop`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-externalDrop) to `true` on the timeline, and initialize each job card in the sidebar using the `draggable` component with `dragData` pointing to the full job object.
When the dispatcher starts dragging a job, the [`onEventDragStart`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventDragStart) event fires and drives a real-time resource validation pass: trucks with insufficient cargo capacity or a conflicting scheduled trip are filtered out of the resource list, and the grid is locked outside the job's pickup-to-drop-off window using the [`invalid`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-invalid) option. This gives the dispatcher an immediate visual map of valid drop targets.
A successful drop is confirmed via [`onEventCreated`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventCreated) , which removes the job from the sidebar and marks it as scheduled. If the drop lands in an invalid position, [`onEventCreateFailed`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventCreateFailed) snaps the job to the first free slot within the time window instead of rejecting the drop outright. The same snap logic runs for existing event moves via [`onEventUpdateFailed`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventUpdateFailed). The trucks are grouped into capacity-tier categories and rendered using [`renderResource`](https://mobiscroll.com/docs/jquery/eventcalendar/api#renderer-renderResource), which shows each truck's name, license plate, and a colour-coded maintenance-status dot. Each truck has a parallel "actual" sub-row that tracks live trip progress and is refreshed automatically every 60 seconds.
**Looking for a simpler external drag & drop example?** [Check out the external drag & drop example →](https://demo.mobiscroll.com/jquery/timeline/external-drag-drop-sortable-dragula)
## What this demo shows
- The demo shows a full-page truck dispatch and planning console that combines an unscheduled job queue with a resource timeline.
- **Job queue** The left sidebar lists unscheduled transport jobs in a scrollable queue, grouped by date under sticky day headers such as "Thu, 22 May".
- **Job cards** Each job card shows the pickup and delivery addresses, the pickup-to-drop time window, and the cargo weight in tonnes.
- **Scheduling flow** Jobs disappear from the sidebar after they are successfully assigned to a truck on the timeline.
- **Timeline layout** The main panel uses a timeline Eventcalendar view with trucks shown as resources.
- **Resource details** Each truck row displays the truck name, license plate, and a colour-coded status dot for operational, maintenance planned, or in maintenance states.
- **Resource grouping** Trucks are grouped under collapsible capacity tiers such as 3.5 t, 7 t, 12 t, 20 t, and 24 t.
- **Actual rows** Each truck includes a second, indented actual sub-row rendered in a lighter style for live trip progress.
- **Toolbar** A custom toolbar above the timeline includes a date-range label button, a segmented status filter, zoom controls with minus and plus buttons, and a Now button.
- **Date range selection** The date-range button opens a range picker popup for changing the visible planning window.
- **Status filtering** The segmented control filters the visible events by Scheduled, In Progress, and Completed states.
- **Zooming** The zoom slider changes the timeline across multiple detail levels, from broader 4-hour cells down to finer 15-minute cells.
- **Event styling** Timeline events are colour-coded by status, such as blue for scheduled, orange for in progress, and grey for completed.
- **Event content** Planned events show the route between the pickup and delivery locations together with a Planned badge.
- **Live progress display** In-progress trips on the actual sub-row show a pulsing In progress label.
- **Drag validation** When a job is dragged from the sidebar, trucks that cannot take the job because of capacity limits or time conflicts are hidden from the resource list.
- **Invalid ranges** During drag, invalid time ranges are greyed out so only valid drop targets remain visible on the timeline.
- **Successful drop** Dropping a job onto a valid slot adds it to the timeline and confirms the action with a toast message.
- **Auto-snap behavior** Dropping onto an invalid slot snaps the job to the nearest available valid slot within the allowed window when possible.
- **Failure handling** If no valid slot can be found, the demo shows an error toast instead of placing the job.
- **Actual event details** Clicking an actual-progress event opens a toast with delay and elapsed or arrival information for the transport.
## Best for
- **Truck dispatching** Planning and assigning incoming transport jobs across a fleet of trucks from a single scheduling screen.
- **Logistics operations** Managing deliveries where dispatchers need to balance cargo capacity, time windows, and vehicle availability at the same time.
- **Constraint-based scheduling** Evaluating valid assignments quickly when jobs can only be placed on resources that meet size and timing requirements.
- **Live operations visibility** Showing both the scheduled plan and the actual trip progress in the same timeline view.
- **Large resource sets** Working with bigger fleets where drag-time filtering helps narrow the visible list down to valid trucks only.
## API used in this demo
- [`theme`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-theme) - option
- [`themeVariant`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-themeVariant) - option
- [`cssClass`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-cssClass) - option
- [`setOptions`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-setOptions) - method
- [`resources`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-resources) - option
- [`invalid`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-invalid) - option
- [`data`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-data) - option
- [`refDate`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-refDate) - option
- [`view`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-view) - option
- [`zoomLevel`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-zoomLevel) - option
- [`navigate`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-navigate) - method
- [`getEvents`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-getEvents) - method
- [`min`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-min) - option
- [`updateEvent`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-updateEvent) - method
- [`addEvent`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-addEvent) - method
- [`buttons`](https://mobiscroll.com/docs/jquery/popup/api#opt-buttons) - option
- [`close`](https://mobiscroll.com/docs/jquery/popup/api#method-close) - method
- [`cssClass`](https://mobiscroll.com/docs/jquery/popup/api#opt-cssClass) - option
- [`display`](https://mobiscroll.com/docs/jquery/popup/api#opt-display) - option
- [`focusOnClose`](https://mobiscroll.com/docs/jquery/popup/api#opt-focusOnClose) - option
- [`showOverlay`](https://mobiscroll.com/docs/jquery/popup/api#opt-showOverlay) - option
- [`width`](https://mobiscroll.com/docs/jquery/popup/api#opt-width) - option
- [`setOptions`](https://mobiscroll.com/docs/jquery/popup/api#method-setOptions) - method
- [`anchor`](https://mobiscroll.com/docs/jquery/popup/api#opt-anchor) - option
- [`open`](https://mobiscroll.com/docs/jquery/popup/api#method-open) - method
- [`clickToCreate`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-clickToCreate) - option
- [`dragToCreate`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-dragToCreate) - option
- [`dragToResize`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-dragToResize) - option
- [`dragToMove`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-dragToMove) - option
- [`externalDrop`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-externalDrop) - option
- [`eventOverlap`](https://mobiscroll.com/docs/jquery/eventcalendar/api#opt-eventOverlap) - option
- [`renderResource`](https://mobiscroll.com/docs/jquery/eventcalendar/api#renderer-renderResource) - renderer
- [`renderResourceEmpty`](https://mobiscroll.com/docs/jquery/eventcalendar/api#renderer-renderResourceEmpty) - renderer
- [`renderResourceHeader`](https://mobiscroll.com/docs/jquery/eventcalendar/api#renderer-renderResourceHeader) - renderer
- [`renderTimelineEventContent`](https://mobiscroll.com/docs/jquery/eventcalendar/api#renderer-renderTimelineEventContent) - renderer
- [`onEventCreated`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventCreated) - event
- [`onEventCreateFailed`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventCreateFailed) - event
- [`navigateToEvent`](https://mobiscroll.com/docs/jquery/eventcalendar/api#method-navigateToEvent) - method
- [`onEventUpdateFailed`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventUpdateFailed) - event
- [`onEventDragStart`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventDragStart) - event
- [`onEventDragEnd`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventDragEnd) - event
- [`onEventClick`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onEventClick) - event
- [`onPageLoaded`](https://mobiscroll.com/docs/jquery/eventcalendar/api#event-onPageLoaded) - event
- [`responsive`](https://mobiscroll.com/docs/jquery/popup/api#opt-responsive) - option
- [`touchUi`](https://mobiscroll.com/docs/jquery/popup/api#opt-touchUi) - option
- [`scrollLock`](https://mobiscroll.com/docs/jquery/popup/api#opt-scrollLock) - option
- [`maxWidth`](https://mobiscroll.com/docs/jquery/popup/api#opt-maxWidth) - option
- [`inputElement`](https://mobiscroll.com/docs/jquery/select/api#opt-inputElement) - option
- [`responsive`](https://mobiscroll.com/docs/jquery/select/api#opt-responsive) - option
- [`touchUi`](https://mobiscroll.com/docs/jquery/select/api#opt-touchUi) - option
- [`onChange`](https://mobiscroll.com/docs/jquery/select/api#event-onChange) - event
- [`controls`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-controls) - option
- [`select`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-select) - option
- [`display`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-display) - option
- [`showRangeLabels`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-showRangeLabels) - option
- [`pages`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-pages) - option
- [`startInput`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-startInput) - option
- [`endInput`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-endInput) - option
- [`returnFormat`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-returnFormat) - option
- [`showOnClick`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-showOnClick) - option
- [`showOnFocus`](https://mobiscroll.com/docs/jquery/datepicker/api#opt-showOnFocus) - option
- [`onInit`](https://mobiscroll.com/docs/jquery/datepicker/api#event-onInit) - event
- [`onChange`](https://mobiscroll.com/docs/jquery/datepicker/api#event-onChange) - event
- [`setVal`](https://mobiscroll.com/docs/jquery/select/api#method-setVal) - method
## Code
### JS
```js
mobiscroll.setOptions({
theme: 'ios',
themeVariant: 'light'
});
$(function () {
var myEvents = [
// Resource 1–3 (size <=3.5)
{
resource: 1,
from: '100 Main St, Dallas, TX',
to: '50 Congress Ave, Tulsa, OK',
size: 3,
pickup: ['2026-11-03T08:00', '2026-11-03T10:00'],
drop: ['2026-11-03T12:00', '2026-11-03T14:00'],
status: 'completed',
},
{
resource: 2,
from: '200 Elm St, Fargo, ND',
to: '75 N 3rd St, Bismarck, ND',
size: 2.5,
pickup: ['2026-11-04T09:00', '2026-11-04T11:00'],
drop: ['2026-11-04T13:00', '2026-11-04T15:00'],
status: 'in progress',
},
{
resource: 3,
from: '150 Broadway, Manchester, NH',
to: '50 Kennedy Memorial Dr, Waterville, ME',
size: 3.5,
pickup: ['2026-11-07T07:00', '2026-11-07T09:00'],
drop: ['2026-11-07T12:00', '2026-11-07T14:00'],
status: 'scheduled',
},
{
resource: 1,
from: '50 N Main St, Phoenix, AZ',
to: '200 Broadway Ave, Albuquerque, NM',
size: 3,
pickup: ['2026-11-07T10:00', '2026-11-07T12:00'],
drop: ['2026-11-07T15:00', '2026-11-07T17:00'],
status: 'scheduled',
},
// Resource 4–6 (size <=7)
{
resource: 4,
from: '85 Arch St, Boston, MA',
to: '40 Middle St, Portland, ME',
size: 6.5,
pickup: ['2026-11-03T08:00', '2026-11-03T10:00'],
drop: ['2026-11-03T12:00', '2026-11-03T14:00'],
status: 'completed',
},
{
resource: 5,
from: '300 E Main St, Richmond, VA',
to: '100 S Tryon St, Charlotte, NC',
size: 7,
pickup: ['2026-11-04T05:00', '2026-11-04T07:00'],
drop: ['2026-11-04T10:00', '2026-11-04T12:00'],
status: 'completed',
},
{
resource: 6,
from: '900 W Belmont Ave, Chicago, IL',
to: '300 Market St, St Louis, MO',
size: 6,
pickup: ['2026-11-10T09:00', '2026-11-10T11:00'],
drop: ['2026-11-10T14:00', '2026-11-10T16:00'],
status: 'scheduled',
},
{
resource: 4,
from: '250 King St, Greensboro, NC',
to: '200 Hay St, Fayetteville, NC',
size: 6.5,
pickup: ['2026-11-04T13:00', '2026-11-04T15:00'],
drop: ['2026-11-04T18:00', '2026-11-04T20:00'],
status: 'scheduled',
},
// Resource 7–9 (size <=12)
{
resource: 7,
from: '233 S Wacker Dr, Chicago, IL',
to: '10 Public Square, Cleveland, OH',
size: 11,
pickup: ['2026-11-04T08:00', '2026-11-04T11:00'],
drop: ['2026-11-04T16:00', '2026-11-04T19:00'],
status: 'scheduled',
},
{
resource: 8,
from: '180 S High St, Columbus, OH',
to: '75 E Main St, Lexington, KY',
size: 12,
pickup: ['2026-11-06T07:00', '2026-11-06T10:00'],
drop: ['2026-11-06T15:00', '2026-11-06T18:00'],
status: 'scheduled',
},
{
resource: 9,
from: '100 E Capitol St, Jackson, MS',
to: '250 Riverfront Pkwy, Chattanooga, TN',
size: 10,
pickup: ['2026-11-09T07:00', '2026-11-09T10:00'],
drop: ['2026-11-09T16:00', '2026-11-09T19:00'],
status: 'scheduled',
},
{
resource: 7,
from: '50 Arch St, Boston, MA',
to: '200 Middle St, Portland, ME',
size: 9,
pickup: ['2026-11-10T08:00', '2026-11-10T10:00'],
drop: ['2026-11-10T12:00', '2026-11-10T14:00'],
status: 'scheduled',
},
// Resource 10–12 (size <=20)
{
resource: 10,
from: '50 N 1st Ave, Phoenix, AZ',
to: '200 Broadway Ave, Albuquerque, NM',
size: 20,
pickup: ['2026-11-04T10:00', '2026-11-04T13:00'],
drop: ['2026-11-04T18:00', '2026-11-04T21:00'],
status: 'in progress',
},
{
resource: 11,
from: '120 Broadway, New York, NY',
to: '55 Canal St, New Orleans, LA',
size: 18,
pickup: ['2026-11-07T06:00', '2026-11-07T09:00'],
drop: ['2026-11-07T10:00', '2026-11-07T14:00'],
status: 'scheduled',
},
{
resource: 12,
from: '600 Poydras St, New Orleans, LA',
to: '200 Commerce St, Montgomery, AL',
size: 20,
pickup: ['2026-11-11T06:00', '2026-11-11T09:00'],
drop: ['2026-11-11T14:00', '2026-11-11T17:00'],
status: 'scheduled',
},
{
resource: 10,
from: '120 Main St, Boston, MA',
to: '50 Canal St, New Orleans, LA',
size: 19,
pickup: ['2026-11-05T07:00', '2026-11-05T10:00'],
drop: ['2026-11-05T14:00', '2026-11-05T17:00'],
status: 'scheduled',
},
// Resource 13–15 (size <=24)
{
resource: 13,
from: '100 Main St, Dallas, TX',
to: '15 Broadway St, Denver, CO',
size: 22,
pickup: ['2026-11-04T07:00', '2026-11-04T10:00'],
drop: ['2026-11-05T04:00', '2026-11-05T08:00'],
status: 'scheduled',
},
{
resource: 14,
from: '300 Main St, Houston, TX',
to: '120 W Capitol Ave, Little Rock, AR',
size: 24,
pickup: ['2026-11-06T10:00', '2026-11-06T13:00'],
drop: ['2026-11-06T18:00', '2026-11-06T22:00'],
status: 'scheduled',
},
{
resource: 15,
from: '900 S Flower St, Los Angeles, CA',
to: '300 2nd Ave, Seattle, WA',
size: 23,
pickup: ['2026-11-09T05:00', '2026-11-09T08:00'],
drop: ['2026-11-09T12:00', '2026-11-09T16:00'],
status: 'scheduled',
},
{
resource: 13,
from: '350 S Spring St, Los Angeles, CA',
to: '500 E Rim Rd, El Paso, TX',
size: 24,
pickup: ['2026-11-12T06:00', '2026-11-12T09:00'],
drop: ['2026-11-12T18:00', '2026-11-12T21:00'],
status: 'scheduled',
},
{
resource: 14,
from: '200 Market St, Philadelphia, PA',
to: '400 Washington Ave, Minneapolis, MN',
size: 23,
pickup: ['2026-11-07T13:00', '2026-11-07T16:00'],
drop: ['2026-11-07T20:00', '2026-11-07T23:00'],
status: 'scheduled',
},
{
resource: 15,
from: '500 S Wacker Dr, Chicago, IL',
to: '100 State St, Portland, ME',
size: 24,
pickup: ['2026-11-10T08:00', '2026-11-10T11:00'],
drop: ['2026-11-10T16:00', '2026-11-10T19:00'],
status: 'scheduled',
},
// Extra scheduled events
{
resource: 1,
from: '300 W Madison St, Chicago, IL',
to: '500 Euclid Ave, Cleveland, OH',
size: 3,
pickup: ['2026-11-05T08:00', '2026-11-05T10:00'],
drop: ['2026-11-05T13:00', '2026-11-05T16:00'],
status: 'scheduled',
},
{
resource: 4,
from: '800 N 3rd St, Philadelphia, PA',
to: '200 W Baltimore St, Baltimore, MD',
size: 6.5,
pickup: ['2026-11-06T07:00', '2026-11-06T09:00'],
drop: ['2026-11-06T12:00', '2026-11-06T15:00'],
status: 'scheduled',
},
{
resource: 5,
from: '900 Biscayne Blvd, Miami, FL',
to: '400 N Orange Ave, Orlando, FL',
size: 7,
pickup: ['2026-11-05T09:00', '2026-11-05T11:00'],
drop: ['2026-11-05T14:00', '2026-11-05T18:00'],
status: 'scheduled',
},
{
resource: 7,
from: '100 S 5th St, Minneapolis, MN',
to: '300 W Kellogg Blvd, St Paul, MN',
size: 9,
pickup: ['2026-11-07T08:00', '2026-11-07T10:00'],
drop: ['2026-11-07T14:00', '2026-11-07T17:00'],
status: 'scheduled',
},
{
resource: 8,
from: '500 W 2nd St, Austin, TX',
to: '2200 Post Oak Blvd, Houston, TX',
size: 12,
pickup: ['2026-11-08T07:00', '2026-11-08T10:00'],
drop: ['2026-11-08T15:00', '2026-11-08T18:00'],
status: 'scheduled',
},
{
resource: 11,
from: '600 Grant St, Pittsburgh, PA',
to: '200 W Washington St, Indianapolis, IN',
size: 18,
pickup: ['2026-11-05T06:00', '2026-11-05T09:00'],
drop: ['2026-11-05T16:00', '2026-11-05T20:00'],
status: 'scheduled',
},
{
resource: 14,
from: '400 N Michigan Ave, Chicago, IL',
to: '250 E Wisconsin Ave, Milwaukee, WI',
size: 23,
pickup: ['2026-11-09T08:00', '2026-11-09T11:00'],
drop: ['2026-11-09T15:00', '2026-11-09T18:00'],
status: 'scheduled',
},
{
resource: 13,
from: '700 Figueroa St, Los Angeles, CA',
to: '50 W San Fernando St, San Jose, CA',
size: 22,
pickup: ['2026-11-08T06:00', '2026-11-08T09:00'],
drop: ['2026-11-08T17:00', '2026-11-08T21:00'],
status: 'scheduled',
},
];
var myResources = [
{
id: 'cap1',
name: '3.5 tons capacity',
eventCreation: false,
children: [
{
id: 1,
name: 'Isuzu N-Series N35',
capacity: 3.5,
status: 'operational',
plate: 'AB14 KTP',
},
{
id: '1-actual',
name: '',
capacity: 3.5,
status: 'operational',
plate: 'AB14 KTP',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 2,
name: 'Mercedes-Benz Sprinter 3500',
capacity: 3.5,
status: 'operational',
plate: 'FR19 XDL',
},
{
id: '2-actual',
name: '',
capacity: 3.5,
status: 'operational',
plate: 'FR19 XDL',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 3,
name: 'Ford Transit 350',
capacity: 3.5,
status: 'operational',
plate: 'QN62 RPV',
maintenanceFrom: '2026-11-02T00:00',
maintenanceTo: '2026-11-06T00:00',
},
{
id: '3-actual',
name: '',
capacity: 3.5,
status: 'operational',
plate: 'QN62 RPV',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
maintenanceFrom: '2026-11-02T00:00',
maintenanceTo: '2026-11-06T00:00',
},
],
},
{
id: 'cap2',
name: '7 tons capacity',
eventCreation: false,
children: [
{
id: 4,
name: 'Ford F-650 Super Duty',
capacity: 7,
status: 'operational',
plate: 'GR12 PEV',
},
{
id: '4-actual',
name: '',
capacity: 7,
status: 'operational',
plate: 'GR12 PEV',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 5,
name: 'Isuzu F-Series FTR',
capacity: 7,
status: 'operational',
plate: 'MB27 FTK',
},
{
id: '5-actual',
name: '',
capacity: 7,
status: 'operational',
plate: 'MB27 FTK',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 6,
name: 'Hino 300 Series 716',
capacity: 7,
status: 'operational',
plate: 'KT73 ZLD',
maintenanceFrom: '2026-11-06T00:00',
maintenanceTo: '2026-11-09T00:00',
},
{
id: '6-actual',
name: '',
capacity: 7,
status: 'operational',
plate: 'KT73 ZLD',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
maintenanceFrom: '2026-11-06T00:00',
maintenanceTo: '2026-11-09T00:00',
},
],
},
{
id: 'cap3',
name: '12 tons capacity',
eventCreation: false,
children: [
{
id: 7,
name: 'Hino 500 Series FD',
capacity: 12,
status: 'operational',
plate: 'EP17 GMF',
},
{
id: '7-actual',
name: '',
capacity: 12,
status: 'operational',
plate: 'EP17 GMF',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 8,
name: 'Isuzu F-Series FVR',
capacity: 12,
status: 'operational',
plate: 'DS41 CXP',
},
{
id: '8-actual',
name: '',
capacity: 12,
status: 'operational',
plate: 'DS41 CXP',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 9,
name: 'Mercedes-Benz Atego 1218',
capacity: 12,
status: 'operational',
plate: 'NH65 QWD',
maintenanceFrom: '2026-11-03T00:00',
maintenanceTo: '2026-11-05T00:00',
},
{
id: '9-actual',
name: '',
capacity: 12,
status: 'operational',
plate: 'NH65 QWD',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
maintenanceFrom: '2026-11-03T00:00',
maintenanceTo: '2026-11-05T00:00',
},
],
},
{
id: 'cap4',
name: '20 tons capacity',
eventCreation: false,
children: [
{
id: 10,
name: 'Mercedes Actros 2545',
capacity: 20,
status: 'operational',
plate: 'KT19 LNV',
},
{
id: '10-actual',
name: '',
capacity: 20,
status: 'operational',
plate: 'KT19 LNV',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 11,
name: 'DAF XF 530',
capacity: 20,
status: 'operational',
plate: 'WP64 GBX',
},
{
id: '11-actual',
name: '',
capacity: 20,
status: 'operational',
plate: 'WP64 GBX',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 12,
name: 'Renault T High 520',
capacity: 20,
status: 'operational',
plate: 'CD70 UJE',
maintenanceFrom: '2026-11-08T00:00',
maintenanceTo: '2026-11-11T00:00',
},
{
id: '12-actual',
name: '',
capacity: 20,
status: 'operational',
plate: 'CD70 UJE',
eventCreation: false,
maintenanceFrom: '2026-11-08T00:00',
maintenanceTo: '2026-11-11T00:00',
cssClass: 'mds-dispatch-actual-resource',
},
],
},
{
id: 'cap5',
name: '24 tons capacity',
eventCreation: false,
children: [
{
id: 13,
name: 'Volvo FH16',
capacity: 24,
status: 'operational',
plate: 'BD67 HTA',
},
{
id: '13-actual',
name: '',
capacity: 24,
status: 'operational',
plate: 'BD67 HTA',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 14,
name: 'Freightliner Cascadia',
capacity: 24,
status: 'operational',
plate: 'VA18 RQW',
},
{
id: '14-actual',
name: '',
capacity: 24,
status: 'operational',
plate: 'VA18 RQW',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
{
id: 15,
name: 'Kenworth T680',
capacity: 24,
status: 'operational',
plate: 'HY22 BPL',
},
{
id: '15-actual',
name: '',
capacity: 24,
status: 'operational',
plate: 'HY22 BPL',
eventCreation: false,
cssClass: 'mds-dispatch-actual-resource',
},
],
},
];
var externalEvents = [
// Week 1
{
id: 1,
from: '2000 Q St, Sacramento, CA',
to: '500 Poydras St, New Orleans, LA',
size: 9,
pickup: ['2026-11-04T09:00', '2026-11-04T11:00'],
drop: ['2026-11-04T12:00', '2026-11-04T17:00'],
},
{
id: 2,
from: '100 State St, Madison, WI',
to: '300 S Wacker Dr, Chicago, IL',
size: 22,
pickup: ['2026-11-04T13:00', '2026-11-04T15:00'],
drop: ['2026-11-04T16:00', '2026-11-04T21:00'],
},
{
id: 3,
from: '1500 Market St, Philadelphia, PA',
to: '600 Liberty St, Pittsburgh, PA',
size: 13,
pickup: ['2026-11-04T13:00', '2026-11-04T17:00'],
drop: ['2026-11-04T18:00', '2026-11-04T22:00'],
},
{
id: 25,
from: '350 Fifth Ave, New York, NY',
to: '100 Broad St, Newark, NJ',
size: 3.5,
pickup: ['2026-11-04T14:00', '2026-11-04T16:00'],
drop: ['2026-11-04T18:00', '2026-11-04T21:00'],
},
{
id: 26,
from: '800 Market St, San Francisco, CA',
to: '400 Capitol Mall, Sacramento, CA',
size: 6,
pickup: ['2026-11-04T15:00', '2026-11-04T17:00'],
drop: ['2026-11-04T19:00', '2026-11-04T22:00'],
},
{
id: 4,
from: '1100 Congress Ave, Austin, TX',
to: '500 E Main St, Dallas, TX',
size: 20,
pickup: ['2026-11-05T07:00', '2026-11-05T09:00'],
drop: ['2026-11-05T10:00', '2026-11-05T15:00'],
},
{
id: 5,
from: '200 Peachtree St NW, Atlanta, GA',
to: '50 Music Sq E, Nashville, TN',
size: 8,
pickup: ['2026-11-05T08:00', '2026-11-05T10:00'],
drop: ['2026-11-05T12:00', '2026-11-05T16:00'],
},
{
id: 6,
from: '500 Boylston St, Boston, MA',
to: '200 State St, Portland, ME',
size: 3.5,
pickup: ['2026-11-05T08:30', '2026-11-05T10:30'],
drop: ['2026-11-05T12:30', '2026-11-05T18:30'],
},
{
id: 27,
from: '200 S Lamar Blvd, Austin, TX',
to: '500 Commerce St, Dallas, TX',
size: 19,
pickup: ['2026-11-05T13:00', '2026-11-05T15:00'],
drop: ['2026-11-05T18:00', '2026-11-05T22:00'],
},
{
id: 28,
from: '300 W Colfax Ave, Denver, CO',
to: '100 N Main St, Pueblo, CO',
size: 10,
pickup: ['2026-11-06T10:00', '2026-11-06T12:00'],
drop: ['2026-11-06T14:00', '2026-11-06T18:00'],
},
{
id: 7,
from: '400 S 4th St, Louisville, KY',
to: '1400 Main St, Cincinnati, OH',
size: 7,
pickup: ['2026-11-06T06:00', '2026-11-06T08:00'],
drop: ['2026-11-06T09:00', '2026-11-06T12:00'],
},
{
id: 8,
from: '410 S Houston Ave, Tulsa, OK',
to: '250 W Capitol Ave, Little Rock, AR',
size: 11.5,
pickup: ['2026-11-06T06:30', '2026-11-06T08:30'],
drop: ['2026-11-06T10:30', '2026-11-06T15:30'],
},
{
id: 29,
from: '450 Sutter St, San Francisco, CA',
to: '200 Pine Ave, Long Beach, CA',
size: 22,
pickup: ['2026-11-07T07:00', '2026-11-07T09:00'],
drop: ['2026-11-07T13:00', '2026-11-07T17:00'],
},
{
id: 9,
from: '999 3rd Ave, Seattle, WA',
to: '500 W 8th St, Vancouver, WA',
size: 3,
pickup: ['2026-11-07T09:00', '2026-11-07T11:00'],
drop: ['2026-11-07T12:00', '2026-11-07T17:00'],
},
{
id: 10,
from: '50 S Main St, Salt Lake City, UT',
to: '300 N Broadway, Denver, CO',
size: 5,
pickup: ['2026-11-07T10:00', '2026-11-07T12:00'],
drop: ['2026-11-07T13:00', '2026-11-07T18:00'],
},
// Week 2
{
id: 11,
from: '300 S Grand Ave, Los Angeles, CA',
to: '400 E Van Buren St, Phoenix, AZ',
size: 5,
pickup: ['2026-11-11T08:00', '2026-11-11T10:00'],
drop: ['2026-11-11T13:00', '2026-11-11T18:00'],
},
{
id: 12,
from: '200 W Washington St, Indianapolis, IN',
to: '100 N Main St, Louisville, KY',
size: 18,
pickup: ['2026-11-12T07:00', '2026-11-12T09:00'],
drop: ['2026-11-12T12:00', '2026-11-12T17:00'],
},
{
id: 13,
from: '500 N Michigan Ave, Chicago, IL',
to: '250 Marquette Ave, Minneapolis, MN',
size: 3,
pickup: ['2026-11-13T09:00', '2026-11-13T11:00'],
drop: ['2026-11-13T14:00', '2026-11-13T19:00'],
},
{
id: 14,
from: '600 Congress Ave, Austin, TX',
to: '700 Texas Ave, Houston, TX',
size: 12,
pickup: ['2026-11-14T06:00', '2026-11-14T08:00'],
drop: ['2026-11-14T11:00', '2026-11-14T16:00'],
},
{
id: 15,
from: '100 Broad St, Newark, NJ',
to: '200 S Orange Ave, Orlando, FL',
size: 7,
pickup: ['2026-11-16T10:00', '2026-11-16T12:00'],
drop: ['2026-11-16T15:00', '2026-11-16T20:00'],
},
// Week 3
{
id: 16,
from: '400 Pike St, Seattle, WA',
to: '800 SW Broadway, Portland, OR',
size: 9,
pickup: ['2026-11-18T07:00', '2026-11-18T09:00'],
drop: ['2026-11-18T12:00', '2026-11-18T16:00'],
},
{
id: 17,
from: '300 Main St, Buffalo, NY',
to: '500 Euclid Ave, Cleveland, OH',
size: 22,
pickup: ['2026-11-19T08:00', '2026-11-19T11:00'],
drop: ['2026-11-19T14:00', '2026-11-19T19:00'],
},
{
id: 18,
from: '150 S Miami Ave, Miami, FL',
to: '300 Peachtree St, Atlanta, GA',
size: 6,
pickup: ['2026-11-20T09:00', '2026-11-20T11:00'],
drop: ['2026-11-20T13:00', '2026-11-20T18:00'],
},
{
id: 19,
from: '700 W 3rd St, Kansas City, MO',
to: '400 N Broadway, St Louis, MO',
size: 15,
pickup: ['2026-11-22T06:00', '2026-11-22T08:00'],
drop: ['2026-11-22T10:00', '2026-11-22T15:00'],
},
{
id: 20,
from: '250 E Houston St, San Antonio, TX',
to: '1200 Commerce St, Dallas, TX',
size: 4,
pickup: ['2026-11-23T11:00', '2026-11-23T13:00'],
drop: ['2026-11-23T15:00', '2026-11-23T20:00'],
},
// Week 4
{
id: 21,
from: '800 N Michigan Ave, Chicago, IL',
to: '500 Woodward Ave, Detroit, MI',
size: 11,
pickup: ['2026-11-25T07:00', '2026-11-25T09:00'],
drop: ['2026-11-25T12:00', '2026-11-25T17:00'],
},
{
id: 22,
from: '900 Market St, San Francisco, CA',
to: '600 Wilshire Blvd, Los Angeles, CA',
size: 20,
pickup: ['2026-11-26T08:00', '2026-11-26T10:00'],
drop: ['2026-11-26T14:00', '2026-11-26T19:00'],
},
{
id: 23,
from: '350 5th Ave, New York, NY',
to: '100 Federal St, Boston, MA',
size: 3.5,
pickup: ['2026-11-27T09:00', '2026-11-27T11:00'],
drop: ['2026-11-27T13:00', '2026-11-27T17:00'],
},
{
id: 24,
from: '200 S Tryon St, Charlotte, NC',
to: '100 N Main St, Greenville, SC',
size: 8,
pickup: ['2026-11-29T06:00', '2026-11-29T08:00'],
drop: ['2026-11-29T10:00', '2026-11-29T14:00'],
},
];
var $calendarElm = $('#demo-dispatch-calendar');
var $popupElm = $('#dispatch-filtering-popup');
var $resourceList = $('#dispatch-resource-list');
var scheduledJobIds = [];
var filters = {};
var statusFilters = {
scheduled: true,
'in progress': true,
completed: true,
};
var filteredResources = myResources;
var searchTimeout;
var searchQuery;
var zoomLevel = 3;
var now = new Date();
var today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
var myInvalids = [];
var currentViewStart = today;
var currentViewEnd = new Date(today.getTime() + 7 * 24 * 60 * 60 * 1000);
var maintenanceInvalids = [];
function getActualDates(start, end) {
var possibleOffsets = [-120, -90, -60, -30, -15, 0, 15, 30, 60, 90, 120];
var departureOffset = possibleOffsets[Math.floor(Math.random() * possibleOffsets.length)] * 60000;
var arrivalOffset = possibleOffsets[Math.floor(Math.random() * possibleOffsets.length)] * 60000;
return [new Date(start.getTime() + departureOffset), new Date(end.getTime() + arrivalOffset)];
}
var statusColors = {
scheduled: '#2196f3',
'in progress': '#f97316',
completed: '#78909c',
};
var maintenanceColors = {
'in-maintenance': '#f44336',
'maintenance-planned': '#ff9800',
operational: '#4caf50',
};
var maintenanceLabels = {
'in-maintenance': 'In Maintenance',
'maintenance-planned': 'Maintenance Planned',
operational: 'Operational',
};
function getResourceMaintenanceStatus(resource) {
if (!resource.maintenanceFrom || !resource.maintenanceTo) {
return 'operational';
}
var from = resource.maintenanceFrom;
var to = resource.maintenanceTo;
if (now >= from && now <= to) {
return 'in-maintenance';
}
if (from < currentViewEnd && to > currentViewStart) {
return 'maintenance-planned';
}
return 'operational';
}
function buildMaintenanceInvalids() {
var invalids = [];
myResources.forEach(function (group) {
group.children.forEach(function (resource) {
if (resource.maintenanceFrom && resource.maintenanceTo && !String(resource.id).includes('actual')) {
invalids.push({
start: resource.maintenanceFrom,
end: resource.maintenanceTo,
resource: resource.id,
cssClass: 'mds-dispatch-maintenance-invalid',
});
}
});
});
return invalids;
}
function setupMaintenanceDates() {
myResources.forEach(function (group) {
group.children.forEach(function (resource) {
if (resource.maintenanceFrom) {
resource.maintenanceFrom = new Date(resource.maintenanceFrom);
}
if (resource.maintenanceTo) {
resource.maintenanceTo = new Date(resource.maintenanceTo);
}
});
});
}
function addActualEvents(events) {
for (var i = 0; i < events.length; ++i) {
var event = events[i];
// Convert dates to date objects
event.start = event.start ? new Date(event.start) : event.start;
event.end = event.end ? new Date(event.end) : event.end;
if (event.status === 'actual') continue;
// Derive color from time-relative state, not hardcoded status
if (event.end <= now) {
event.color = statusColors['completed'];
} else if (event.start < now) {
event.color = statusColors['in progress'];
} else {
event.color = statusColors[event.status] || statusColors['scheduled'];
}
event.editable = now < event.start;
if (event.start < now && event.end > now) {
if (!event.actual) {
// Create actual event — clamp actualStart so it never exceeds now
var actualDates = getActualDates(event.start, new Date(event.drop[0]));
var actualStart = actualDates[0] >= event.start && actualDates[0] < now ? actualDates[0] : event.start;
var newEvent = {
resource: event.resource + '-actual',
from: event.from,
to: event.to,
pickup: event.pickup,
drop: event.drop,
size: event.size,
start: actualStart,
end: now,
title: 'In progress',
status: 'actual',
color: event.color,
cssClass: 'mds-dispatch-actual-event mds-dispatch-pulse',
editable: false,
};
event.actual = true;
event.actualRef = newEvent;
events.push(newEvent);
} else if (event.actualRef) {
// Keep actual end in sync with current time on each refresh
event.actualRef.end = now;
}
} else if (event.end <= now) {
if (!event.actual) {
var completedActualDates = getActualDates(event.start, new Date(event.drop[0]));
var completedActualStart =
completedActualDates[0] >= event.start && completedActualDates[0] < event.end ? completedActualDates[0] : event.start;
var completedActualEnd = completedActualDates[1];
var minEnd = new Date(completedActualStart.getTime() + 30 * 60000);
if (completedActualEnd < minEnd) completedActualEnd = minEnd;
var completedNewEvent = {
resource: event.resource + '-actual',
from: event.from,
to: event.to,
pickup: event.pickup,
drop: event.drop,
size: event.size,
start: completedActualStart,
end: completedActualEnd,
title: 'Completed',
status: 'actual',
color: event.color,
cssClass: 'mds-dispatch-actual-event',
editable: false,
};
event.actual = true;
event.actualRef = completedNewEvent;
events.push(completedNewEvent);
} else if (event.actualRef && event.actualRef.title !== 'Completed') {
var transitionDates = getActualDates(event.actualRef.start, new Date(event.drop[0]));
var transitionEnd = transitionDates[1];
var transitionMinEnd = new Date(event.actualRef.start.getTime() + 30 * 60000);
if (transitionEnd < transitionMinEnd) transitionEnd = transitionMinEnd;
event.actualRef.end = transitionEnd;
event.actualRef.color = event.color;
event.actualRef.cssClass = 'mds-dispatch-actual-event';
event.actualRef.title = 'Completed';
}
}
}
}
function refresh() {
now = new Date();
filteredResources = computeFilteredResources();
addActualEvents(myEvents);
setTimeout(function () {
calendar.setOptions({
resources: filteredResources,
invalid: $.merge([], myInvalids).concat(maintenanceInvalids),
data: getStatusFilteredEvents(),
});
});
}
function setEventData(events) {
for (var i = 0; i < events.length; i++) {
var event = events[i];
event.start = event.start ? event.start : event.pickup[0];
event.end = event.end ? event.end : event.drop[0];
event.title = event.from + ' → ' + event.to;
}
}
function getMaxAvailableCapacity() {
var max = 0;
myResources.forEach(function (group) {
if (filters[group.id]) {
group.children.forEach(function (child) {
if (!String(child.id).includes('actual') && child.capacity > max) {
max = child.capacity;
}
});
}
});
return max;
}
function refreshJobList() {
var container = $('#dispatch-events');
container.empty();
var rangeEnd = new Date(currentRangeStart.getTime() + currentRangeDays * 24 * 60 * 60 * 1000);
var minPickup = new Date(now.getTime() + 2 * 60 * 60 * 1000);
var maxCapacity = getMaxAvailableCapacity();
var visibleJobs = externalEvents.filter(function (job) {
if (scheduledJobIds.indexOf(job.id) !== -1) return false;
if (job.size > maxCapacity) return false;
var pickupStart = new Date(job.pickup[0]);
if (pickupStart < minPickup) return false;
return pickupStart >= currentRangeStart && pickupStart < rangeEnd;
});
if (visibleJobs.length === 0) {
container.html(
'
No jobs for this period.
',
);
return;
}
var lastDayKey = null;
for (var i = 0; i < visibleJobs.length; i++) {
var job = visibleJobs[i];
var pickupDate = new Date(job.pickup[0]);
var dayKey = mobiscroll.formatDate('YYYY-MM-DD', pickupDate);
if (dayKey !== lastDayKey) {
container.append('
'
);
},
onEventCreated: function (args) {
if (args.action === 'externalDrop') {
scheduledJobIds.push(args.event.id);
$('#mds-dispatch-event-' + args.event.id).remove();
var scheduledEvent = Object.assign({}, args.event, { status: 'scheduled', color: statusColors['scheduled'] });
calendar.updateEvent(scheduledEvent);
myEvents.push(scheduledEvent);
}
mobiscroll.toast({
message: args.event.from + ' → ' + args.event.to + ' added',
});
},
onEventCreateFailed: function (args) {
var draggedEvent = args.event;
var moved = moveToFirstAvailableSlot(draggedEvent, false);
if (moved) {
if (args.action === 'externalDrop') {
$('#mds-dispatch-event-' + args.event.id).remove();
}
setTimeout(function () {
calendar.navigateToEvent({ start: draggedEvent.start, resource: draggedEvent.resource });
});
mobiscroll.toast({
message: draggedEvent.from + ' → ' + draggedEvent.to + ' added to first available slot',
});
} else {
mobiscroll.toast({
message: 'No available slot found for ' + args.event.from + ' → ' + args.event.to,
});
}
},
onEventUpdateFailed: function (args) {
var draggedEvent = args.event;
var moved = moveToFirstAvailableSlot(draggedEvent, true);
if (moved) {
setTimeout(function () {
calendar.navigateToEvent({ start: draggedEvent.start, resource: draggedEvent.resource });
});
mobiscroll.toast({
message: draggedEvent.from + ' → ' + draggedEvent.to + ' moved to first available slot',
});
} else {
var originalEvent = args.oldEvent;
setTimeout(function () {
calendar.navigateToEvent({ start: originalEvent.start, resource: originalEvent.resource });
});
mobiscroll.toast({
message: 'No available slot found for ' + args.event.from + ' → ' + args.event.to,
});
}
},
onEventDragStart: function (args) {
var resourceToNavigate = invalidateResources(args.event);
if (!args.event.resource) {
if (resourceToNavigate && findFirstSlot(args.event)) {
calendar.navigateToEvent({ start: args.event.start, resource: resourceToNavigate });
} else {
mobiscroll.toast({
message: 'No available slot for: ' + args.event.from + ' → ' + args.event.to,
});
}
}
},
onEventDragEnd: function () {
resetEventCreationFlags();
myInvalids = [];
calendar.setOptions({
resources: filteredResources,
invalid: maintenanceInvalids,
min: null,
});
},
onEventClick: function (args) {
if (args.event.status === 'actual') {
var ev = args.event;
var actualStart = new Date(ev.start);
var scheduledDeparture = new Date(ev.pickup[0]);
var departureDelay = Math.round((actualStart - scheduledDeparture) / 60000);
var msg;
if (ev.title === 'In progress') {
msg =
'Actual transport: departed ' + formatDelay(departureDelay) + ' · running ' + formatDuration(new Date() - actualStart);
} else {
var actualEnd = new Date(ev.end);
var scheduledArrival = new Date(ev.drop[0]);
var arrivalDelay = Math.round((actualEnd - scheduledArrival) / 60000);
msg = 'Actual transport: departed ' + formatDelay(departureDelay) + ' · arrived ' + formatDelay(arrivalDelay);
}
mobiscroll.toast({
message: msg,
duration: 5000,
});
}
},
onPageLoaded: function (args) {
currentViewStart = args.firstDay;
currentViewEnd = args.lastDay;
},
})
.mobiscroll('getInst');
$('#dispatch-zoom-level-slider').on('input', function (ev) {
handleZoom(+ev.target.value);
});
$('#dispatch-zoom-level-in').on('click', function () {
handleZoom(zoomLevel + 1);
});
$('#dispatch-zoom-level-out').on('click', function () {
handleZoom(zoomLevel - 1);
});
setEventData(externalEvents);
var pendingRangeStart = today;
var pendingRangeDays = 7;
var currentRangeStart = today;
var currentRangeDays = 7;
function formatDuration(ms) {
var totalMin = Math.round(ms / 60000);
var h = Math.floor(totalMin / 60);
var m = totalMin % 60;
if (h === 0) return m + ' min';
if (m === 0) return h + ' h';
return h + ' h ' + m + ' min';
}
function formatDelay(minutes) {
if (Math.abs(minutes) < 5) return 'on time';
if (minutes > 0) return minutes + ' min late';
return Math.abs(minutes) + ' min early';
}
function formatRangeLabel(start, days) {
var end = new Date(start.getTime() + (days - 1) * 24 * 60 * 60 * 1000);
return mobiscroll.formatDate('MMM D', start) + ' – ' + mobiscroll.formatDate('MMM D, YYYY', end);
}
function applyPendingRange() {
var dates = rangeCalendar.getVal();
if (dates && dates[0] && dates[1]) {
var rawStart = dates[0];
var rawEnd = dates[1];
currentRangeStart = typeof rawStart === 'string' ? new Date(rawStart + 'T00:00:00') : new Date(rawStart);
var rangeEnd = typeof rawEnd === 'string' ? new Date(rawEnd + 'T00:00:00') : new Date(rawEnd);
currentRangeDays = Math.round((rangeEnd.getTime() - currentRangeStart.getTime()) / (24 * 60 * 60 * 1000)) + 1;
} else {
currentRangeStart = pendingRangeStart;
currentRangeDays = pendingRangeDays;
}
applyDaysRange(currentRangeDays, currentRangeStart);
$('#mds-dispatch-range-label').text(formatRangeLabel(currentRangeStart, currentRangeDays));
refreshJobList();
}
function disableRangeInputs(disable) {
var startInst = mobiscroll.getInst($('#mds-dispatch-range-start')[0]);
var endInst = mobiscroll.getInst($('#mds-dispatch-range-end')[0]);
if (startInst) startInst.setOptions({ disabled: disable });
if (endInst) endInst.setOptions({ disabled: disable });
}
var rangePopup = $('#mds-dispatch-range-popup')
.mobiscroll()
.popup({
responsive: {
xsmall: {
display: 'bottom',
touchUi: true,
buttons: [
{
text: 'Apply',
keyCode: 'enter',
handler: function () {
applyPendingRange();
rangePopup.close();
},
cssClass: 'mbsc-popup-button-primary',
},
'cancel',
],
},
custom: {
breakpoint: 575,
buttons: [],
display: 'anchored',
anchor: document.getElementById('mds-dispatch-range-trigger'),
anchorAlign: 'start',
touchUi: false,
scrollLock: false,
maxWidth: 920,
},
},
})
.mobiscroll('getInst');
var rangeSelectInst = $('#mds-dispatch-range-select')
.mobiscroll()
.select({
inputElement: document.getElementById('mds-dispatch-range-select-input'),
responsive: {
xsmall: { touchUi: true },
small: { touchUi: false },
},
onChange: function (args) {
var val = args.value;
if (val === 'custom') {
disableRangeInputs(false);
} else {
disableRangeInputs(true);
pendingRangeDays = +val;
pendingRangeStart = today;
if (rangeCalendar) {
var end = new Date(today.getTime() + (pendingRangeDays - 1) * 24 * 60 * 60 * 1000);
rangeCalendar.setVal([today, end]);
}
}
},
})
.mobiscroll('getInst');
var rangeCalendar = $('#mds-dispatch-range-calendar')
.mobiscroll()
.datepicker({
controls: ['calendar'],
select: 'range',
display: 'inline',
showRangeLabels: false,
pages: 'auto',
startInput: '#mds-dispatch-range-start',
endInput: '#mds-dispatch-range-end',
returnFormat: 'iso8601',
showOnClick: false,
showOnFocus: false,
onInit: function (event, inst) {
var end = new Date(today.getTime() + 6 * 24 * 60 * 60 * 1000);
inst.setVal([today, end]);
},
onChange: function (event, inst) {
var dates = inst.getVal();
if (dates && dates[0]) {
disableRangeInputs(false);
rangeSelectInst.setVal('custom', true);
if (dates[1]) {
var start = new Date(dates[0]);
var end = new Date(dates[1]);
pendingRangeStart = start;
pendingRangeDays = Math.round((end.getTime() - start.getTime()) / (24 * 60 * 60 * 1000)) + 1;
}
}
},
})
.mobiscroll('getInst');
$('#mds-dispatch-range-trigger').on('click', function () {
rangePopup.open();
});
$('#mds-dispatch-go-live').on('click', function () {
now = new Date();
today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
currentRangeStart = today;
applyDaysRange(currentRangeDays, today);
$('#mds-dispatch-range-label').text(formatRangeLabel(today, currentRangeDays));
calendar.navigateToEvent({ start: now });
refreshJobList();
});
$('#mds-dispatch-range-apply').on('click', function () {
applyPendingRange();
rangePopup.close();
});
$('#mds-dispatch-range-cancel').on('click', function () {
rangePopup.close();
});
disableRangeInputs(true);
$('#mds-dispatch-range-label').text(formatRangeLabel(today, 7));
refreshJobList();
setInterval(refresh, 60000);
});
```
### HTML
```html
Capacity
Operational Status
```
### CSS
```css
.mds-dispatch-calendar .mbsc-calendar-header {
display: none;
}
.mds-dispatch-calendar .mbsc-timeline-resource-header {
height: 100%;
padding: 8px;
box-sizing: border-box;
}
.mds-dispatch-calendar .mbsc-timeline-resource-col {
width: 300px;
}
.mds-dispatch-calendar .mbsc-timeline-resource-title {
height: 100%;
box-sizing: border-box;
}
.mds-dispatch-calendar .mbsc-timeline-row:not(.mds-dispatch-actual-resource):not(.mbsc-timeline-parent) {
height: 60px;
}
.mds-dispatch-calendar .mds-dispatch-actual-resource {
height: 8px;
}
.mbsc-timeline-row:has(+ .mds-dispatch-actual-resource) {
border-bottom: none;
}
.mds-dispatch-actual-resource .mbsc-timeline-event {
height: 10px;
margin-top: -9px;
}
.mds-dispatch-actual-resource .mbsc-timeline-event-background {
margin: 0;
}
.mds-dispatch-calendar .mbsc-timeline-parent {
height: 34px;
}
.mds-dispatch-calendar .mbsc-timeline-parent .mbsc-timeline-invalid {
display: none;
}
.mds-dispatch-calendar .mbsc-timeline-parent .mbsc-timeline-column {
border: 0;
}
.mds-dispatch-calendar .mbsc-timeline-row-gutter {
height: 6px;
}
.mds-dispatch-search .mbsc-textfield-wrapper {
margin: 0;
}
.mds-dispatch-search .mbsc-textfield-wrapper.mbsc-ltr {
margin-right: 8px;
}
.mds-dispatch-search .mbsc-textfield-wrapper.mbsc-rtl {
margin-left: 8px;
}
.mds-dispatch-search .mbsc-textfield-wrapper.mbsc-material {
margin-top: 2px;
}
.mds-dispatch-search .mbsc-textfield {
height: 36px;
padding: 0 8px 0 38px;
}
.mds-dispatch-search .mbsc-textfield-icon {
top: 50%;
left: 8px;
font-size: 20px;
height: 24px;
line-height: 24px;
margin-top: -12px;
}
.mds-dispatch-search .mbsc-button {
margin: 0;
height: 36px;
font-size: 14px;
}
.mds-dispatch-actual-event .mbsc-schedule-event-range,
.mds-dispatch-actual-event .mbsc-schedule-event-bar,
.mds-dispatch-actual-event .mbsc-schedule-event-title,
.mds-dispatch-actual-event .mbsc-schedule-event-time,
.mds-dispatch-actual-event .mbsc-timeline-event-time {
display: none;
}
.mds-dispatch-disabled-row.mbsc-schedule-invalid {
background: rgba(128, 128, 128, 0.2);
}
.mds-dispatch-maintenance-invalid.mbsc-schedule-invalid {
background: repeating-linear-gradient(-45deg, rgba(128,128,128,0.12), rgba(128,128,128,0.12) 11px, rgba(128,128,128,0.28) 11px, rgba(128,128,128,0.28) 22px);
}
.mds-dispatch-pulse:not(.mbsc-schedule-event-hover) .mbsc-timeline-event-background {
box-shadow: 0 0 0 rgba(249, 115, 22, 0.4);
animation: pulse 2s infinite;
}
.mds-dispatch-now-btn.mbsc-ios {
padding-top: 0;
padding-bottom: 0;
}
.mds-dispatch-seg-dot {
content: '';
display: inline-block;
width: 8px;
height: 8px;
border-radius: 50%;
margin-right: 5px;
vertical-align: middle;
}
.mds-dispatch-seg-dot-scheduled {
background: #2196f3;
}
.mds-dispatch-seg-dot-inprogress {
background: #f97316;
}
.mds-dispatch-seg-dot-completed {
background: #78909c;
}
.mbsc-ios-dark .mds-dispatch-custom-header,
.mbsc-material-dark .mds-dispatch-custom-header,
.mbsc-ios-dark .mds-dispatch-wrapper,
.mbsc-material-dark .mds-dispatch-wrapper {
background-color: #000;
}
.mbsc-windows-dark .mds-dispatch-custom-header,
.mbsc-windows-dark .mds-dispatch-wrapper {
background-color: #1f1f1f;
}
.mds-dispatch-range-popup .mbsc-datepicker-inline {
border: none;
border-radius: 20px;
overflow: hidden;
}
.mds-dispatch-range-popup .mbsc-textfield-wrapper-box {
margin-top: 0;
margin-right: 0;
}
.mds-dispatch-range-desktop-btns.mbsc-button-group-justified,
.mds-dispatch-range-desktop-btns.mbsc-button-group-justified button {
margin-bottom: 0;
}
.mds-dispatch-content > .mbsc-row {
height: 100%;
}
.mds-dispatch-calendar.mbsc-eventcalendar .mbsc-calendar-wrapper {
border: none;
}
@media (max-width: 575px) {
.mds-dispatch-range-desktop-btns {
display: none;
}
.mds-dispatch-range-popup .mbsc-textfield-wrapper-box {
margin-left: 0;
}
}
/* --- Demo styles --- */
.mds-dispatch-full-height {
height: 100%;
}
.mds-dispatch-column {
border-left: 1px solid #ccc;
}
.mds-dispatch-wrapper {
overflow: auto;
background-color: #fff;
}
.mds-dispatch-job-day-header {
font-family: -apple-system, Segoe UI, Roboto, sans-serif;
font-size: 11px;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.5px;
color: #6b7280;
padding: 10px 2px 4px;
}
.mds-dispatch-job-day-header:first-child {
padding-top: 2px;
}
.mds-dispatch-jobs {
align-items: center;
gap: 8px;
margin: 4px 0;
padding: 6px 10px;
touch-action: none;
color: #fff;
background-color: #488dc5;
border-radius: 8px;
font-family: -apple-system, Segoe UI, Roboto, sans-serif;
font-size: 12px;
cursor: grab;
}
.mds-dispatch-job-route {
flex: 1 1 0;
min-width: 0;
}
.mds-dispatch-job-stop {
align-items: center;
gap: 6px;
}
.mds-dispatch-job-dot {
flex: 0 0 8px;
width: 8px;
height: 8px;
border-radius: 50%;
border: 2px solid #fff;
}
.mds-dispatch-job-dot-origin {
background: transparent;
}
.mds-dispatch-job-dot-dest {
background: #fff;
}
.mds-dispatch-job-addr {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
line-height: 1.5;
font-weight: bold;
}
.mds-dispatch-job-connector {
width: 2px;
height: 5px;
background: rgba(255, 255, 255, 0.4);
margin-left: 3px;
}
.mds-dispatch-job-meta {
align-items: flex-end;
gap: 3px;
font-size: 11px;
opacity: 0.9;
}
.mds-dispatch-job-size {
background: rgba(255, 255, 255, 0.2);
border-radius: 10px;
padding: 1px 7px;
font-weight: 600;
}
.mds-dispatch-actual-event {
height: 20px;
}
.mds-dispatch-actual-label {
font-size: 9px;
font-weight: 600;
white-space: nowrap;
opacity: 0.9;
line-height: 1;
}
@keyframes pulse {
0% {
box-shadow: 0 0 0 0 rgba(249, 115, 22, 0.4);
}
70% {
box-shadow: 0 0 0 8px rgba(249, 115, 22, 0);
}
100% {
box-shadow: 0 0 0 0 rgba(249, 115, 22, 0);
}
}
.mds-dispatch-event-content-wrapper {
width: 100%;
height: 100%;
align-items: center;
gap: 5px;
overflow: hidden;
}
.mds-dispatch-event-route {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.mds-dispatch-event-planned-badge {
flex-shrink: 100;
min-width: 0;
overflow: hidden;
}
.mds-dispatch-event-planned-badge-text {
font-size: 10px;
padding: 0 5px;
border-radius: 4px;
background: rgba(255, 255, 255, 0.3);
white-space: nowrap;
display: block;
}
.mds-dispatch-search {
height: 100%;
}
.mds-dispatch-name {
font-size: 14px;
font-weight: bold;
margin-bottom: 5px;
}
.mds-dispatch-plate {
border: 1px solid #488dc5;
border-radius: 4px;
margin: 0 5px;
padding: 0 5px;
}
.mds-dispatch-status-dot {
display: inline-block;
width: 10px;
height: 10px;
border-radius: 50%;
margin-right: 5px;
}
.mds-dispatch-status {
font-size: 13px;
font-weight: normal;
}
.mds-dispatch-empty {
height: 100%;
text-align: center;
}
.mds-dispatch-header-right {
align-items: center;
gap: 16px;
margin-left: auto;
}
.mds-dispatch-status-filter.mbsc-ios {
width: 300px;
}
.mds-dispatch-zoom {
align-items: center;
gap: 6px;
}
.mds-dispatch-zoom-slider {
width: 80px;
cursor: pointer;
}
.mds-dispatch-outer {
height: 100%;
}
.mds-dispatch-custom-header {
align-items: center;
flex-shrink: 0;
height: 52px;
padding: 0 12px;
border-bottom: 1px solid #ccc;
gap: 12px;
}
.mds-dispatch-range-label {
font-size: 20px;
font-weight: bold;
}
.mds-dispatch-range-inputs {
flex: 1;
}
.mds-dispatch-content {
flex: 1 1 0;
min-height: 0;
}
```
## Implementation notes
- Use `type: 'day'` with a `size` equal to the active day count, `timeCellStep: 60`, `timeLabelStep: 60`, `eventHeight: 'variable'`, and a `zoomLevels` map (keys 1-5) where each level sets a `columnWidth` (`'xsmall'` through `'xlarge'`) and its own `timeCellStep`/`timeLabelStep` values. Pass the active `zoomLevel` state as a prop to the `Eventcalendar`.
- Define resources as a two-level tree of capacity tier groups (`eventCreation: false`) with truck leaf nodes beneath them. For each truck, add a parallel `{id}-actual` sibling row (`eventCreation: false`, custom `cssClass`) to display live trip progress separately from the plan. Give each truck custom `capacity`, `plate`, and optional `maintenanceFrom`/`maintenanceTo` properties.
- Store each transport job with `from`, `to`, `size`, `pickup: [earliest, latest]`, `drop: [earliest, latest]`, and `status`. Derive `start = pickup[0]`, `end = drop[0]`, and `title` from the route. Keep scheduled events in a `myEventsRef` and unscheduled sidebar jobs in a separate `externalEventsRef`.
- In `addActualEvents`, generate a companion event on the `{id}-actual` row for every in-progress trip (set `end` to `now`, add a pulse CSS class) and every completed trip. Call this function on mount and repeat every 60 seconds in a `setInterval`.
- Render each sidebar job card with a ref-callback to obtain the DOM element, then mount a `Draggable` with `dragData={job}` and `element={elem}`. Filter the sidebar list to jobs within the current date range, whose cargo fits the maximum visible truck capacity, that have not yet been scheduled, and whose pickup is at least 2 hours from now.
- Set `externalDrop={true}`, `dragToMove={true}`, and `eventOverlap={false}` on the `Eventcalendar`. Disable `clickToCreate`, `dragToCreate`, and `dragToResize`.
- In `onEventDragStart`, set `eventCreation: false` on every truck that is over-capacity or has an overlapping scheduled event within the dragged job's `pickup[0]`-`drop[1]` window. Build three `invalid` segments: the period before the pickup window (all resources), the pickup-to-drop window restricted to the invalid truck IDs, and the period after the drop window. Combine these with the static maintenance invalids when setting `calendarInvalid`.
- In `onEventDragEnd`, reset `eventCreation: true` on all trucks, clear the drag-time invalids, and restore `calendarInvalid` to maintenance invalids only.
- In `onEventCreated`, only act when `args.action === 'externalDrop'`: add the job ID to `scheduledJobIdsRef`, apply the scheduled color and status by replacing the event in place in the array bound to `data` (the `Eventcalendar` React ref only exposes `getEvents`/`getInvalids`/`getViewDate`/`navigateToEvent` - it has no `updateEvent`/`addEvent`; JS/jQuery: call `inst.updateEvent()` for the imperative-only equivalent), remove the job from the sidebar list, and show a `Toast`.
- In both `onEventCreateFailed` and `onEventUpdateFailed`, call a shared `findFirstSlot` function that searches within `pickup[0]`-`drop[1]`, advancing past any truck maintenance window. If a slot is found, splice/replace the job into the array bound to `data` (add for create, replace for update) - the React ref exposes no `addEvent`/`updateEvent`; JS/jQuery: call `inst.addEvent()`/`inst.updateEvent()` for the imperative-only equivalent - then call `navigateToEvent` (this method IS available on the React ref) and show a success `Toast`; if none is found, show an error `Toast` (and for `onEventUpdateFailed`, navigate back to the original event position).
- Use `renderTimelineEventContent` (Angular: `timelineEventContentTemplate`, Vue: `#timelineEventContent` slot) to render event bodies: show a route string and a "Planned" badge for scheduled events, a pulsing "In progress" label for actual in-progress events, and `null` for completed actual events. In `onEventClick`, show a `Toast` with departure delay and elapsed or arrival time when the clicked event has `status: 'actual'`.
- Use `renderResource` (Angular: `resourceTemplate`, Vue: `#resource` slot) to display the truck name, license plate, and a color-coded maintenance status dot for leaf nodes (operational/maintenance-planned/in-maintenance). Use `renderResourceHeader` (Angular: `resourceHeaderTemplate`, Vue: `#resourceHeader` slot) for a search `Input` and a Filter `Button`. Use `renderResourceEmpty` (Angular: `resourceEmptyTemplate`, Vue: `#resourceEmpty` slot) for a no-results placeholder with a Reset Filters button.
- Build the toolbar outside the `Eventcalendar` as a custom header div. Include a flat `Button` showing the current date-range label that opens the range `Popup`, a `SegmentedGroup` with `select="multiple"` for filtering by Scheduled/In Progress/Completed status, a native `` flanked by minus and plus `Button` controls for zoom, and a "Now" `Button` that resets `refDate` to today and navigates to the current time.
- Use a `Popup` with a `responsive` config (bottom sheet on mobile, wide anchored popup on desktop) for range selection. Inside, place a `Select` for preset ranges (7/14/30/60/90 days or Custom), a `Datepicker` in range mode, and `Input` fields for custom start and end dates that are disabled unless "Custom" is selected. Apply the selection with an "Apply" button.
- Use a `Popup` anchored to the Filter button for the filter panel. Render two `Checkbox` groups - one for capacity tiers and one for operational status - using a temp filter state: copy active filters on open, commit on Apply, and discard on cancel.
## Run it in your project
1. If not signed up yet, or don't own a license, you can [start a free trial](https://mobiscroll.com/starttrial).
2. Clone the repository:
```
git clone https://github.com/acidb/mobiscroll-demos-jquery.git
```
3. If not installed yet, install the Mobiscroll CLI from NPM:
```
npm install -g @mobiscroll/cli
```
4. Config Mobiscroll - open a terminal window in the root directory and run:
```
mobiscroll config jquery
```
5. Install dependencies - open a terminal window in the root directory and run:
```
npm install
```
6. Run the project:
```
npm run dev
```
On a trial, add `--trial` to the config command: `mobiscroll config jquery --trial`.
Running a demo locally requires a Mobiscroll trial or a license; setup is per framework at https://mobiscroll.com/docs/jquery/getting-started/installation
## Related demos
- Previous: [Drag People onto Events](https://demo.mobiscroll.com/jquery/timeline/drop-assignee-on-event-from-list.md) - Build a team assignment interface on the JQuery Timeline — drag people from an external list onto meetings with conflict validation.
' +
'