passbolt-styleguide/src/react-extension/components/ResourceDetails/DisplayResourceDetails/DisplayResourceDetailsComment.js

Passbolt styleguide contains common styling assets used by the different sites, plugin, etc.

/**
 * Passbolt ~ Open source password manager for teams
 * Copyright (c) Passbolt SA (https://www.passbolt.com)
 *
 * Licensed under GNU Affero General Public License version 3 of the or any later version.
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright     Copyright (c) Passbolt SA (https://www.passbolt.com)
 * @license       https://opensource.org/licenses/AGPL-3.0 AGPL License
 * @link          https://www.passbolt.com Passbolt(tm)
 * @since         2.13.0
 */

import React from "react";
import AddResourceComment from "../../ResourceComment/AddResourceComment/AddResourceComment";
import PropTypes from "prop-types";
import DisplayResourceCommentList from "../../ResourceComment/DisplayResourceCommentList/DisplayResourceCommentList";
import {withResourceWorkspace} from "../../../contexts/ResourceWorkspaceContext";
import Icon from "../../../../shared/components/Icons/Icon";
import {Trans, withTranslation} from "react-i18next";

class DisplayResourceDetailsComment extends React.Component {
  /**
   * Constructor
   * @param {Object} props
   */
  constructor(props) {
    super(props);
    this.state = this.getDefaultState();
    this.bindCallbacks();
  }

  /**
   * Get default state
   * @returns {*}
   */
  getDefaultState() {
    return {
      open: false, // Flag to determine the expand / collapse of the section
      comments: [], // The resource comments
      canAdd: false, // Flag to determine the display of the "Add Comment" area,
      canAddByIcon: false, // Flag to determine the display of the "Add Icons"
      mustRefresh: false, // Flag to determine if the comment list must be refreshed
    };
  }

  /**
   * Whenever the component props or state change
   * @param prevProps Previous props value
   */
  componentDidUpdate(prevProps) {
    this.handleResourceChange(prevProps.resourceWorkspaceContext.details.resource);
  }

  /**
   * Bind callbacks methods
   */
  bindCallbacks() {
    this.handleTitleClickedEvent = this.handleTitleClickedEvent.bind(this);
    this.handleAddedEvent = this.handleAddedEvent.bind(this);
    this.handleCancelledAddEvent = this.handleCancelledAddEvent.bind(this);
    this.handleRequestedAddEvent = this.handleRequestedAddEvent.bind(this);
    this.handleFetchedEvent = this.handleFetchedEvent.bind(this);
  }

  /**
   * Check if the resource has changed and fetch
   * @param previousResource
   */
  async handleResourceChange(previousResource) {
    // do nothing if the section is closed.
    if (!this.state.open) {
      return;
    }
    // do nothing if the resource doesn't change.
    if (this.resource.id === previousResource.id) {
      return;
    }

    await this.setState({mustRefresh: true});
  }

  /**
   * Whenever the user clicks on the section title
   */
  async handleTitleClickedEvent() {
    const open = !this.state.open;
    this.setState({open});
  }

  /**
   * Whenever the user added a new comment
   * @returns {Promise<void>}
   */
  async handleAddedEvent() {
    await this.setState({mustRefresh: true, canAdd: false, canAddByIcon: true});
  }

  /**
   * Whenever the user cancelled the adding of new comment
   */
  async handleCancelledAddEvent() {
    await this.setState({canAdd: false});
  }

  /**
   * Whenever the user requested to add a new comment ( call-to-action )
   */
  async handleRequestedAddEvent() {
    await this.setState({canAdd: true});
  }

  /**
   * Whenever the comments to display has been fetched
   * @param comments The fetched comments
   */

  async handleFetchedEvent(comments) {
    const hasComments = comments && comments.length > 0;
    await this.setState({mustRefresh: false, canAdd: !hasComments, canAddByIcon: hasComments});
  }

  /**
   * Get the current detailed resource
   */
  get resource() {
    return this.props.resourceWorkspaceContext.details.resource;
  }

  /**
   * Render the component
   * @returns {JSX}
   */
  render() {
    return (
      <div className={`comments accordion sidebar-section ${this.state.open ? "" : "closed"}`}>
        <div className="accordion-header">
          <h4>
            <a onClick={this.handleTitleClickedEvent} role="button">
              <Trans>Comments</Trans>
              {this.state.open &&
              <Icon name="caret-down"/>
              }
              {!this.state.open &&
              <Icon name="caret-right"/>
              }
            </a>
          </h4>
        </div>
        { this.state.open &&
          <div className="accordion-content">
            {this.state.canAddByIcon &&
              <a
                className="section-action button button-transparent"
                href="#"
                onClick={this.handleRequestedAddEvent}>
                <Icon name="plus-circle"/>
                <span className="visuallyhidden"><Trans>Create</Trans></span>
              </a>
            }

            { this.state.canAdd &&
              <AddResourceComment
                resource={this.resource}
                onAdd={this.handleAddedEvent}
                onCancel={this.handleCancelledAddEvent}
                cancellable={this.state.canAddByIcon}/>
            }
            <DisplayResourceCommentList
              resource={this.resource}
              onFetch={this.handleFetchedEvent}
              mustRefresh={this.state.mustRefresh}/>
          </div>
        }

      </div>
    );
  }
}

DisplayResourceDetailsComment.propTypes = {
  resourceWorkspaceContext: PropTypes.any, // The resource context
};

export default withResourceWorkspace(withTranslation("common")(DisplayResourceDetailsComment));