---
title: "Angular Timeline Event Grouping & Bulk Actions Example | Mobiscroll"
component: "Timeline"
framework: "Angular"
library_version: "6.1.5"
url: "https://demo.mobiscroll.com/angular/timeline/event-grouping-bulk-action"
---

# Event Grouping & Bulk Actions - Angular Timeline demo

Group Angular Timeline events into collapsible client/quarter blocks and bulk-drag groups — switch between assignee and work-type views on a full-year layout. For Angular 22 and Ionic 8.

- [Live demo](https://demo.mobiscroll.com/angular/timeline/event-grouping-bulk-action)
- [View code on GitHub](https://github.com/acidb/mobiscroll-demos-angular/tree/main/src/demos/eventcalendar/timeline/event-grouping-bulk-action)
- This demo in other frameworks: [JavaScript](https://demo.mobiscroll.com/javascript/timeline/event-grouping-bulk-action.md), [jQuery](https://demo.mobiscroll.com/jquery/timeline/event-grouping-bulk-action.md), [React](https://demo.mobiscroll.com/react/timeline/event-grouping-bulk-action.md), [Vue](https://demo.mobiscroll.com/vue/timeline/event-grouping-bulk-action.md)

## Description

When managing a large volume of events across multiple clients and time periods, handling items one by one quickly becomes inefficient. Users often need to move entire sets of related tasks together, not individual events. To support this, grouping and bulk interaction are essential.

The starting point is being able to look at the same dataset through different lenses. The demo supports switching between an assignee view, where each row represents a person responsible for the work, and a work type view, where each row represents a task category. A segmented control in the header allows adjusting the time granularity of the timeline while keeping a full year in view, enabling users to switch between quarterly, monthly, or weekly breakdowns. The view selector, grouping toggle, and segmented control are all rendered via the [`headerTemplate`](https://mobiscroll.com/docs/angular/eventcalendar/timeline#template-headerTemplate) option, keeping the controls integrated into the timeline header. The [`resourceTemplate` option](https://mobiscroll.com/docs/angular/eventcalendar/timeline#template-resourceTemplate) adapts the resource column accordingly, displaying employee avatars and job titles in assignee view, and work type color indicators in type view.

Once the right perspective is selected, individual events are not rendered one by one. Using the [`eventTemplate`](https://mobiscroll.com/docs/angular/eventcalendar/timeline#template-eventTemplate) option, related tasks are automatically grouped into consolidated blocks per client and per quarter. These blocks can be expanded to reveal the individual tasks inside, or collapsed to keep the timeline readable at scale.

With grouping in place, bulk interaction becomes natural. An entire grouped block can be dragged along the timeline, moving all underlying events simultaneously. The system calculates the time delta and applies it uniformly to every event in the group. At the same time, individual tasks within a group remain accessible and can be edited through the edit button, which opens a range picker to update the event dates. Because both views are projections of the same event store, a change made in one view is immediately reflected in the other.

## What this demo shows

- A desktop monthly timeline for event grouping and bulk actions, with January to December months arranged horizontally and resources arranged vertically on the left.
- **Header navigation** The year label in the top left opens month navigation, while the blue previous and next arrows and the Today button on the right make it easy to move between months and jump back to the current day.
- **Custom parts of the header** In the header there are three custom options all arranged to the right but before the navigation arrows and today button: a checkable Group by Client/Quarter option, allows related projects to be organized by customer and reporting period. Next to it a dropdown select from which the user can select to show resourses view by ASssignee or View by Type. The last option is a segmented button with which you can change the zoom level of the calendar by default is set to Monthly, but you can change to Quearterly or Weekly.
- **Month view** The fixed strip below the header shows the selected years months from January to December, with the current month highlighted.

## Best for

- **Portfolio management** Reviewing client or portfolio-level work across a full year while keeping individual projects available on demand.
- **Program planning** Coordinating multiple related projects by customer, quarter, assignee, or project type.
- **Enterprise project roadmaps** Showing long-running initiatives with expandable summary rows and detailed project cards in the same timeline.
- **Capital project tracking** Planning installation, maintenance, inspection, upgrade, and repair work across months or quarters.
- **Long-term resource planning** Comparing workload by employee or work category without changing the underlying project data.
- **Bulk schedule adjustments** Moving grouped project work together when related tasks need to shift as a set.

## API used in this demo

- [`theme`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-theme) - option
- [`themeVariant`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-themeVariant) - option
- [`groupBy`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-groupBy) - option
- [`zoomLevel`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-zoomLevel) - option
- [`data`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-data) - option
- [`view`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-view) - option
- [`resources`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-resources) - option
- [`dragToMove`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-dragToMove) - option
- [`dragToResize`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-dragToResize) - option
- [`dragToCreate`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-dragToCreate) - option
- [`clickToCreate`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-clickToCreate) - option
- [`dragBetweenResources`](https://mobiscroll.com/docs/angular/eventcalendar/api#opt-dragBetweenResources) - option
- [`onEventUpdate`](https://mobiscroll.com/docs/angular/eventcalendar/api#event-onEventUpdate) - event
- [`headerTemplate`](https://mobiscroll.com/docs/angular/eventcalendar/api#template-headerTemplate) - template
- [`resourceTemplate`](https://mobiscroll.com/docs/angular/eventcalendar/api#template-resourceTemplate) - template
- [`timelineEventTemplate`](https://mobiscroll.com/docs/angular/eventcalendar/api#template-timelineEventTemplate) - template
- [`theme`](https://mobiscroll.com/docs/angular/forms/checkbox#opt-theme) - option
- [`inputStyle`](https://mobiscroll.com/docs/angular/select/api#opt-inputStyle) - option
- [`display`](https://mobiscroll.com/docs/angular/select/api#opt-display) - option
- [`touchUi`](https://mobiscroll.com/docs/angular/select/api#opt-touchUi) - option
- [`data`](https://mobiscroll.com/docs/angular/select/api#opt-data) - option
- [`onChange`](https://mobiscroll.com/docs/angular/select/api#event-onChange) - event
- [`controls`](https://mobiscroll.com/docs/angular/datepicker/api#opt-controls) - option
- [`select`](https://mobiscroll.com/docs/angular/datepicker/api#opt-select) - option
- [`display`](https://mobiscroll.com/docs/angular/datepicker/api#opt-display) - option
- [`touchUi`](https://mobiscroll.com/docs/angular/datepicker/api#opt-touchUi) - option
- [`showRangeLabels`](https://mobiscroll.com/docs/angular/datepicker/api#opt-showRangeLabels) - option
- [`headerText`](https://mobiscroll.com/docs/angular/datepicker/api#opt-headerText) - option
- [`onChange`](https://mobiscroll.com/docs/angular/datepicker/api#event-onChange) - event

## Code

### Component

```ts
import { CommonModule } from '@angular/common';
import { Component, OnInit, ViewChild } from '@angular/core';
import { FormsModule } from '@angular/forms';
import {
  formatDate,
  MbscCalendarEvent,
  MbscDatepicker,
  MbscEventcalendar,
  MbscEventcalendarView,
  MbscEventUpdateEvent,
  MbscModule,
  Notifications,
  setOptions,
} from '@mobiscroll/angular';

setOptions({
  theme: 'ios',
  themeVariant: 'light'
});

const assigneeResources = [
  {
    id: 1,
    name: 'Sarah Johnson',
    title: 'Senior HVAC Technician',
    color: '#4a7c9e',
    img: 'https://img.mobiscroll.com/demos/f1.png',
  },
  {
    id: 2,
    name: 'Mike Chen',
    title: 'Lead Facilities Engineer',
    color: '#7c6ba1',
    img: 'https://img.mobiscroll.com/demos/m1.png',
  },
  {
    id: 3,
    name: 'Emily Rodriguez',
    title: 'Electrical Systems Specialist',
    color: '#c76b8a',
    img: 'https://img.mobiscroll.com/demos/f2.png',
  },
  {
    id: 4,
    name: 'James Wilson',
    title: 'Master Electrician',
    color: '#5a9d76',
    img: 'https://img.mobiscroll.com/demos/m2.png',
  },
  {
    id: 5,
    name: 'Lisa Anderson',
    title: 'Building Automation Technician',
    color: '#d4a056',
    img: 'https://img.mobiscroll.com/demos/f3.png',
  },
  {
    id: 6,
    name: 'David Kim',
    title: 'HVAC Project Manager',
    color: '#4a9dad',
    img: 'https://img.mobiscroll.com/demos/m3.png',
  },
  {
    id: 7,
    name: 'Maria Garcia',
    title: 'Lighting Systems Specialist',
    color: '#c67e5c',
    img: 'https://img.mobiscroll.com/demos/f4.png',
  },
  {
    id: 8,
    name: 'Robert Taylor',
    title: 'Industrial maintenance Lead',
    color: '#7fa650',
    img: 'https://img.mobiscroll.com/demos/m4.png',
  },
];

const typeResources = [
  {
    id: 'installation',
    name: 'installation',
    color: '#3b5998',
  },
  {
    id: 'maintenance',
    name: 'maintenance',
    color: '#2d7a4f',
  },
  {
    id: 'repair',
    name: 'repair',
    color: '#b8621b',
  },
  {
    id: 'inspection',
    name: 'inspection',
    color: '#6b4fa3',
  },
  {
    id: 'upgrade',
    name: 'upgrade',
    color: '#a03a3a',
  },
];

const defaultEvents = [
  {
    id: 1,
    title: 'Office Tower HVAC System Overhaul',
    start: '2026-01-05T00:00',
    end: '2026-03-15T00:00',
    resource: 1,
    type: 'upgrade',
    clientGroup: 'Enterprise Solutions Group',
  },
  {
    id: 2,
    title: 'Executive Floor Climate Control Installation',
    start: '2026-01-10T00:00',
    end: '2026-03-20T00:00',
    resource: 1,
    type: 'installation',
    clientGroup: 'Enterprise Solutions Group',
  },
  {
    id: 3,
    title: 'Headquarters Heating System Maintenance',
    start: '2026-02-01T00:00',
    end: '2026-03-31T00:00',
    resource: 1,
    type: 'maintenance',
    clientGroup: 'Enterprise Solutions Group',
  },
  {
    id: 4,
    title: 'Building Infrastructure Assessment',
    start: '2026-01-15T00:00',
    end: '2026-03-25T00:00',
    resource: 2,
    type: 'inspection',
    clientGroup: 'Enterprise Solutions Group',
  },
  {
    id: 5,
    title: 'Campus Facilities Modernization',
    start: '2026-02-05T00:00',
    end: '2026-03-31T00:00',
    resource: 2,
    type: 'upgrade',
    clientGroup: 'Enterprise Solutions Group',
  },
  // Showing partial data. Download full source.
];

const selectData = [
  {
    text: 'View by Assignee',
    value: 'assignee',
  },
  {
    text: 'View by Type',
    value: 'type',
  },
];

interface GroupData {
  resource: string | number;
  clientGroup: string;
  year: number;
  period: number;
  events: MbscCalendarEvent[];
}

@Component({
  selector: 'app-root', 
  templateUrl: './app.component.html',
  providers: [Notifications],
  standalone: true,
  imports: [CommonModule, FormsModule, MbscModule],
})
export class AppComponent implements OnInit {
  @ViewChild('calendar', { static: false })
  calendar!: MbscEventcalendar;
  @ViewChild('editDatePickerRef', { static: false })
  editDatePicker!: MbscDatepicker;
  constructor(private notify: Notifications) {}

  rawEvents: MbscCalendarEvent[] = defaultEvents;
  displayEvents: MbscCalendarEvent[] = [];
  groupedEvents: MbscCalendarEvent[] = [];
  myResources: any[] = assigneeResources;

  groupBy = 'assignee';
  groupByClientQuarter = false;
  zoomLevel = 'month';
  editingEventId: number | null = null;
  editEventTitle = '';
  editEventDateRange: Date[] = [];

  assigneeResources = assigneeResources;
  typeResources = typeResources;
  selectData = selectData;
  formatDate = formatDate;

  myView: MbscEventcalendarView = {
    timeline: {
      type: 'year',
      resolutionHorizontal: 'month',
      eventHeight: 'variable',
    },
  };

  ngOnInit(): void {
    this.updateView();
  }

  groupEventsByClientQuarter(events: MbscCalendarEvent[]): MbscCalendarEvent[] {
    const groups = new Map<string, GroupData>();
    const result: MbscCalendarEvent[] = [];

    // Save old collapsed states
    const oldCollapsedStates: Record<string, boolean | undefined> = {};
    this.groupedEvents.forEach((ge: any) => {
      const stateKey = `${ge.resource}-${ge.clientGroup}-${ge.year}-${ge.period}`;
      oldCollapsedStates[stateKey] = ge.collapsed;
    });

    // Group events
    events.forEach((event: any) => {
      const resourceId = this.groupBy === 'assignee' ? event.resource : event.type;
      const eventStart = new Date(event.start as string | number | Date);
      const month = eventStart.getMonth();
      const year = eventStart.getFullYear();
      const period = Math.floor(month / 3);
      const groupKey = `${resourceId}-${event.clientGroup}-${year}-${period}`;

      if (!groups.has(groupKey)) {
        groups.set(groupKey, {
          resource: resourceId,
          clientGroup: event.clientGroup,
          year,
          period,
          events: [],
        });
      }
      groups.get(groupKey)!.events.push(event);
    });

    // Create grouped events
    groups.forEach((groupData, groupKey) => {
      const periodEvents = [...groupData.events].sort((a, b) => (a.start! < b.start! ? -1 : a.start! > b.start! ? 1 : 0));

      const resourceList = this.groupBy === 'assignee' ? assigneeResources : typeResources;
      const color = resourceList.find((r) => r.id === groupData.resource)?.color;
      const eventIds = periodEvents.map((e) => e.id).join('-');
      const earliestStart = periodEvents[0].start;
      const latestEnd = periodEvents.reduce((latest, e) => (e.end! > latest! ? e.end : latest), periodEvents[0].end);
      const newId = `group-${groupKey}-${eventIds}`;
      const stateKey = `${groupData.resource}-${groupData.clientGroup}-${groupData.year}-${groupData.period}`;

      result.push({
        id: newId,
        title: groupData.clientGroup,
        resource: groupData.resource,
        clientGroup: groupData.clientGroup,
        year: groupData.year,
        period: groupData.period,
        start: earliestStart,
        end: latestEnd,
        color,
        count: periodEvents.length,
        originalEvents: periodEvents,
        collapsed: stateKey in oldCollapsedStates ? oldCollapsedStates[stateKey] : true,
      } as any);
    });

    return result;
  }

  prepareEventsForDisplay(events: MbscCalendarEvent[]): MbscCalendarEvent[] {
    return events.map((event: any) => ({
      id: event.id,
      title: event.title,
      start: event.start,
      end: event.end,
      resource: this.groupBy === 'assignee' ? event.resource : event.type,
      type: event.type,
      assignee: event.resource,
      clientGroup: event.clientGroup,
      color: '#f8f9fa',
    }));
  }

  updateView(): void {
    const currentResources = this.groupBy === 'assignee' ? assigneeResources : typeResources;

    if (this.groupByClientQuarter) {
      this.groupedEvents = this.groupEventsByClientQuarter(this.rawEvents);
      this.displayEvents = this.groupedEvents;
    } else {
      this.groupedEvents = [];
      this.displayEvents = this.prepareEventsForDisplay(this.rawEvents);
    }

    this.myResources = currentResources;
    this.myView = {
      timeline: {
        type: 'year',
        resolutionHorizontal: this.zoomLevel as 'quarter' | 'month' | 'week',
        eventHeight: 'variable',
      },
    };
  }

  onZoomLevelChange(): void {
    this.updateView();
  }

  onGroupByChange(event: any): void {
    this.groupBy = event.value;
    this.updateView();
  }

  onGroupByClientQuarterChange(event: any): void {
    this.groupByClientQuarter = event.target.checked;
    this.updateView();
  }

  onEventUpdate(args: MbscEventUpdateEvent): void {
    const updatedEvent = args.event as any;
    const oldEvent = args.oldEvent as any;

    if (!this.groupByClientQuarter) {
      const oldResource = (args.oldEvent as any).resource;
      const newResource = updatedEvent.resource;
      const resourceChanged = oldResource !== newResource;

      this.rawEvents = this.rawEvents.map((e: any) => {
        if (e.id === updatedEvent.id) {
          const update: any = { start: updatedEvent.start, end: updatedEvent.end };
          if (resourceChanged) {
            if (this.groupBy === 'assignee') {
              update.resource = newResource;
            } else {
              update.type = newResource;
            }
          }
          return { ...e, ...update };
        }
        return e;
      });

      if (resourceChanged) {
        let fromName: string;
        let toName: string;
        if (this.groupBy === 'assignee') {
          const fromRes = assigneeResources.find((r) => r.id === oldResource);
          const toRes = assigneeResources.find((r) => r.id === newResource);
          fromName = fromRes ? fromRes.name : String(oldResource);
          toName = toRes ? toRes.name : String(newResource);
        } else {
          fromName = String(oldResource);
          toName = String(newResource);
        }
        this.notify.toast({ message: `"${updatedEvent.title}" moved from ${fromName} to ${toName}.` });
      }
      return;
    }

    // Grouped view
    const newStart = new Date(updatedEvent.start).getTime();
    const newEnd = new Date(updatedEvent.end).getTime();
    const oldStart = new Date(oldEvent.start).getTime();
    const oldEnd = new Date(oldEvent.end).getTime();
    const startDelta = newStart - oldStart;
    const endDelta = newEnd - oldEnd;

    if (startDelta === 0 && endDelta === 0) return;

    const movedGroupedEvent = this.groupedEvents.find((ge: any) => ge.id === oldEvent.id) as any;
    if (!movedGroupedEvent) return;

    const { clientGroup: clientGroupName, resource: resourceId, collapsed: wasCollapsed } = movedGroupedEvent;
    const isMove = startDelta === endDelta;

    let eventsToUpdate: any[];

    if (isMove) {
      eventsToUpdate = movedGroupedEvent.originalEvents.map((originalEvent: any) => ({
        ...originalEvent,
        start: new Date(new Date(originalEvent.start).getTime() + startDelta),
        end: new Date(new Date(originalEvent.end).getTime() + startDelta),
      }));
    } else {
      const oldGroupDuration = oldEnd - oldStart;
      const newGroupDuration = newEnd - newStart;

      eventsToUpdate = movedGroupedEvent.originalEvents.map((originalEvent: any) => {
        const evStart = new Date(originalEvent.start).getTime();
        const evEnd = new Date(originalEvent.end).getTime();
        const relativeStart = oldGroupDuration > 0 ? (evStart - oldStart) / oldGroupDuration : 0;
        const relativeEnd = oldGroupDuration > 0 ? (evEnd - oldStart) / oldGroupDuration : 1;
        const mappedStart = newStart + relativeStart * newGroupDuration;
        const mappedEnd = newStart + relativeEnd * newGroupDuration;
        const childDurationDays = (mappedEnd - mappedStart) / (1000 * 60 * 60 * 24);
        const finalEnd = childDurationDays < 1 ? mappedStart + 1000 * 60 * 60 * 24 : mappedEnd;
        return {
          ...originalEvent,
          start: new Date(mappedStart),
          end: new Date(finalEnd),
        };
      });
    }

    // Sync into rawEvents
    const updatedIds = new Set(eventsToUpdate.map((e: any) => e.id));
    const updatedMap = new Map(eventsToUpdate.map((e: any) => [e.id, e]));

    this.rawEvents = this.rawEvents.map((e: any) => (updatedIds.has(e.id) ? updatedMap.get(e.id)! : e));

    // Rebuild view
    this.updateView();

    // Restore collapsed state
    const newYear = new Date(eventsToUpdate[0].start).getFullYear();
    const newPeriod = Math.floor(new Date(eventsToUpdate[0].start).getMonth() / 3);

    const newGroupedEvent = this.groupedEvents.find(
      (ge: any) => ge.resource === resourceId && ge.clientGroup === clientGroupName && ge.year === newYear && ge.period === newPeriod,
    ) as any;

    if (newGroupedEvent) {
      newGroupedEvent.collapsed = wasCollapsed;
      this.displayEvents = [...this.groupedEvents];
    }

    const actionLabel = isMove ? 'moved' : 'resized';
    this.notify.toast({
      message: `${eventsToUpdate.length} event(s) for ${clientGroupName} have been ${actionLabel}.`,
    });
  }

  toggleGroupCollapse(groupEvent: any): void {
    this.groupedEvents = this.groupedEvents.map((ge: any) => (ge.id === groupEvent.id ? { ...ge, collapsed: !ge.collapsed } : ge));
    this.displayEvents = [...this.groupedEvents];

    setTimeout(() => {
      this.calendar.refresh();
    }, 200);
  }

  getUniqueItems(originalEvents: any[]): { count: number; label: string } {
    const uniqueItems: Record<string, any> = {};

    originalEvents.forEach((ev: any) => {
      if (this.groupBy === 'assignee') {
        const typeObj = typeResources.find((r) => r.id === ev.type);
        if (typeObj) uniqueItems[typeObj.id] = typeObj;
      } else {
        const emp = assigneeResources.find((r) => r.id === ev.resource);
        if (emp) uniqueItems[emp.id] = emp;
      }
    });

    return {
      count: Object.keys(uniqueItems).length,
      label: this.groupBy === 'assignee' ? 'type' : 'employee',
    };
  }

  getDetailInfo(event: any): { detailText: string; typeDotColor?: string; avatarUrl?: string } {
    let detailText = '';
    let typeDotColor: string | undefined;
    let avatarUrl: string | undefined;

    if (this.groupBy === 'assignee') {
      const typeObj = typeResources.find((t) => t.id === event.type);
      if (typeObj) {
        detailText = typeObj.name;
        typeDotColor = typeObj.color;
      }
    } else {
      const employee = assigneeResources.find((r) => r.id === event.assignee);
      if (employee) {
        detailText = employee.name;
        avatarUrl = employee.img;
      }
    }

    return { detailText, typeDotColor, avatarUrl };
  }

  formatEventDate(date: any): string {
    return formatDate('DD MMM', new Date(date));
  }

  editEvent(ev: any): void {
    this.editingEventId = ev.id;
    this.editEventTitle = ev.title;
    this.editEventDateRange = [new Date(ev.start), new Date(ev.end)];
    this.editDatePicker.open();
  }

  onEditDateChange(args: any): void {
    const dates = args.value;
    const startVal = dates && dates[0];
    const endVal = dates && dates[1];

    if (this.editingEventId !== null && startVal && endVal) {
      const oldEvent = this.rawEvents.find((e: any) => e.id === this.editingEventId) as any;
      if (!oldEvent) return;

      const oldQuarter = Math.floor(new Date(oldEvent.start).getMonth() / 3);
      const newQuarter = Math.floor(new Date(startVal).getMonth() / 3);
      const oldYear = new Date(oldEvent.start).getFullYear();
      const newYear = new Date(startVal).getFullYear();
      const quarterChanged = this.groupByClientQuarter && (oldQuarter !== newQuarter || oldYear !== newYear);

      const applyUpdate = () => {
        this.rawEvents = this.rawEvents.map((e: any) => (e.id === this.editingEventId ? { ...e, start: startVal, end: endVal } : e));
        this.updateView();
      };

      if (quarterChanged) {
        const quarterNames = ['Q1', 'Q2', 'Q3', 'Q4'];
        const fromLabel = `${quarterNames[oldQuarter]} ${oldYear}`;
        const toLabel = `${quarterNames[newQuarter]} ${newYear}`;
        this.notify.confirm({
          title: 'Move to different group',
          message: `"${oldEvent.title}" will move from ${fromLabel} to ${toLabel}. Do you want to continue?`,
          okText: 'Move',
          cancelText: 'Cancel',
          callback: (result: boolean) => {
            if (result) {
              applyUpdate();
              this.notify.toast({ message: `"${oldEvent.title}" moved to ${toLabel}.` });
            }
          },
        });
      } else {
        applyUpdate();
        this.notify.toast({ message: `"${oldEvent.title}" dates updated.` });
      }
    }
  }

  getEventMarginLeft(ev: any, group: any): string {
    const groupStart = new Date(group.start).getTime();
    const groupEnd = new Date(group.end).getTime();
    const groupDuration = groupEnd - groupStart;
    const evStart = new Date(ev.start).getTime();
    return groupDuration > 0 ? ((evStart - groupStart) / groupDuration) * 100 + '%' : '0%';
  }

  getEventWidth(ev: any, group: any): string {
    const groupStart = new Date(group.start).getTime();
    const groupEnd = new Date(group.end).getTime();
    const groupDuration = groupEnd - groupStart;
    const evStart = new Date(ev.start).getTime();
    const evEnd = new Date(ev.end).getTime();
    return groupDuration > 0 ? ((evEnd - evStart) / groupDuration) * 100 + '%' : '100%';
  }
}
```

### Template

```html
<mbsc-eventcalendar
  #calendar
  [data]="displayEvents"
  [view]="myView"
  [resources]="myResources"
  [dragToMove]="true"
  [dragToResize]="true"
  [dragToCreate]="false"
  [clickToCreate]="false"
  [dragBetweenResources]="!groupByClientQuarter"
  (onEventUpdate)="onEventUpdate($event)"
  [headerTemplate]="customHeaderTemplate"
  [resourceTemplate]="customResourceTemplate"
  [timelineEventTemplate]="groupByClientQuarter ? groupedEventTemplate : simpleEventTemplate"
  class="mds-event-group-calendar"
>
  <!-- Custom Header -->
  <ng-template #customHeaderTemplate>
    <mbsc-calendar-nav></mbsc-calendar-nav>
    <div class="mbsc-flex mbsc-flex-1-0 mbsc-justify-content-end mds-event-group-header-controls">
      <mbsc-checkbox
        [(ngModel)]="groupByClientQuarter"
        (change)="onGroupByClientQuarterChange($event)"
        theme="material"
        label="Group by Client/Quarter"
      >
      </mbsc-checkbox>
      <mbsc-select
        inputStyle="box"
        display="anchored"
        class="mds-event-group-select"
        [touchUi]="false"
        [data]="selectData"
        [(ngModel)]="groupBy"
        (onChange)="onGroupByChange($event)"
      >
      </mbsc-select>
    </div>
    <mbsc-segmented-group [(ngModel)]="zoomLevel" (ngModelChange)="onZoomLevelChange()">
      <mbsc-segmented value="quarter">Quarterly</mbsc-segmented>
      <mbsc-segmented value="month">Monthly</mbsc-segmented>
      <mbsc-segmented value="week">Weekly</mbsc-segmented>
    </mbsc-segmented-group>
    <mbsc-calendar-prev></mbsc-calendar-prev>
    <mbsc-calendar-today></mbsc-calendar-today>
    <mbsc-calendar-next></mbsc-calendar-next>
  </ng-template>

  <!-- Custom resource -->
  <ng-template #customResourceTemplate let-resource>
    <div class="mbsc-flex" *ngIf="groupBy === 'assignee'">
      <img [alt]="resource.name" class="mds-event-group-avatar" [src]="resource.img" />
      <div class="mds-event-group-cont">
        <div class="mds-event-group-name">{{ resource.name }}</div>
        <div class="mds-event-group-title">{{ resource.title }}</div>
      </div>
    </div>
    <div class="mbsc-flex mds-event-group-type-resource" *ngIf="groupBy === 'type'">
      <div class="mds-event-group-type-badge" [style.background-color]="resource.color"></div>
      <div class="mds-event-group-type-name">{{ resource.name }}</div>
    </div>
  </ng-template>

  <!-- Grouped Event Template -->
  <ng-template #groupedEventTemplate let-event>
    <div
      class="mbsc-flex mds-event-group-task mds-event-group-task-client"
      [class.expanded]="!event.original.collapsed"
      [style.border-left-color]="event.original.color"
    >
      <div class="mbsc-flex mds-event-group-content">
        <div class="mds-event-group-title-text mds-event-group-text-truncate">{{ event.original.clientGroup }}</div>

        <div class="mbsc-flex mds-event-group-right">
          <div class="mbsc-flex mds-event-group-meta">
            <div class="mds-event-group-date-range">
              {{ formatEventDate(event.original.start) }} - {{ formatEventDate(event.original.end) }}
            </div>
            <div class="mds-event-group-count">
              {{ event.original.count }} task{{ event.original.count > 1 ? 's' : '' }}, {{ getUniqueItems(event.original.originalEvents ||
              []).count }} {{ getUniqueItems(event.original.originalEvents || []).label }}{{ getUniqueItems(event.original.originalEvents ||
              []).count > 1 ? 's' : '' }}
            </div>
          </div>
          <div
            class="mbsc-flex mds-event-group-icon mbsc-icon mbsc-font-icon mbsc-icon-material-keyboard-arrow-down"
            (click)="toggleGroupCollapse(event.original); $event.stopPropagation()"
          ></div>
        </div>
      </div>

      <div class="mds-event-group-events">
        <div class="mds-event-group-events-inner" *ngIf="!event.original.collapsed">
          <div
            *ngFor="let ev of event.original.originalEvents"
            class="mds-event-group-original-event"
            [style.margin-left]="getEventMarginLeft(ev, event.original)"
            [style.width]="getEventWidth(ev, event.original)"
            [title]="ev.title + ', ' + formatEventDate(ev.start) + ' - ' + formatEventDate(ev.end)"
          >
            <div class="mbsc-flex mds-event-group-event-content">
              <div class="mds-event-group-event-title mds-event-group-text-truncate">{{ ev.title }}</div>
              <div class="mbsc-flex mds-event-group-event-right">
                <div class="mds-event-group-event-date mds-event-group-text-truncate">
                  {{ formatEventDate(ev.start) }} - {{ formatEventDate(ev.end) }}
                </div>
                <div class="mbsc-flex mds-event-group-event-detail">
                  <img
                    *ngIf="getDetailInfo(ev).avatarUrl"
                    [src]="getDetailInfo(ev).avatarUrl"
                    [alt]="getDetailInfo(ev).detailText"
                    class="mds-event-group-event-avatar"
                  />
                  <span
                    *ngIf="getDetailInfo(ev).typeDotColor"
                    class="mds-event-group-type-dot"
                    [style.background-color]="getDetailInfo(ev).typeDotColor"
                  >
                  </span>
                  <div class="mds-event-group-event-info mds-event-group-text-truncate">{{ getDetailInfo(ev).detailText }}</div>
                </div>
              </div>
              <div
                class="mds-event-group-edit-btn mbsc-flex mbsc-icon mbsc-font-icon mbsc-icon-pencil"
                (click)="editEvent(ev); $event.stopPropagation()"
              ></div>
            </div>
          </div>
        </div>
      </div>
    </div>
  </ng-template>

  <!-- Simple Event Template -->
  <ng-template #simpleEventTemplate let-event>
    <div class="mbsc-flex mds-event-simple">
      <div class="mds-event-simple-title">
        <div class="mds-event-simple-title-inner mds-event-group-text-truncate">{{ event.original.title }}</div>
      </div>
      <div class="mbsc-flex mds-event-simple-right">
        <div class="mds-event-simple-date">{{ formatEventDate(event.original.start) }} - {{ formatEventDate(event.original.end) }}</div>
        <div class="mbsc-flex mds-event-simple-subtitle-wrapper" *ngIf="getDetailInfo(event.original).detailText">
          <img
            *ngIf="getDetailInfo(event.original).avatarUrl"
            [src]="getDetailInfo(event.original).avatarUrl"
            [alt]="getDetailInfo(event.original).detailText"
            class="mds-event-simple-avatar"
          />
          <span
            *ngIf="getDetailInfo(event.original).typeDotColor"
            class="mds-event-simple-type-dot"
            [style.background-color]="getDetailInfo(event.original).typeDotColor"
          >
          </span>
          <div class="mbsc-flex mds-event-simple-subtitle" [style.margin-left]="groupBy === 'type' ? '25px' : ''">
            {{ getDetailInfo(event.original).detailText }}
          </div>
        </div>
      </div>
    </div>
  </ng-template>
</mbsc-eventcalendar>
<mbsc-datepicker
  #editDatePickerRef
  [controls]="['calendar']"
  select="range"
  display="center"
  [touchUi]="false"
  [showRangeLabels]="false"
  [headerText]="editEventTitle"
  [(ngModel)]="editEventDateRange"
  (onChange)="onEditDateChange($event)"
>
</mbsc-datepicker>
```

### CSS

```css
.mds-event-group-calendar .mbsc-timeline-row {
  height: 140px;
}
.mds-event-group-calendar .mbsc-timeline-resource-col {
  width: 240px;
}
.mds-event-group-calendar .mbsc-ios.mbsc-textfield-wrapper-box {
  margin: 10px 20px;
}
.mds-event-group-calendar .mbsc-timeline-resource-title {
  text-transform: capitalize;
}
.mds-event-group-avatar {
  width: 40px;
  height: 40px;
}
.mds-event-group-cont {
  padding: 0 7px;
}
.mds-event-group-name {
  font-size: 14px;
  line-height: 24px;
}
.mds-event-group-title {
  font-size: 12px;
  font-weight: 400;
  line-height: 16px;
}
.mds-event-group-type-resource {
  align-items: center;
  padding: 8px 0;
}
.mds-event-group-type-badge {
  width: 12px;
  height: 12px;
  border-radius: 50%;
  margin: 0 10px;
}
.mds-event-group-type-name {
  font-size: 14px;
  font-weight: 600;
  line-height: 20px;
}
.mds-event-group-calendar .mbsc-schedule-event {
  min-width: 72px;
}
.mds-event-group-calendar .mbsc-schedule-event:has(.mds-event-group-task-client) {
  min-width: 120px;
}
.mds-event-group-task-client {
  background-color: #ddd;
  border-left: 4px solid;
  border-radius: 0 8px 8px 0;
  box-shadow:
    0 2px 4px rgba(0, 0, 0, 0.12),
    0 1px 2px rgba(0, 0, 0, 0.08);
  flex-direction: column;
  container-type: inline-size;
  min-width: 120px;
}
.mds-event-group-content {
  justify-content: space-between;
  align-items: center;
  padding: 10px 14px;
  height: 42px;
  box-sizing: border-box;
  gap: 8px;
}
.mds-event-group-title-text {
  font-size: 14px;
  font-weight: 600;
  color: #1e293b;
  line-height: 20px;
  min-width: 0;
  position: sticky;
  left: 250px;
}
.mds-event-group-right {
  align-items: center;
  z-index: 1;
  background-color: #ddd;
}
.mds-event-group-meta {
  flex-direction: column;
  align-items: flex-end;
  flex: 1;
  margin: 0 12px;
}
.mds-event-group-date-range {
  color: #575757;
  font-size: 11px;
  margin-bottom: 2px;
}
.mds-event-group-count {
  font-size: 11px;
  white-space: nowrap;
}
.mds-event-group-icon {
  font-size: 20px;
  cursor: pointer;
  transition: transform 0.2s ease;
  width: 24px;
  height: 24px;
  align-items: center;
  justify-content: center;
  transform: rotate(0deg);
}
.mds-event-group-task.expanded .mds-event-group-icon {
  transform: rotate(180deg);
}
.mds-event-group-events {
  display: grid;
  grid-template-rows: 0fr;
  transition: grid-template-rows 0.2s ease;
}
.mds-event-group-events-inner {
  overflow: hidden;
  padding: 0 14px 4px;
  transition: padding 0.2s ease;
}
.mds-event-group-task.expanded .mds-event-group-events {
  grid-template-rows: 1fr;
}
.mds-event-group-original-event {
  background: #f1f1f1;
  border-radius: 6px;
  margin-bottom: 6px;
  padding: 6px 10px;
  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.14);
  box-sizing: border-box;
  min-height: 38px;
  min-width: 100px;
  overflow: hidden;
  container-type: inline-size;
}
@container (max-width: 180px) {
  .mds-event-group-meta {
    display: none;
  }
}
@container (max-width: 130px) {
  .mds-event-group-event-right {
    display: none;
  }
  .mds-event-simple-right {
    display: none;
  }
}
.mds-event-group-event-content {
  justify-content: space-between;
  align-items: center;
  line-height: 14px;
}
.mds-event-group-event-title {
  font-weight: 600;
  color: #1e293b;
  font-size: 13px;
  line-height: 18px;
  flex: 1;
  min-width: 30px;
  margin-right: 8px;
}
.mds-event-group-text-truncate {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}
.mds-event-group-event-right {
  flex-direction: column;
  align-items: flex-end;
  min-width: 0;
}
.mds-event-group-event-date {
  font-size: 11px;
  color: #94a3b8;
  text-align: right;
  margin-bottom: 2px;
  max-width: 100%;
}
.mds-event-group-event-detail {
  align-items: center;
  justify-content: flex-end;
  overflow: hidden;
  max-width: 100%;
}
.mds-event-group-event-info {
  font-size: 11px;
  font-weight: 700;
  color: #64748b;
  text-transform: capitalize;
}
.mds-event-group-event-avatar {
  width: 16px;
  height: 16px;
  border-radius: 50%;
  margin-right: 6px;
}
.mds-event-group-type-dot {
  width: 8px;
  height: 8px;
  border-radius: 50%;
  margin-right: 6px;
}
.mds-event-group-edit-btn {
  align-items: center;
  justify-content: center;
  font-size: 14px;
  cursor: pointer;
  color: #94a3b8;
  padding: 4px;
  margin-left: 8px;
  border-radius: 4px;
  transition:
    color 0.15s ease,
    background-color 0.15s ease;
  flex-shrink: 0;
}
.mds-event-group-edit-btn:hover {
  color: #1e293b;
  background-color: rgba(0, 0, 0, 0.06);
}
.mds-event-simple {
  padding: 10px 12px;
  border-radius: 6px;
  box-shadow:
    0 2px 4px rgba(0, 0, 0, 0.15),
    0 1px 2px rgba(0, 0, 0, 0.1);
  justify-content: space-between;
  align-items: center;
  height: 42px;
  box-sizing: border-box;
  color: #2c2c2c;
  background-color: #ddd;
  container-type: inline-size;
  gap: 8px;
}
.mds-event-simple-title {
  font-size: 13px;
  font-weight: 600;
  position: sticky;
  left: 250px;
  min-width: 0;
}
.mds-event-simple-title-inner {
  display: inline-block;
  max-width: 100%;
}
.mds-event-simple-right {
  flex-direction: column;
  z-index: 1;
  background-color: #ddd;
}
.mds-event-simple-date {
  font-size: 11px;
  opacity: 0.85;
  white-space: nowrap;
  text-align: right;
  margin-bottom: 2px;
}
.mds-event-simple-subtitle-wrapper {
  position: relative;
  align-items: center;
  justify-content: flex-end;
}
.mds-event-simple-avatar {
  width: 20px;
  height: 20px;
  border-radius: 50%;
  margin-right: 6px;
  position: absolute;
  left: 0;
}
.mds-event-simple-type-dot {
  width: 8px;
  height: 8px;
  border-radius: 50%;
  margin: 0 6px;
}
.mds-event-simple-subtitle {
  font-size: 11px;
  font-weight: 700;
  text-transform: capitalize;
  white-space: nowrap;
}
.mds-event-group-header-controls {
  align-items: center;
}
.mds-event-group-select .mbsc-textfield {
  width: 210px;
  max-height: 34px;
}
.mds-event-group-select .mbsc-ios.mbsc-select-icon {
  font-size: 13px;
  top: 8px;
}
.mds-event-group-calendar .mbsc-ios.mbsc-segmented-button {
  padding: 1px 12px;
}
```

## Implementation notes

- Use `type: 'year'` with `resolutionHorizontal` driven by a `zoomLevel` state (values: `'quarter'`, `'month'`, `'week'`) and `eventHeight: 'variable'` to accommodate collapsible grouped event blocks.
- Define two separate resource arrays: `assigneeResources` (employees with `name`, `title`, `color`, `img`) and `typeResources` (work categories with `name`, `color`). Keep a `groupBy` state (`'assignee'` or `'type'`) and pass the matching array to `resources`. When `groupBy` is `'type'`, the event's `type` field is used as the `resource` key; when `'assignee'`, the `resource` field is used.
- Keep a `groupByClientQuarter` boolean toggle state. When disabled, map each event to a display-ready object with the correct resource key for the current `groupBy` mode. When enabled, compute grouped events instead.
- To compute grouped events, group the flat event array by `(resourceId, clientGroup, year, quarter)`. For each group, create a synthetic event object with a `title` (client name), a `start` (earliest start), an `end` (latest end), a `count`, an `originalEvents` array, and a `collapsed` flag read from a `collapsedMap` state (defaulting to `true`).
- Use `renderTimelineEvent` (Angular: `timelineEventTemplate`, Vue: `#timelineEvent` slot) for event rendering. When `groupByClientQuarter` is on, render the grouped block; when off, render a simple individual event with the event title, date range, and either a type color dot or an assignee avatar.
- The grouped event block shows the client group name, a formatted date range, a task count and unique type/employee count, and a collapse/expand arrow button. When expanded, render each original event as a proportional mini bar positioned by its relative offset within the group's time span using computed `marginLeft` and `width` percentages.
- On the collapse arrow click, call `stopPropagation`, toggle the group's key in `collapsedMap`, and call `calendarRef.current.refresh()` after a short timeout to force Mobiscroll to recalculate event heights.
- Each expanded original event has a pencil icon button. On click, call `stopPropagation` and open a `Datepicker` in `select: 'range'` and `controls: ['calendar']` mode centered on screen, pre-populated with the event's current dates.
- In the `Datepicker` `onChange` handler, if the new dates move the event to a different quarter and grouping is on, show a `Confirm` dialog before applying. Store the apply callback in a ref so the `onOk` handler can execute it after the user confirms.
- In `onEventUpdate`, distinguish drag-move from drag-resize by comparing start and end deltas. For a grouped event move, shift all `originalEvents` by the same time delta. For a resize, proportionally remap each child's start and end within the new group span. After applying, update the `collapsedMap` with a new key reflecting the event's new quarter. In non-grouped mode, update the single event's dates and, if the resource row changed, update the event's `resource` or `type` field accordingly.
- Set `dragBetweenResources` to `true` in non-grouped mode and `false` in grouped mode (a single expression: `!groupByClientQuarter`). Keep `dragToMove: true` and `dragToResize: true`; disable `clickToCreate` and `dragToCreate`.
- Use `renderResource` (Angular: `resourceTemplate`, Vue: `#resource` slot) to show a photo, name, and title for assignee resources, and a colored badge with name for type resources.
- Use `renderHeader` (Angular: `headerTemplate`, Vue: `#header` slot) to render `CalendarNav`, a `Checkbox` for the group toggle, a `Select` for switching between assignee and type views, a `SegmentedGroup` with three `Segmented` controls for zoom level, and `CalendarPrev`/`CalendarToday`/`CalendarNext`.

## 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-angular.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 angular
   ```

5. Install dependencies - open a terminal window in the root directory and run:

   ```
   npm install
   ```

6. Run the project:

   ```
   ng serve
   ```

On a trial, add `--trial` to the config command: `mobiscroll config angular --trial`.

Running a demo locally requires a Mobiscroll trial or a license; setup is per framework at https://mobiscroll.com/docs/angular/getting-started/installation

## Related demos

- Previous: [External Resource Drag & Drop](https://demo.mobiscroll.com/angular/timeline/resource-management-with-dynamic-team-creation.md) - Drag external resources onto a Angular Timeline to add team members, or drag them off to remove them — build crew scheduling and team management.
- Next: [36-Hour Rolling Window Schedule](https://demo.mobiscroll.com/angular/timeline/36-hour-rolling-window-aircraft-view.md) - Build a fleet scheduling view on the Angular Timeline — a 36-hour rolling window that auto-advances from the current hour.
