Roadmap MonthsHeaderItem Component

ee/app/assets/javascripts/roadmap/components/preset_months/months_header_item.vue

+<script>
+  import { monthInWords } from '~/lib/utils/datetime_utility';
+
+  import MonthsHeaderSubItem from './months_header_sub_item.vue';
+
+  export default {
+    components: {
+      MonthsHeaderSubItem,
+    },
+    props: {
+      timeframeIndex: {
+        type: Number,
+        required: true,
+      },
+      timeframeItem: {
+        type: Date,
+        required: true,
+      },
+      timeframe: {
+        type: Array,
+        required: true,
+      },
+      itemWidth: {
+        type: Number,
+        required: true,
+      },
+    },
+    data() {
+      const currentDate = new Date();
+      currentDate.setHours(0, 0, 0, 0);
+
+      return {
+        currentDate,
+        currentYear: currentDate.getFullYear(),
+        currentMonth: currentDate.getMonth(),
+      };
+    },
+    computed: {
+      itemStyles() {
+        return {
+          width: `${this.itemWidth}px`,
+        };
+      },
+      timelineHeaderLabel() {
+        const year = this.timeframeItem.getFullYear();
+        const month = monthInWords(this.timeframeItem, true);
+
+        // Show Year only if current timeframe has months between
+        // two years and current timeframe item is first month
+        // from one of the two years.
+        //
+        // End result of doing this is;
+        //  2017 Nov, Dec, 2018 Jan, Feb, Mar
+        if (this.timeframeIndex !== 0 &&
+            this.timeframe[this.timeframeIndex - 1].getFullYear() === year) {
+          return month;
+        }
+
+        return `${year} ${month}`;
+      },
+      timelineHeaderClass() {
+        let itemLabelClass = '';
+
+        const timeframeYear = this.timeframeItem.getFullYear();
+        const timeframeMonth = this.timeframeItem.getMonth();
+
+        // Show dark color text only if timeframe item year & month
+        // are greater than current year.
+        if (timeframeYear >= this.currentYear &&
+            timeframeMonth >= this.currentMonth) {
+          itemLabelClass += 'label-dark';
+        }
+
+        // Show bold text only if timeframe item year & month
+        // is current year & month
+        if (timeframeYear === this.currentYear &&
+            timeframeMonth === this.currentMonth) {
+          itemLabelClass += ' label-bold';
+        }
+
+        return itemLabelClass;
+      },
+    },
+  };
+</script>
+
+<template>
+  <span
+    class="timeline-header-item"
+    :style="itemStyles"
+  >
+    <div
+      class="item-label"
+      :class="timelineHeaderClass"
+    >
+      {{ timelineHeaderLabel }}
+    </div>
+    <months-header-sub-item
+      :timeframe-item="timeframeItem"
+      :current-date="currentDate"
+    />
+  </span>
+</template>

spec/javascripts/roadmap/components/preset_months/months_header_item_spec.js

+import Vue from 'vue';
+
+import MonthsHeaderItemComponent from 'ee/roadmap/components/preset_months/months_header_item.vue';
+
+import mountComponent from 'spec/helpers/vue_mount_component_helper';
+import { mockTimeframeMonths, mockShellWidth, mockItemWidth } from '../../mock_data';
+
+const mockTimeframeIndex = 0;
+
+const createComponent = ({
+  timeframeIndex = mockTimeframeIndex,
+  timeframeItem = mockTimeframeMonths[mockTimeframeIndex],
+  timeframe = mockTimeframeMonths,
+  shellWidth = mockShellWidth,
+  itemWidth = mockItemWidth,
+}) => {
+  const Component = Vue.extend(MonthsHeaderItemComponent);
+
+  return mountComponent(Component, {
+    timeframeIndex,
+    timeframeItem,
+    timeframe,
+    shellWidth,
+    itemWidth,
+  });
+};
+
+describe('MonthsHeaderItemComponent', () => {
+  let vm;
+
+  afterEach(() => {
+    vm.$destroy();
+  });
+
+  describe('data', () => {
+    it('returns default data props', () => {
+      vm = createComponent({});
+      const currentDate = new Date();
+      expect(vm.currentDate.getDate()).toBe(currentDate.getDate());
+      expect(vm.currentYear).toBe(currentDate.getFullYear());
+      expect(vm.currentMonth).toBe(currentDate.getMonth());
+    });
+  });
+
+  describe('computed', () => {
+    describe('itemStyles', () => {
+      it('returns style object for container element based on value of `itemWidth` prop', () => {
+        vm = createComponent({});
+        expect(vm.itemStyles.width).toBe('180px');
+      });
+    });
+
+    describe('timelineHeaderLabel', () => {
+      it('returns string containing Year and Month for current timeline header item', () => {
+        vm = createComponent({});
+        expect(vm.timelineHeaderLabel).toBe('2017 Dec');
+      });
+
+      it('returns string containing only Month for current timeline header item when previous header contained Year', () => {
+        vm = createComponent({
+          timeframeIndex: mockTimeframeIndex + 1,
+          timeframeItem: mockTimeframeMonths[mockTimeframeIndex + 1],
+        });
+        expect(vm.timelineHeaderLabel).toBe('2018 Jan');
+      });
+    });
+
+    describe('timelineHeaderClass', () => {
+      it('returns empty string when timeframeItem year or month is less than current year or month', () => {
+        vm = createComponent({});
+        expect(vm.timelineHeaderClass).toBe('');
+      });
+
+      it('returns string containing `label-dark label-bold` when current year and month is same as timeframeItem year and month', () => {
+        vm = createComponent({
+          timeframeItem: new Date(),
+        });
+        expect(vm.timelineHeaderClass).toBe('label-dark label-bold');
+      });
+
+      it('returns string containing `label-dark` when current year and month is less than timeframeItem year and month', () => {
+        const timeframeIndex = 2;
+        const timeframeItem = new Date(
+          mockTimeframeMonths[timeframeIndex].getFullYear(),
+          mockTimeframeMonths[timeframeIndex].getMonth() + 2,
+          1,
+        );
+        vm = createComponent({
+          timeframeIndex,
+          timeframeItem,
+        });
+
+        vm.currentYear = mockTimeframeMonths[timeframeIndex].getFullYear();
+        vm.currentMonth = mockTimeframeMonths[timeframeIndex].getMonth() + 1;
+        expect(vm.timelineHeaderClass).toBe('label-dark');
+      });
+    });
+  });
+
+  describe('template', () => {
+    beforeEach(() => {
+      vm = createComponent({});
+    });
+
+    it('renders component container element with class `timeline-header-item`', () => {
+      expect(vm.$el.classList.contains('timeline-header-item')).toBeTruthy();
+    });
+
+    it('renders item label element class `item-label` and value as `timelineHeaderLabel`', () => {
+      const itemLabelEl = vm.$el.querySelector('.item-label');
+      expect(itemLabelEl).not.toBeNull();
+      expect(itemLabelEl.innerText.trim()).toBe('2017 Dec');
+    });
+  });
+});