static_src/elements/framework/mr-comment-content/mr-description.js

// Copyright 2019 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import {LitElement, html, css} from 'lit-element';
import './mr-comment-content.js';
import './mr-attachment.js';

import {relativeTime} from
  'elements/chops/chops-timestamp/chops-timestamp-helpers';


/**
 * `<mr-description>`
 *
 * Element for displaying a description or survey.
 *
 */
export class MrDescription extends LitElement {
  /** @override */
  constructor() {
    super();

    this.descriptionList = [];
    this.selectedIndex = 0;
  }

  /** @override */
  static get properties() {
    return {
      descriptionList: {type: Array},
      selectedIndex: {type: Number},
    };
  }

  /** @override */
  updated(changedProperties) {
    super.updated(changedProperties);

    if (changedProperties.has('descriptionList')) {
      if (!this.descriptionList || !this.descriptionList.length) return;
      this.selectedIndex = this.descriptionList.length - 1;
    }
  }

  /** @override */
  static get styles() {
    return css`
      .select-container {
        text-align: right;
      }
    `;
  }

  /** @override */
  render() {
    const selectedDescription = this.selectedDescription;

    return html`
      <div class="select-container">
        <select
          @change=${this._selectChanged}
          ?hidden=${!this.descriptionList || this.descriptionList.length <= 1}
          aria-label="Description history menu">
          ${this.descriptionList.map((desc, i) => this._renderDescriptionOption(desc, i))}
        </select>
      </div>
      <mr-comment-content
        .content=${selectedDescription.content}
        .author=${selectedDescription.commenter.displayName}
      ></mr-comment-content>
      <div>
        ${(selectedDescription.attachments || []).map((attachment) => html`
          <mr-attachment
            .attachment=${attachment}
            .projectName=${selectedDescription.projectName}
            .localId=${selectedDescription.localId}
            .sequenceNum=${selectedDescription.sequenceNum}
            .canDelete=${selectedDescription.canDelete}
          ></mr-attachment>
        `)}
      </div>
    `;
  }

  /**
   * Getter for the currently viewed description.
   * @return {Comment} The description object.
   */
  get selectedDescription() {
    const descriptions = this.descriptionList || [];
    const index = Math.max(
      Math.min(this.selectedIndex, descriptions.length - 1),
      0);
    return descriptions[index] || {};
  }

  /**
   * Helper to render a <select> <option> for a single description, for our
   * description selector.
   * @param {Comment} description
   * @param {Number} index
   * @return {TemplateResult}
   * @private
   */
  _renderDescriptionOption(description, index) {
    const {commenter, timestamp} = description || {};
    const byLine = commenter ? `by ${commenter.displayName}` : '';
    return html`
      <option value=${index} ?selected=${index === this.selectedIndex}>
        Description #${index + 1} ${byLine} (${_relativeTime(timestamp)})
      </option>
    `;
  }

  /**
   * Updates the element's selectedIndex when the user changes the select menu.
   * @param {Event} evt
   */
  _selectChanged(evt) {
    if (!evt || !evt.target) return;
    this.selectedIndex = Number.parseInt(evt.target.value);
  }
}

/**
 * Template helper for rendering relative time.
 * @param {number} unixTime Unix timestamp in seconds.
 * @return {string} human readable timestamp.
 */
function _relativeTime(unixTime) {
  unixTime = Number.parseInt(unixTime);
  if (Number.isNaN(unixTime)) return;
  return relativeTime(new Date(unixTime * 1000));
}

customElements.define('mr-description', MrDescription);