elements-sk/modules/select-sk/select-sk.ts

// Copyright 2018 Google LLC
//
// Licensed 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
//
//     https://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.

/** @module elements-sk/select-sk
 *
 * @description <h2><code>select-sk</code></h2>
 *
 * <p>
 *   Clicking on the children will cause them to be selected.
 * </p>
 *
 * <p>
 *   The select-sk elements monitors for the addition and removal of child
 *   elements and will update the 'selected' property as needed. Note that it
 *   does not monitor the 'selected' attribute of child elements, and will not
 *   update the 'selected' property if they are changed directly.
 * </p>
 *
 * @example
 *
 *   <select-sk>
 *     <div></div>
 *     <div></div>
 *     <div selected></div>
 *     <div></div>
 *   </select-sk>
 *
 * @attr disabled - Indicates whether the element is disabled.
 *
 * @evt selection-changed - Sent when an item is clicked and the selection is changed.
 *   The detail of the event contains the child element index:
 *
 *   <pre>
 *     detail: {
 *       selection: 1,
 *     }
 *   </pre>
 *
 */
import { define } from '../define';
import { upgradeProperty } from '../upgradeProperty';

export class SelectSk extends HTMLElement {
  private _obs: MutationObserver;

  private _selection: number;

  static get observedAttributes(): string[] {
    return ['disabled'];
  }

  constructor() {
    super();
    // Keep _selection up to date by monitoring DOM changes.
    this._obs = new MutationObserver(() => this._bubbleUp());
    this._selection = -1;
  }

  connectedCallback(): void {
    upgradeProperty(this, 'selection');
    upgradeProperty(this, 'disabled');
    this.addEventListener('click', this._click);
    this.addEventListener('keydown', this._onKeyDown);
    this.observerConnect();
    this._bubbleUp();
  }

  disconnectedCallback(): void {
    this.removeEventListener('click', this._click);
    this.removeEventListener('keydown', this._onKeyDown);
    this.observerDisconnect();
  }

  observerDisconnect() {
    this._obs.disconnect();
  }

  observerConnect() {
    this._obs.observe(this, {
      subtree: true,
      childList: true,
      attributes: true,
      attributeFilter: ['selected'],
    });
  }

  /** This mirrors the disabled attribute. */
  get disabled(): boolean {
    return this.hasAttribute('disabled');
  }

  set disabled(val: boolean) {
    if (val) {
      this.setAttribute('disabled', '');
      this.setAttribute('aria-disabled', 'true');
      this.selection = -1;
    } else {
      this.removeAttribute('disabled');
      this.setAttribute('aria-disabled', 'false');
      this._bubbleUp();
    }
  }

  /** The index of the item selected. Has a value of -1 if nothing is selected. */
  get selection(): number | string | null | undefined {
    return this._selection;
  }

  set selection(val: number | string | null | undefined) {
    if (this.disabled) {
      return;
    }
    if (val === undefined || val === null) {
      val = -1;
    }
    let numVal = +val;
    if (numVal < 0 || numVal > this.children.length) {
      numVal = -1;
    }
    this._selection = numVal;
    this._rationalize();
  }

  private _click(e: MouseEvent): void {
    if (this.disabled) {
      return;
    }
    const oldIndex = this._selection;
    // Look up the DOM path until we find an element that is a child of
    // 'this', and set _selection based on that.
    let target: Element | null = e.target as Element;
    while (target && target.parentElement !== this) {
      target = target.parentElement;
    }
    if (target?.parentElement === this) {
      for (let i = 0; i < this.children.length; i++) {
        if (this.children[i] === target) {
          this._selection = i;
          break;
        }
      }
    }
    this._rationalize();
    if (oldIndex != this._selection) {
      this._emitEvent();
    }
  }

  private _emitEvent(): void {
    this.dispatchEvent(
      new CustomEvent<SelectSkSelectionChangedEventDetail>(
        'selection-changed',
        {
          detail: {
            selection: this._selection,
          },
          bubbles: true,
        }
      )
    );
  }

  // Loop over all immediate child elements and make sure at most only one is selected.
  private _rationalize(): void {
    this.observerDisconnect();
    if (!this.hasAttribute('role')) {
      this.setAttribute('role', 'listbox');
    }
    if (!this.hasAttribute('tabindex')) {
      this.setAttribute('tabindex', '0');
    }
    for (let i = 0; i < this.children.length; i++) {
      const child = this.children[i];
      if (!child.hasAttribute('role')) {
        child.setAttribute('role', 'option');
      }
      if (this._selection === i) {
        child.setAttribute('selected', '');
        child.setAttribute('aria-selected', 'true');
      } else {
        child.removeAttribute('selected');
        child.setAttribute('aria-selected', 'false');
      }
    }
    this.observerConnect();
  }

  // Loop over all immediate child elements and find the first one selected.
  private _bubbleUp(): void {
    this._selection = -1;
    if (this.disabled) {
      return;
    }
    for (let i = 0; i < this.children.length; i++) {
      if (this.children[i].hasAttribute('selected')) {
        this._selection = i;
        break;
      }
    }
    this._rationalize();
  }

  attributeChangedCallback(name: string, oldValue: any, newValue: any): void {
    // Only handling 'disabled'.
    const hasValue = newValue !== null;
    this.setAttribute('aria-disabled', String(hasValue));
    if (hasValue) {
      this.removeAttribute('tabindex');
      this.blur();
    } else {
      this.setAttribute('tabindex', '0');
    }
  }

  private _onKeyDown(e: KeyboardEvent): void {
    if (e.altKey) return;
    const oldIndex = this._selection;
    switch (e.key) {
      case 'ArrowDown':
        if (this.selection! < this.children.length - 1) {
          (this.selection as number) += 1;
        }
        e.preventDefault();
        break;
      case 'ArrowUp':
        if (this.selection! > 0) {
          (this.selection as number) -= 1;
        }
        e.preventDefault();
        break;
      case 'Home':
        this.selection = 0;
        e.preventDefault();
        break;
      case 'End':
        this.selection = this.children.length - 1;
        e.preventDefault();
        break;
    }
    if (oldIndex != this._selection) {
      this._emitEvent();
    }
  }
}

define('select-sk', SelectSk);

export interface SelectSkSelectionChangedEventDetail {
  readonly selection: number;
}