[ADF-3869] extensibility related components (#4107)

* extensions: dynamic column

* content: trashcan name column

* content: library status column

* content: library role column

* content: library name column

* style fixes

* content: name column

* demo: use name column in DL example

* fix tests

* lint fixes

* code fixes

* update docs

* add toggle to demo shell

lib/content-services/document-list/components/library-name-column/library-name-column.component.spec.ts

@@ -0,0 +1,96 @@
+/*!
+ * @license
+ * Copyright 2016 Alfresco Software, Ltd.
+ *
+ * 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
+ *
+ *     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 { TestBed, ComponentFixture } from '@angular/core/testing';
+import { NO_ERRORS_SCHEMA, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+import { setupTestBed } from '@alfresco/adf-core';
+import { LibraryNameColumnComponent } from './library-name-column.component';
+import { ContentTestingModule } from '../../../testing/content.testing.module';
+
+describe('LibraryNameColumnComponent', () => {
+    let fixture: ComponentFixture<LibraryNameColumnComponent>;
+    let component: LibraryNameColumnComponent;
+    let node;
+
+    setupTestBed({
+        imports: [ContentTestingModule],
+        schemas: [CUSTOM_ELEMENTS_SCHEMA, NO_ERRORS_SCHEMA]
+    });
+
+    beforeEach(() => {
+        node = <any> {
+            id: 'nodeId',
+            path: {
+                elements: []
+            }
+        };
+    });
+
+    beforeEach(() => {
+        fixture = TestBed.createComponent(LibraryNameColumnComponent);
+        component = fixture.componentInstance;
+    });
+
+    describe('makeLibraryTooltip()', () => {
+        it('maps tooltip to description', () => {
+            node.description = 'description';
+            const tooltip = component.makeLibraryTooltip(node);
+
+            expect(tooltip).toBe(node.description);
+        });
+
+        it('maps tooltip to description', () => {
+            node.title = 'title';
+            const tooltip = component.makeLibraryTooltip(node);
+
+            expect(tooltip).toBe(node.title);
+        });
+
+        it('sets tooltip to empty string', () => {
+            const tooltip = component.makeLibraryTooltip(node);
+
+            expect(tooltip).toBe('');
+        });
+    });
+
+    describe('makeLibraryTitle()', () => {
+        it('sets title with id when duplicate nodes title exists in list', () => {
+            node.title = 'title';
+
+            const rows = [
+                <any> { node: { entry: { id: 'some-id', title: 'title' } } }
+            ];
+
+            const title = component.makeLibraryTitle(node, rows);
+            expect(title).toContain('nodeId');
+        });
+
+        it('sets title when no duplicate nodes title exists in list', () => {
+            node.title = 'title';
+
+            const rows = [
+                <any> {
+                    node: { entry: { id: 'some-id', title: 'title-some-id' } }
+                }
+            ];
+
+            const title = component.makeLibraryTitle(node, rows);
+
+            expect(title).toBe('title');
+        });
+    });
+});

lib/content-services/document-list/components/library-name-column/library-name-column.component.ts

@@ -0,0 +1,90 @@
+/*!
+ * @license
+ * Copyright 2016 Alfresco Software, Ltd.
+ *
+ * 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
+ *
+ *     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,
+  ChangeDetectionStrategy,
+  ViewEncapsulation,
+  OnInit,
+  Input,
+  ElementRef
+} from '@angular/core';
+import { MinimalNodeEntity } from 'alfresco-js-api';
+import { ShareDataRow } from '../../data/share-data-row.model';
+
+@Component({
+  selector: 'adf-library-name-column',
+  template: `
+    <span title="{{ displayTooltip }}" (click)="onClick()">
+      {{ displayText }}
+    </span>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  encapsulation: ViewEncapsulation.None,
+  host: { class: 'adf-datatable-cell adf-datatable-link adf-library-name-column' }
+})
+export class LibraryNameColumnComponent implements OnInit {
+  @Input()
+  context: any;
+
+  displayTooltip: string;
+  displayText: string;
+  node: MinimalNodeEntity;
+
+  constructor(private element: ElementRef) {}
+
+  ngOnInit() {
+    this.node = this.context.row.node;
+    const rows: Array<ShareDataRow> = this.context.data.rows || [];
+    if (this.node && this.node.entry) {
+      this.displayText = this.makeLibraryTitle(this.node.entry, rows);
+      this.displayTooltip = this.makeLibraryTooltip(this.node.entry);
+    }
+  }
+
+  onClick() {
+    this.element.nativeElement.dispatchEvent(
+      new CustomEvent('name-click', {
+        bubbles: true,
+        detail: {
+          node: this.node
+        }
+      })
+    );
+  }
+
+  makeLibraryTooltip(library: any): string {
+    const { description, title } = library;
+
+    return description || title || '';
+  }
+
+  makeLibraryTitle(library: any, rows: Array<ShareDataRow>): string {
+    const entries = rows.map((r: ShareDataRow) => r.node.entry);
+    const { title, id } = library;
+
+    let isDuplicate = false;
+
+    if (entries) {
+      isDuplicate = entries.some((entry: any) => {
+        return entry.id !== id && entry.title === title;
+      });
+    }
+
+    return isDuplicate ? `${title} (${id})` : `${title}`;
+  }
+}