openproject/frontend/app/components/work-packages/wp-display-attr/wp-display-attr.directive.ts

// -- copyright
// OpenProject is a project management system.
// Copyright (C) 2012-2015 the OpenProject Foundation (OPF)
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License version 3.
//
// OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
// Copyright (C) 2006-2013 Jean-Philippe Lang
// Copyright (C) 2010-2013 the ChiliProject Team
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// See doc/COPYRIGHT.rdoc for more details.
// ++

import {wpDirectivesModule} from "../../../angular-modules";
import {scopedObservable} from "../../../helpers/angular-rx-utils";
import {HalResource} from "../../api/api-v3/hal-resources/hal-resource.service";
import {
  WorkPackageResource,
  WorkPackageResourceInterface
} from "../../api/api-v3/hal-resources/work-package-resource.service";
import {MultipleLinesStringObjectsDisplayField} from "../../wp-display/field-types/wp-display-multiple-lines-string-objects-field.module";
import {DisplayField} from "../../wp-display/wp-display-field/wp-display-field.module";
import {WorkPackageDisplayFieldService} from "../../wp-display/wp-display-field/wp-display-field.service";
import {WorkPackageEditFieldController} from "../../wp-edit/wp-edit-field/wp-edit-field.directive";
import {WorkPackageCacheService} from "../work-package-cache.service";


export class WorkPackageDisplayAttributeController {

  public wpEditField: WorkPackageEditFieldController;
  public attribute: string;
  public placeholderOptional: string;
  public workPackage: any;
  public customSchema: HalResource;
  public field: DisplayField;
  public labelOptional: string;

  private __d__cell: JQuery;
  private __d__renderer: JQuery;

  constructor(protected $element: JQuery,
              protected wpDisplayField: WorkPackageDisplayFieldService,
              protected wpCacheService: WorkPackageCacheService,
              protected $scope: ng.IScope) {

    // Update the attribute initially
    if (this.workPackage && this.customSchema && this.schema[this.attribute]) {
      this.updateAttribute(this.workPackage);
    }
  }

  public get placeholder() {
    return this.placeholderOptional || (this.field && this.field.placeholder);
  };

  public get label() {
    return this.labelOptional ||
      (this.schema[this.attribute] && this.schema[this.attribute].name) ||
      this.attribute;
  };

  public get labelId(): string {
    return 'wp-' + this.workPackage.id + '-display-attr-' + this.attribute + '-aria-label';
  }

  public get isEmpty(): boolean {
    return !this.field || this.field.isEmpty() || this.field.hidden;
  }

  public get isHidden(): boolean {
    return !this.field || this.field.hidden;
  }

  /**
   * The display attribute is either used for a work package, or a custom resource and schema
   * (sumsSchema)
   */
  public get schema(): HalResource {
    return this.customSchema || this.workPackage.schema;
  }

  public get displayText(): string {
    if (this.field && this.field.unknownAttribute) {
      return '';
    }

    if (this.isEmpty || this.isHidden) {
      return this.placeholder;
    }

    return this.field.valueString;
  }

  protected updateAttribute(wp:WorkPackageResourceInterface) {
    this.workPackage = wp;

    if (this.schema[this.attribute] && (this.schema[this.attribute].type === '[]CustomOption' ||
                                        this.schema[this.attribute].type === '[]User')) {
      this.field = new MultipleLinesStringObjectsDisplayField(this.workPackage, this.attribute, this.schema[this.attribute]);
    } else {
      this.field = this.wpDisplayField.getField(this.workPackage, this.attribute, this.schema[this.attribute]) as DisplayField;
    }

    this.__d__renderer = this.__d__renderer || this.$element.find(".__d__renderer");
    this.field.render(this.__d__renderer[0], this.displayText);

    // strip html tags
    let ariaLabel = angular.element(this.displayText).text();
    this.$element.attr('aria-label', this.label + ' ' + ariaLabel);

    this.__d__cell = this.__d__cell || this.$element.find(".__d__cell");
    this.__d__cell.toggleClass("-placeholder", this.isEmpty);
  }
}

function wpDisplayAttrDirective(wpCacheService:WorkPackageCacheService) {

  function wpTdLink(scope:any,
                    element:ng.IAugmentedJQuery,
                    attr:ng.IAttributes) {

    if (!scope.$ctrl.customSchema) {
      scopedObservable(
        scope,
        wpCacheService.loadWorkPackage(scope.$ctrl.workPackage.id).values$())
        .subscribe((wp: WorkPackageResource) => {
          scope.$ctrl.updateAttribute(wp);
        });
    }
  }

  return {
    restrict: 'E',
    replace: true,
    templateUrl: '/components/work-packages/wp-display-attr/wp-display-attr.directive.html',
    link: wpTdLink,

    scope: {
      workPackage: '=',
      customSchema: '=?',
      attribute: '=',
      labelOptional: '=label',
      placeholderOptional: '=placeholder'
    },

    bindToController: true,
    controller: WorkPackageDisplayAttributeController,
    controllerAs: '$ctrl'
  };
}

wpDirectivesModule.directive('wpDisplayAttr', wpDisplayAttrDirective);