ambari-logsearch/ambari-logsearch-web/src/app/components/menu-button/menu-button.component.ts

/**
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import {Component, Input, Output, ViewChild, ElementRef, EventEmitter} from '@angular/core';
import {ListItem} from '@app/classes/list-item';
import {DropdownListComponent} from '@modules/shared/components/dropdown-list/dropdown-list.component';
import {UtilsService} from '@app/services/utils.service';

@Component({
  selector: 'menu-button',
  templateUrl: './menu-button.component.html',
  styleUrls: ['./menu-button.component.less']
})
export class MenuButtonComponent {

  @ViewChild('dropdown')
  dropdown: ElementRef;

  @ViewChild('dropdownList')
  dropdownList: DropdownListComponent;

  @Input()
  label?: string;

  @Input()
  iconClass: string;

  @Input()
  labelClass?: string;

  @Input()
  subItems?: ListItem[];

  @Input()
  isMultipleChoice = false;

  @Input()
  hideCaret = false;

  @Input()
  isRightAlign = false;

  @Input()
  additionalLabelComponentSetter?: string;

  @Input()
  badge: string;

  @Input()
  caretClass = 'fa-caret-down';

  @Input()
  useDropDownLocalFilter = false;

  /**
   * The minimum time to handle a mousedown as a longclick. Default is 500 ms (0.5sec)
   * @default 500
   * @type {number}
   */
  @Input()
  minLongClickDelay = 500;

  /**
   * The maximum milliseconds to wait for longclick ends. The default is 0 which means no upper limit.
   * @default 0
   * @type {number}
   */
  @Input()
  maxLongClickDelay = 0;

  @Input()
  isDisabled = false;

  @Input()
  listClass = '';

  @Output()
  buttonClick: EventEmitter<void> = new EventEmitter();

  @Output()
  selectItem: EventEmitter<ListItem | ListItem[]> = new EventEmitter();

  /**
   * This is a private property to indicate the mousedown timestamp, so that we can check it when teh click event
   * has been triggered.
   */
  private mouseDownTimestamp: number;

  /**
   * Indicates if the dropdown list is open or not. So that we use internal state to display or hide the dropdown.
   * @type {boolean}
   */
  private dropdownIsOpen = false;

  get hasSubItems(): boolean {
    return Boolean(this.subItems && this.subItems.length);
  }

  get hasCaret(): boolean {
    return this.hasSubItems && !this.hideCaret;
  }

  set selection(items: ListItem[] | null) {
    const selectedItems = items ? (Array.isArray(items) ? items : [items]) : [];
    this.subItems.forEach((subItem: ListItem) => {
      const indexInSelection = this.findItemIndexInList(subItem, selectedItems);
      subItem.isChecked = indexInSelection > -1;
    });
    this.refreshDropdownList();
  }
  get selection(): ListItem[] {
    return this.subItems && this.subItems.filter((option: ListItem): boolean => option.isChecked);
  }

  constructor(private utils: UtilsService) {}

  findItemIndexInList(item: ListItem, itemList: ListItem[] = this.subItems): number {
    return itemList.findIndex((subItem) => (
      item === subItem || this.utils.isEqual(item.value, subItem.value)
    ));
  }

  /**
   * Handling the click event on the component element.
   * Two goal:
   * - check if we have a 'longclick' event and open the dropdown (if any) when longclick event happened
   * - trigger the action or the dropdown open depending on the target element (caret will open the dropdown otherwise
   * trigger the action.
   * @param {MouseEvent} event
   */
  onMouseClick(event: MouseEvent): void {
    if (!this.isDisabled) {
      const el = <HTMLElement>event.target;
      const now = Date.now();
      const mdt = this.mouseDownTimestamp; // mousedown time
      const isLongClick = mdt && mdt + this.minLongClickDelay <= now && (
        !this.maxLongClickDelay || mdt + this.maxLongClickDelay >= now
      );
      const openDropdown = this.hasSubItems && (
        el.classList.contains(this.caretClass) || isLongClick || !this.buttonClick.observers.length
      );
      if (openDropdown && this.dropdown) {
        if (this.toggleDropdown()) {
          this.listenToClickOut();
        }
      } else if (this.buttonClick.observers.length) {
        this.buttonClick.emit();
      }
      this.mouseDownTimestamp = 0;
    }
    event.preventDefault();
  }

  /**
   * Listening the click event on the document so that we can hide our dropdown list if the event source is not the
   * component.
   */
  private listenToClickOut = (): void => {
    if (this.dropdownIsOpen) {
      document.addEventListener('click', this.onDocumentMouseClick);
    }
  }

  /**
   * Handling the click event on the document to hide the dropdown list if it needs.
   * @param {MouseEvent} event
   */
  private onDocumentMouseClick = (event: MouseEvent): void => {
    const el = <HTMLElement>event.target;
    if (!this.dropdown.nativeElement.contains(el)) {
      this.closeDropdown();
      this.removeDocumentClickListener();
    }
  }

  /**
   * Handling the mousedown event, so that we can check the long clicks and open the dropdown if any.
   * @param {MouseEvent} event
   */
  onMouseDown = (event: MouseEvent): void => {
    if (this.hasSubItems) {
      const el = <HTMLElement>event.target;
      if (!el.classList.contains(this.caretClass)) {
        this.mouseDownTimestamp = Date.now();
      }
    }
  }

  /**
   * The goal is to have one and only one place where we open the dropdown. So that later if we need to change the way
   * how we do, it will be easier.
   */
  private openDropdown(): void {
    this.dropdownIsOpen = true;
  }

  /**
   * The goal is to have one and only one place where we close the dropdown. So that later if we need to change the way
   * how we do, it will be easier.
   */
  private closeDropdown(): void {
    this.dropdownIsOpen = false;
  }

  /**
   * Just a simple helper method to make the dropdown toggle more easy.
   * @returns {boolean} It will return the open state of the dropdown;
   */
  private toggleDropdown(): boolean {
    this[this.dropdownIsOpen ? 'closeDropdown' : 'openDropdown']();
    return this.dropdownIsOpen;
  }

  /**
   * The goal is to simply remove the click event listeners from the document.
   */
  private removeDocumentClickListener(): void {
    document.removeEventListener('click', this.onDocumentMouseClick);
  }

  /**
   * The main goal if this function is tho handle the item change event on the child dropdown list.
   * Should update the value and close the dropdown.
   * @param {ListItem} item The selected item(s) from the dropdown list.
   */
  onDropdownItemChange(item: ListItem | ListItem[]) {
    this.updateSelection(item);
    if (!this.isMultipleChoice) {
      this.closeDropdown();
    }
  }

  refreshDropdownList() {
    if (this.dropdownList) {
      this.dropdownList.doItemsCheck();
    }
  }

  updateSelection(item: ListItem | ListItem[]) {
    const changes = Array.isArray(item) ? item : [item];
    changes.forEach((change: ListItem): void => {
      const subItemIndex = this.findItemIndexInList(change);
      if (subItemIndex > -1) {
        this.subItems[subItemIndex].isChecked = change.isChecked;
      }
    });
    this.selectItem.emit(item);
    this.refreshDropdownList();
  }

}