From 54f4a07f53e1f3d7c9347ce98344a3fffafb1e7a Mon Sep 17 00:00:00 2001 From: Andy Stark <30621568+therealandeeee@users.noreply.github.com> Date: Fri, 25 Aug 2017 17:27:09 +0100 Subject: [PATCH] [ADF-1453] Restructure README.md files (#2239) * ADF-1453: Restructured Activiti Analytics readme * ADF-1453: Restructured Activiti Diagrams readme * ADF-1453: Restructured Activiti Form readme * ADF-1453: Restructured Activiti Process List readme * ADF-1453: Restructured Activiti Task List readme * ADF-1453: Restructured Alfresco Core readme * [ADF-1453] Restructured DataTable readme * [ADF-1453] Restructured Document List readme * [ADF-1453] Restructured Login readme * [ADF-1453] Restructured Alfresco Search readme * [ADF-1453] Restructured Alfresco Social readme * [ADF-1453] Restructured Alfresco Tag readme * [ADF-1453] Restructured Alfresco User Info readme * [ADF-1453] Restructured Alfresco Viewer readme * [ADF-1453] Restructured Alfresco Webscript readme * [ADF-1453] Fixed table display glitch * [ADF-1453] Fixed Markdown lint errors in readme files * [ADF-1453] Adding missing fileUploadDelete event to table in Upload readme * [ADF-1453] Resolved merge conflict with Upload readme * [ADF-1453] Changes from npm run doc --- ng2-components/README.md | 141 +-- .../ng2-activiti-analytics/README.md | 136 +-- .../ng2-activiti-diagrams/README.md | 64 +- ng2-components/ng2-activiti-form/README.md | 341 +++--- .../ng2-activiti-processlist/README.md | 216 ++-- .../ng2-activiti-tasklist/README.md | 395 ++++--- ng2-components/ng2-alfresco-core/README.md | 992 +++++++++++------- .../ng2-alfresco-core/docs/adf-toolbar-01.png | Bin 0 -> 14044 bytes .../ng2-alfresco-core/docs/adf-toolbar-02.png | Bin 0 -> 36976 bytes .../ng2-alfresco-core/docs/adf-toolbar-03.png | Bin 0 -> 14016 bytes .../ng2-alfresco-core/docs/adf-toolbar-04.png | Bin 0 -> 33228 bytes .../ng2-alfresco-core/docs/adf-toolbar-05.png | Bin 0 -> 14432 bytes .../ng2-alfresco-core/docs/adf-toolbar-06.png | Bin 0 -> 14208 bytes .../ng2-alfresco-core/docs/adf-toolbar-07.png | Bin 0 -> 14724 bytes .../ng2-alfresco-datatable/README.md | 241 +++-- .../docs/assets/basic.png | Bin 0 -> 20119 bytes .../ng2-alfresco-documentlist/README.md | 306 +++--- ng2-components/ng2-alfresco-login/README.md | 99 +- ng2-components/ng2-alfresco-search/README.md | 119 ++- ng2-components/ng2-alfresco-social/README.md | 91 +- ng2-components/ng2-alfresco-tag/README.md | 86 +- ng2-components/ng2-alfresco-upload/README.md | 170 +-- .../ng2-alfresco-userinfo/README.md | 65 +- ng2-components/ng2-alfresco-viewer/README.md | 161 +-- .../ng2-alfresco-webscript/README.md | 77 +- 25 files changed, 2034 insertions(+), 1666 deletions(-) create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-01.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-02.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-03.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-04.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-05.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-06.png create mode 100644 ng2-components/ng2-alfresco-core/docs/adf-toolbar-07.png create mode 100644 ng2-components/ng2-alfresco-datatable/docs/assets/basic.png diff --git a/ng2-components/README.md b/ng2-components/README.md index 6da5fea421..05e2b010b8 100644 --- a/ng2-components/README.md +++ b/ng2-components/README.md @@ -26,60 +26,18 @@ ### Components - -- [adf-card-view](ng2-alfresco-core/README.md) -- [adf-card-view-textitem](ng2-alfresco-core/README.md) -- [adf-card-view-mapitem](ng2-alfresco-core/README.md) -- [adf-card-view-item-dispatcher](ng2-alfresco-core/README.md) -- [adf-card-view-dateitem](ng2-alfresco-core/README.md) -- [adf-toolbar](ng2-alfresco-core/README.md) -- [adf-toolbar-title](ng2-alfresco-core/README.md) -- [adf-context-menu-holder](ng2-alfresco-core/README.md) -- [adf-accordion](ng2-alfresco-core/README.md) -- [adf-accordion-group](ng2-alfresco-core/README.md) + ### Directives - -- [adf-card-view-content-proxy](ng2-alfresco-core/README.md) -- [adf-context-menu](ng2-alfresco-core/README.md) -- [adf-mdl-textfield](ng2-alfresco-core/README.md) -- [adf-mdl-menu](ng2-alfresco-core/README.md) -- [adf-upload](ng2-alfresco-core/README.md) + ## Content service ### Components - -- [adf-search-control](ng2-alfresco-search/README.md) -- [adf-search](ng2-alfresco-search/README.md) -- [adf-search-autocomplete](ng2-alfresco-search/README.md) -- [adf-upload-button](ng2-alfresco-upload/README.md) -- [adf-upload-drag-area](ng2-alfresco-upload/README.md) -- [adf-file-uploading-list](ng2-alfresco-upload/README.md) -- [adf-file-uploading-dialog](ng2-alfresco-upload/README.md) -- [adf-file-uploading-list-row](ng2-alfresco-upload/README.md) -- [adf-sites-dropdown](ng2-alfresco-documentlist/README.md) -- [adf-content-node-selector](ng2-alfresco-documentlist/README.md) -- [adf-document-menu-action](ng2-alfresco-documentlist/README.md) -- [adf-dropdown-breadcrumb](ng2-alfresco-documentlist/README.md) -- [adf-breadcrumb](ng2-alfresco-documentlist/README.md) -- [adf-document-list](ng2-alfresco-documentlist/README.md) -- [adf-pagination](ng2-alfresco-core/src/components/pagination/pagination.md) -- [adf-empty-list](ng2-alfresco-datatable/README.md) -- [adf-datatable](ng2-alfresco-datatable/README.md) -- [adf-datatable-cell](ng2-alfresco-datatable/README.md) -- [adf-viewer](ng2-alfresco-viewer/README.md) -- [adf-userinfo](ng2-alfresco-userinfo/README.md) -- [adf-rating](ng2-alfresco-social/README.md) -- [adf-like](ng2-alfresco-social/README.md) -- [adf-tag-node-list](ng2-alfresco-tag/README.md) -- [adf-tag-list](ng2-alfresco-tag/README.md) -- [adf-tag-node-actions-list](ng2-alfresco-tag/README.md) -- [adf-login](ng2-alfresco-login/README.md) -- [adf-webscript-get](ng2-alfresco-webscript/README.md) + @@ -88,103 +46,14 @@ ### components - -- [adf-diagram-publish-task](ng2-activiti-diagrams/README.md) -- [adf-start-process](ng2-activiti-processlist/README.md) -- [adf-process-instance-list](ng2-activiti-processlist/README.md) -- [adf-process-instance-variables](ng2-activiti-processlist/README.md) -- [adf-process-instance-tasks](ng2-activiti-processlist/README.md) -- [adf-process-instance-header](ng2-activiti-processlist/README.md) -- [adf-process-instance-details](ng2-activiti-processlist/README.md) -- [adf-process-instance-filters](ng2-activiti-processlist/README.md) -- [adf-process-instance-comments](ng2-activiti-processlist/README.md) -- [adf-process-attachment-list](ng2-activiti-processlist/README.md) -- [adf-create-process-attachment](ng2-activiti-processlist/README.md) -- [adf-form-field](ng2-activiti-form/README.md) -- [adf-start-form](ng2-activiti-form/README.md) -- [adf-content](ng2-activiti-form/README.md) -- [adf-form](ng2-activiti-form/README.md) -- [adf-form-list](ng2-activiti-form/README.md) -- [adf-diagram](ng2-activiti-diagrams/README.md) -- [adf-diagram-sequence-flow](ng2-activiti-diagrams/README.md) -- [adf-tasklist](ng2-activiti-tasklist/README.md) -- [adf-filters](ng2-activiti-tasklist/README.md) -- [adf-task-details](ng2-activiti-tasklist/README.md) -- [adf-start-task](ng2-activiti-tasklist/README.md) -- [adf-task-header](ng2-activiti-tasklist/README.md) -- [adf-people-list](ng2-activiti-tasklist/README.md) -- [adf-task-attachment-list](ng2-activiti-tasklist/README.md) -- [adf-people-search](ng2-activiti-tasklist/README.md) -- [adf-people](ng2-activiti-tasklist/README.md) -- [adf-comments](ng2-activiti-tasklist/README.md) -- [adf-create-task-attachment](ng2-activiti-tasklist/README.md) -- [adf-comment-list](ng2-activiti-tasklist/README.md) -- [adf-checklist](ng2-activiti-tasklist/README.md) -- [adf-apps](ng2-activiti-tasklist/README.md) -- [adf-analytics-report-parameters](ng2-activiti-analytics/README.md) -- [adf-analytics](ng2-activiti-analytics/README.md) -- [adf-analytics-report-list](ng2-activiti-analytics/README.md) -- [adf-analytics-report-heat-map](ng2-activiti-analytics/README.md) -- [adf-analytics-generator](ng2-activiti-analytics/README.md) + ## Services - -- [ContextMenuService](ng2-alfresco-core/src/components/context-menu/context-menu.service.ts) -- [FileUploadService](ng2-alfresco-upload/src/services/file-uploading.service.ts) -- [DocumentListService](ng2-alfresco-documentlist/src/services/document-list.service.ts) -- [NodeActionsService](ng2-alfresco-documentlist/src/services/node-actions.service.ts) -- [FolderActionsService](ng2-alfresco-documentlist/src/services/folder-actions.service.ts) -- [DocumentActionsService](ng2-alfresco-documentlist/src/services/document-actions.service.ts) -- [ProcessService](ng2-activiti-processlist/src/services/process.service.ts) -- [ProcessUploadService](ng2-activiti-processlist/src/services/process-upload.service.ts) -- [WidgetVisibilityService](ng2-activiti-form/src/services/widget-visibility.service.ts) -- [NodeService](ng2-activiti-form/src/services/node.service.ts) -- [FormService](ng2-activiti-form/src/services/form.service.ts) -- [FormRenderingService](ng2-activiti-form/src/services/form-rendering.service.ts) -- [EcmModelService](ng2-activiti-form/src/services/ecm-model.service.ts) -- [ActivitiContentService](ng2-activiti-form/src/services/activiti-content-service.ts) -- [ActivitiAlfrescoContentService](ng2-activiti-form/src/services/activiti-alfresco.service.ts) -- [CardViewUpdateService](ng2-alfresco-core/src/services/card-view-update.service.ts) -- [SearchService](ng2-alfresco-core/src/services/search.service.ts) -- [SitesApiService](ng2-alfresco-core/src/services/sites-api.service.ts) -- [SharedLinksApiService](ng2-alfresco-core/src/services/shared-links-api.service.ts) -- [SearchApiService](ng2-alfresco-core/src/services/search-api.service.ts) -- [NodesApiService](ng2-alfresco-core/src/services/nodes-api.service.ts) -- [PeopleApiService](ng2-alfresco-core/src/services/people-api.service.ts) -- [FavoritesApiService](ng2-alfresco-core/src/services/favorites-api.service.ts) -- [DiscoveryApiService](ng2-alfresco-core/src/services/discovery-api.service.ts) -- [DeletedNodesApiService](ng2-alfresco-core/src/services/deleted-nodes-api.service.ts) -- [UserPreferencesService](ng2-alfresco-core/src/services/user-preferences.service.ts) -- [UploadService](ng2-alfresco-core/src/services/upload.service.ts) -- [TranslationService](ng2-alfresco-core/src/services/translation.service.ts) -- [ThumbnailService](ng2-alfresco-core/src/services/thumbnail.service.ts) -- [StorageService](ng2-alfresco-core/src/services/storage.service.ts) -- [AlfrescoApiService](ng2-alfresco-core/src/services/alfresco-api.service.ts) -- [RenditionsService](ng2-alfresco-core/src/services/renditions.service.ts) -- [LogService](ng2-alfresco-core/src/services/log.service.ts) -- [NotificationService](ng2-alfresco-core/src/services/notification.service.ts) -- [CookieService](ng2-alfresco-core/src/services/cookie.service.ts) -- [ContentService](ng2-alfresco-core/src/services/content.service.ts) -- [AuthenticationService](ng2-alfresco-core/src/services/authentication.service.ts) -- [AlfrescoSettingsService](ng2-alfresco-core/src/services/alfresco-settings.service.ts) -- [AlfrescoContentService](ng2-alfresco-core/src/services/alfresco-content.service.ts) -- [AppConfigService](ng2-alfresco-core/src/services/app-config.service.ts) -- [DiagramsService](ng2-activiti-diagrams/src/services/diagrams.service.ts) -- [DiagramColorService](ng2-activiti-diagrams/src/services/diagram-color.service.ts) -- [RaphaelService](ng2-activiti-diagrams/src/components/raphael/raphael.service.ts) -- [BpmUserService](ng2-alfresco-userinfo/src/services/bpm-user.service.ts) -- [EcmUserService](ng2-alfresco-userinfo/src/services/ecm-user.service.ts) -- [RenderingQueueService](ng2-alfresco-viewer/src/services/rendering-queue.services.ts) -- [RatingService](ng2-alfresco-social/src/services/rating.service.ts) -- [TagService](ng2-alfresco-tag/src/services/tag.service.ts) -- [TaskListService](ng2-activiti-tasklist/src/services/tasklist.service.ts) -- [ProcessUploadService](ng2-activiti-tasklist/src/services/process-upload.service.ts) -- [PeopleService](ng2-activiti-tasklist/src/services/people.service.ts) -- [AnalyticsService](ng2-activiti-analytics/src/services/analytics.service.ts) + You can browse all the components at the following address: diff --git a/ng2-components/ng2-activiti-analytics/README.md b/ng2-components/ng2-activiti-analytics/README.md index e6e2bfa8c8..fee1c5fa05 100644 --- a/ng2-components/ng2-activiti-analytics/README.md +++ b/ng2-components/ng2-activiti-analytics/README.md @@ -1,72 +1,41 @@ -# Activiti Analytics Components +# Activiti Analytics library + +Contains the Activiti Analytics component and other related components. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Activiti Analytics List Component](#activiti-analytics-list-component) - * [Properties](#properties) - * [Events](#events) - [Activiti Analytics Component](#activiti-analytics-component) - * [Properties](#properties-1) - * [Events](#events-1) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) +- [Activiti Analytics List Component](#activiti-analytics-list-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) - [Analytics Generator Component](#analytics-generator-component) - * [Properties](#properties-2) - * [Events](#events-2) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) + * [Basic Usage](#basic-usage-2) + + [Properties](#properties-2) + + [Events](#events-2) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites - -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configurations, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-activiti-analytics -``` - -## Activiti Analytics List Component - -The component shows the list of all the available reports - -```html - - -``` - -### Properties - -| Name | Type | Required | Default | Description | -| --- | --- | --- | --- | --- | -| appId | string | optional | | The application id | -| layoutType | string | required | | Define the layout of the apps. There are two possible values: GRID or LIST. LIST is the default value| -| selectFirst | boolean | optional | false | Change the value to true if you want to select the first item in the list as default| - -### Events - -| Name | Description | -| --- | --- | -| onSuccess | The event is emitted when the report list is loaded | -| onError | The event is emitted when an error occurs during the loading | -| reportClick | The event is emitted when the report in the list is selected | - ## Activiti Analytics Component The component shows the charts related to the reportId passed as input +### Basic Usage + ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | @@ -94,7 +63,7 @@ You can also hide chart parameters UI by setting the `hideParameters` to `true`: ![Analytics-without-parameters](docs/assets/analytics-without-parameters.png) -### Events +#### Events | Name | Description | | --- | --- | @@ -103,10 +72,40 @@ You can also hide chart parameters UI by setting the `hideParameters` to `true`: | reportSaved | The event is emitted when a report is saved | | reportDeleted | The event is emitted when a report is deleted | +## Activiti Analytics List Component + +The component shows the list of all the available reports + +### Basic Usage + +```html + + +``` + +#### Properties + +| Name | Type | Required | Default | Description | +| --- | --- | --- | --- | --- | +| appId | string | optional | | The application id | +| layoutType | string | required | | Define the layout of the apps. There are two possible values: GRID or LIST. LIST is the default value| +| selectFirst | boolean | optional | false | Change the value to true if you want to select the first item in the list as default| + +#### Events + +| Name | Description | +| --- | --- | +| onSuccess | The event is emitted when the report list is loaded | +| onError | The event is emitted when an error occurs during the loading | +| reportClick | The event is emitted when the report in the list is selected | + ## Analytics Generator Component The component generates and shows the charts +### Basic Usage + ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | -- | | reportId | string | The report id | | reportParamQuery | ReportQuery | The object contains all the parameters that the report needs | -### Events +#### Events | Name | Description | | --- | --- | | onSuccess | Raised when the charts are loaded | | onError | Raised when an error occurs during the loading | -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configurations, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-activiti-analytics +``` + +### Build from sources You can build the component from sources with the following commands: @@ -140,7 +154,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -149,7 +163,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -159,6 +173,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-activiti-diagrams/README.md b/ng2-components/ng2-activiti-diagrams/README.md index 4876506240..99ec59b036 100644 --- a/ng2-components/ng2-activiti-diagrams/README.md +++ b/ng2-components/ng2-activiti-diagrams/README.md @@ -1,38 +1,31 @@ -# Activiti Diagrams Component +# Activiti Diagrams library + +Contains the Activiti Diagram component. -- [Prerequisites](#prerequisites) -- [Install](#install) - [Activiti Diagram Component](#activiti-diagram-component) - * [Properties](#properties) - * [Events](#events) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites - -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configurations, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-activiti-diagrams -``` - ## Activiti Diagram Component +### Basic Usage + This component shows the diagram of a process. ```html @@ -49,7 +42,7 @@ The below component shows the diagram of a running process instance with the act ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | -- | @@ -60,14 +53,29 @@ The below component shows the diagram of a running process instance with the act | width | number | | | height | number | | -### Events +#### Events | Name | Description | | --- | --- | | onSuccess | Raised when the diagrams elements are loaded | | onError | Raised when an error occurs during loading | -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configurations, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-activiti-diagrams +``` + +### Build from sources You can build the component from sources with the following commands: @@ -79,7 +87,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -88,7 +96,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -98,6 +106,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-activiti-form/README.md b/ng2-components/ng2-activiti-form/README.md index ab6aa26ef0..5018f424e1 100644 --- a/ng2-components/ng2-activiti-form/README.md +++ b/ng2-components/ng2-activiti-form/README.md @@ -1,4 +1,6 @@ -# APS Form Component +# APS Form library + +Contains the Activiti Form component and other related components and services. @@ -7,40 +9,45 @@ - [Library Contents](#library-contents) * [Components](#components) * [Services](#services) -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Form Component](#form-component) - * [Properties](#properties) +- [Activiti Form component](#activiti-form-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Advanced properties](#advanced-properties) + + [Events](#events) + * [Details](#details) + + [Custom empty form template](#custom-empty-form-template) + + [Controlling outcome execution behaviour](#controlling-outcome-execution-behaviour) + [Form Field Validators](#form-field-validators) - [Custom set of validators](#custom-set-of-validators) - [Custom validator example](#custom-validator-example) - * [Advanced properties](#advanced-properties) - * [Events](#events) - * [Custom empty form template](#custom-empty-form-template) - * [Controlling outcome execution behaviour](#controlling-outcome-execution-behaviour) - [Activiti Content Component](#activiti-content-component) - * [Properties](#properties-1) - * [Events](#events-1) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) - [ADF Form List Component](#adf-form-list-component) - * [Properties](#properties-2) + * [Basic Usage](#basic-usage-2) + + [Properties](#properties-2) - [FormService Service](#formservice-service) - * [Events](#events-2) - * [Methods](#methods) -- [Common scenarios](#common-scenarios) - * [Changing field value based on another field](#changing-field-value-based-on-another-field) - * [Listen all form Events](#listen-all-form-events) + * [Basic Usage](#basic-usage-3) + + [Events](#events-2) + + [Methods](#methods) +- [Other documentation](#other-documentation) + * [Common scenarios](#common-scenarios) + + [Changing field value based on another field](#changing-field-value-based-on-another-field) + + [Listen all form Events](#listen-all-form-events) - [See also](#see-also) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -See it live: [Form Quickstart](https://embed.plnkr.co/YSLXTqb3DtMhVJSqXKkE/) - ## Library Contents ### Components @@ -57,22 +64,11 @@ See it live: [Form Quickstart](https://embed.plnkr.co/YSLXTqb3DtMhVJSqXKkE/) - NodeService - WidgetVisibilityService -## Prerequisites +## Activiti Form component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +The component shows a Form from Activiti (see it live: [Form Quickstart](https://embed.plnkr.co/YSLXTqb3DtMhVJSqXKkE/)) -> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-activiti-form -``` - -## Form Component - -The component shows a Form from Activiti +### Basic Usage ```html ``` -### Properties - -The recommended set of properties can be found in the following table: +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -169,7 +163,116 @@ The recommended set of properties can be found in the following table: | saveMetadata | boolean | false | Store the value of the form as metadata. | | path | string | | Path of the folder where to store the metadata. | | nameNode | string | true | Name to assign to the new node where the metadata are stored. | -| fieldValidators | FormFieldValidator[] | *see below* | Contains a list of form field validator instances. | +| fieldValidators | FormFieldValidator[] | See [Form Field Validators](#form-field-validators) section below | Contains a list of form field validator instances. | + +#### Advanced properties + + The following properties are for complex customisation purposes: + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| form | FormModel | | Underlying form model instance. | +| showDebugButton | boolean | false | Toggle debug options. | +| debugMode | boolean | false | Toggle debug mode, allows displaying additional data for development and debugging purposes. | + +#### Events + +| Name | Return Type | Description | +| --- | --- | --- | +| formLoaded | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is loaded or reloaded. | +| formSaved | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is submitted with `Save` or custom outcomes. | +| formCompleted | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is submitted with `Complete` outcome. | +| formDataRefreshed | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form values are refreshed due to a data property change | +| executeOutcome | [FormOutcomeEvent](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form-outcome-event.model.ts) | Invoked when any outcome is executed, default behaviour can be prevented via `event.preventDefault()` | +| onError | any | Invoked at any error | + +### Details + +All `form*` events receive an instance of the `FormModel` as event argument for ease of development: + +**MyView.component.html** + +```html + + +``` + +**MyView.component.ts** + +```ts +onFormSaved(form: FormModel) { + console.log(form); +} +``` + +#### Custom empty form template + +You can add a template that will be show if no form definition has been found + +```html + + +
+

Empty form

+
+ + + +``` + +#### Controlling outcome execution behaviour + +If absolutely needed it is possible taking full control over form outcome execution by means of `executeOutcome` event. +This event is fired upon each outcome execution, both system and custom ones. + +You can prevent default behaviour by calling `event.preventDefault()`. +This allows for example having custom form validation scenarios and/or additional validation summary presentation. + +Alternatively you may want just running additional code on outcome execution without suppressing default one. + +**MyView.component.html** + +```html + + +``` + +**MyView.component.ts** + +```ts +import { FormOutcomeEvent } from 'ng2-activiti-form'; + +export class MyView { + + validateForm(event: FormOutcomeEvent) { + let outcome = event.outcome; + + // you can also get additional properties of outcomes + // if you defined them within outcome definition + + if (outcome) { + let form = outcome.form; + if (form) { + // check/update the form here + event.preventDefault(); + } + } + } + +} +``` + +There are two additional functions that can be of a great value when controlling outcomes: + +- `saveTaskForm()` - saves current form +- `completeTaskForm(outcome?: string)` - save and complete form with a given outcome name + +**Please note that if `event.preventDefault()` is not called then default outcome behaviour +will also be executed after your custom code.** #### Form Field Validators @@ -301,124 +404,19 @@ Now if you run the application and try to enter "admin" in one of the text field ![](docs/assets/demo-validator.png) -### Advanced properties - - The following properties are for complex customisation purposes: - -| Name | Type | Default | Description | -| --- | --- | --- | --- | -| form | FormModel | | Underlying form model instance. | -| showDebugButton | boolean | false | Toggle debug options. | -| debugMode | boolean | false | Toggle debug mode, allows displaying additional data for development and debugging purposes. | - -### Events - -| Name | Return Type | Description | -| --- | --- | --- | -| formLoaded | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is loaded or reloaded. | -| formSaved | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is submitted with `Save` or custom outcomes. | -| formCompleted | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form is submitted with `Complete` outcome. | -| formDataRefreshed | [FormModel](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form.model.ts) | Invoked when form values are refreshed due to a data property change | -| executeOutcome | [FormOutcomeEvent](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-activiti-form/src/components/widgets/core/form-outcome-event.model.ts) | Invoked when any outcome is executed, default behaviour can be prevented via `event.preventDefault()` | -| onError | any | Invoked at any error | - -All `form*` events receive an instance of the `FormModel` as event argument for ease of development: - -**MyView.component.html** - -```html - - -``` - -**MyView.component.ts** - -```ts -onFormSaved(form: FormModel) { - console.log(form); -} -``` - -### Custom empty form template - -You can add a template that will be show if no form definition has been found - -```html - - -
-

Empty form

-
- - - -``` - -### Controlling outcome execution behaviour - -If absolutely needed it is possible taking full control over form outcome execution by means of `executeOutcome` event. -This event is fired upon each outcome execution, both system and custom ones. - -You can prevent default behaviour by calling `event.preventDefault()`. -This allows for example having custom form validation scenarios and/or additional validation summary presentation. - -Alternatively you may want just running additional code on outcome execution without suppressing default one. - -**MyView.component.html** - -```html - - -``` - -**MyView.component.ts** - -```ts -import { FormOutcomeEvent } from 'ng2-activiti-form'; - -export class MyView { - - validateForm(event: FormOutcomeEvent) { - let outcome = event.outcome; - - // you can also get additional properties of outcomes - // if you defined them within outcome definition - - if (outcome) { - let form = outcome.form; - if (form) { - // check/update the form here - event.preventDefault(); - } - } - } - -} -``` - -There are two additional functions that can be of a great value when controlling outcomes: - -- `saveTaskForm()` - saves current form -- `completeTaskForm(outcome?: string)` - save and complete form with a given outcome name - -**Please note that if `event.preventDefault()` is not called then default outcome behaviour -will also be executed after your custom code.** - ## Activiti Content Component The component shows the content preview. +### Basic Usage + ```html - ``` -### Properties +#### Properties The recommended set of properties can be found in the following table: @@ -426,7 +424,7 @@ The recommended set of properties can be found in the following table: | --- | --- | --- | --- | | contentId | string | | The content id to show. | -### Events +#### Events | Name | Description | | --- | --- | @@ -436,13 +434,15 @@ The recommended set of properties can be found in the following table: The component shows the activiti forms as a list. +### Basic Usage + ```html ``` -### Properties +#### Properties The recommended set of properties can be found in the following table: @@ -452,6 +452,8 @@ The recommended set of properties can be found in the following table: ## FormService Service +### Basic Usage + ```ts import { FormService, FormEvent, FormFieldEvent } from 'ng2-activiti-form'; @@ -477,7 +479,7 @@ class MyComponent { } ``` -### Events +#### Events | Name | Args Type | Description | | --- | --- | --- | @@ -492,7 +494,7 @@ class MyComponent { | validateForm | ValidateFormEvent | Raised each time a form is validated. You can use it to provide custom validation or prevent default behaviour. | | validateFormField | ValidateFormFieldEvent | Raised each time a form field is validated. You can use it to provide custom validation or prevent default behaviour.| -### Methods +#### Methods | Name | Params | Returns | Description | | --- | --- | --- | --- | @@ -519,9 +521,11 @@ class MyComponent { | getWorkflowGroups\ | (filter: string, groupId?: string) | Observable\ | | | getWorkflowUsers\ | (filter: string, groupId?: string) | Observable\ | | -## Common scenarios +## Other documentation -### Changing field value based on another field +### Common scenarios + +#### Changing field value based on another field Create a simple Form with a dropdown widget (id: `type`), and a multiline text (id: `description`). @@ -544,7 +548,7 @@ The result should be as following: ![](docs/assets/form-service-sample-01.png) -### Listen all form Events +#### Listen all form Events If you want to listen all the events fired in the form you can subscribe to this Subject : @@ -560,7 +564,22 @@ formService.formEvents.subscribe((event: Event) => { - [Form Stencils with Angular 2](docs/stencils.md) - [Form Extensibility and Customisation](docs/extensibility.md). -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan to use this component with projects generated by Angular CLI, you can read more in [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-activiti-form +``` + +### Build from sources You can build the component from sources with the following commands: @@ -572,7 +591,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -581,7 +600,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -591,6 +610,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) \ No newline at end of file diff --git a/ng2-components/ng2-activiti-processlist/README.md b/ng2-components/ng2-activiti-processlist/README.md index 0a9d1ab98a..2441e92bdd 100644 --- a/ng2-components/ng2-activiti-processlist/README.md +++ b/ng2-components/ng2-activiti-processlist/README.md @@ -1,71 +1,75 @@ -# Activiti Process List Component +# Activiti Process List library + +Contains the Activiti Process Instance List component and other related components and classes. -- [Prerequisites](#prerequisites) -- [Install](#install) - [Activiti Process Instance List](#activiti-process-instance-list) - * [Properties](#properties) - * [Events](#events) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) - [Process Filters Component](#process-filters-component) - * [Properties](#properties-1) - * [Events](#events-1) - * [How filter the activiti process filters](#how-filter-the-activiti-process-filters) -- [FilterParamsModel](#filterparamsmodel) - * [How to create an accordion menu with the processes filter](#how-to-create-an-accordion-menu-with-the-processes-filter) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) + * [Details](#details-1) + + [How filter the activiti process filters](#how-filter-the-activiti-process-filters) + + [FilterParamsModel](#filterparamsmodel) + + [How to create an accordion menu with the processes filter](#how-to-create-an-accordion-menu-with-the-processes-filter) - [Start Process component](#start-process-component) - * [Properties](#properties-2) - * [Events](#events-2) + * [Basic Usage](#basic-usage-2) + + [Properties](#properties-2) + + [Events](#events-2) - [Process Details component](#process-details-component) - * [Properties](#properties-3) - * [Events](#events-3) + * [Basic Usage](#basic-usage-3) + + [Properties](#properties-3) + + [Events](#events-3) - [Process Instance Details Header component](#process-instance-details-header-component) - * [Properties](#properties-4) - * [Events](#events-4) + * [Basic Usage](#basic-usage-4) + + [Properties](#properties-4) + + [Events](#events-4) - [Process Instance Tasks component](#process-instance-tasks-component) - * [Properties](#properties-5) - * [Events](#events-5) + * [Basic Usage](#basic-usage-5) + + [Properties](#properties-5) + + [Events](#events-5) - [Process Instance Comments component](#process-instance-comments-component) - * [Properties](#properties-6) + * [Basic Usage](#basic-usage-6) + + [Properties](#properties-6) - [Process Attachment List component](#process-attachment-list-component) - * [Properties](#properties-7) - * [Events](#events-6) + * [Basic Usage](#basic-usage-7) + + [Properties](#properties-7) + + [Events](#events-6) - [Create Process Attachment component](#create-process-attachment-component) - * [Properties](#properties-8) - * [Events](#events-7) + * [Basic Usage](#basic-usage-8) + + [Properties](#properties-8) + + [Events](#events-7) - [Process Audit Directive](#process-audit-directive) - * [Properties](#properties-9) + * [Basic Usage](#basic-usage-9) + + [Properties](#properties-9) + [Events](#events-8) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -Displays lists of process instances both active and completed, using any defined process filter, and renders details for any chosen instance. - -## Prerequisites - -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-activiti-processlist -``` + ## Activiti Process Instance List This component renders a list containing all the process instances matched by the parameters specified. +### Basic Usage + **app.component.html** ```html @@ -75,7 +79,7 @@ This component renders a list containing all the process instances matched by th ``` -### Properties +#### Properties | Name | Description | | --- | --- | @@ -83,9 +87,17 @@ This component renders a list containing all the process instances matched by th | processDefinitionKey | The processDefinitionKey of the process. | | state | Define state of the processes. Possible values are `running`, `completed` and `all` | | sort | Define sort of the processes. Possible values are `created-desc`, `created-asc`, `ended-desc`, `ended-asc` | -| schemaColumn | List of columns to display in the process instances datatable | +| schemaColumn | List of columns to display in the process instances datatable (see the [Details](#details) section below) | -Example: +#### Events + +- **rowClick**: Emitted when a row in the process list is clicked +- **onSuccess**: Emitted when the list of process instances has been loaded successfully from the server +- **onError**: Emitted when an error is encountered loading the list of process instances from the server + +### Details + +Example value for the schemaColumn property (see [Properties](#properties) section above): ```json [ @@ -96,20 +108,11 @@ Example: ] ``` -### Events - -- **rowClick**: Emitted when a row in the process list is clicked -- **onSuccess**: Emitted when the list of process instances has been loaded successfully from the server -- **onError**: Emitted when an error is encountered loading the list of process instances from the server - ## Process Filters Component -Process filters are a collection of criteria used to filter process instances, which may be customized -by users. This component displays a list of available filters and allows the user to select any given -filter as the active filter. +Collection of criteria used to filter process instances, which may be customized by users. -The most common usage is in driving a process instance list to allow the user to choose which -process instances are displayed in the list. +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Description | -| --- | --- | --- | --- | +| --- | --- | --- | | filterParam | [FilterParamsModel](#filterparamsmodel) | The params to filter the task filter. If there is no match the default one (first filter of the list) is selected | | appId | string | Display filters available to the current user for the application with the specified ID. | | appName | string | Display filters available to the current user for the application with the specified name. | @@ -128,7 +131,7 @@ process instances are displayed in the list. If both `appId` and `appName` are specified then `appName` will take precedence and `appId` will be ignored. -### Events +#### Events | Name | Description | | --- | --- | @@ -136,7 +139,15 @@ If both `appId` and `appName` are specified then `appName` will take precedence | onError | Raised when an error occurs | | filterClick | Raised when the user selects a filter from the list | -### How filter the activiti process filters +### Details + +This component displays a list of available filters and allows the user to select any given +filter as the active filter. + +The most common usage is in driving a process instance list to allow the user to choose which +process instances are displayed in the list. + +#### How filter the activiti process filters ```html ``` -You can use inside the filterParam one of the following property. +You can use inside the filterParam one of the properties defined by [FilterParamsModel](#filterparamsmodel) (see below). -## FilterParamsModel +#### FilterParamsModel ```json { @@ -162,7 +173,7 @@ You can use inside the filterParam one of the following property. | name | string | The name of the task filter, lowercase is checked. | | index | number | Zero-based position of the filter in the array. | -### How to create an accordion menu with the processes filter +#### How to create an accordion menu with the processes filter You can create an accordion menu using the AccordionComponent that wrap the activiti task filter. The AccordionComponent is exposed by the alfresco-core. @@ -188,6 +199,8 @@ The AccordionComponent is exposed by the alfresco-core. Displays Start Process, allowing the user to specify some basic details needed to start a new process instance. +### Basic Usage + ```html @@ -195,14 +208,14 @@ Displays Start Process, allowing the user to specify some basic details needed t ``` ![adf-start-process ](docs/assets/start-process.png) -### Properties +#### Properties | Name | Description | | --- | --- | | appId | (required): Limit the list of processes which can be started to those contained in the specified app | | variables | Variables in input to the process [RestVariable](https://github.com/Alfresco/alfresco-js-api/tree/master/src/alfresco-activiti-rest-api/docs/RestVariable.md)| -### Events +#### Events | Name | Description | | --- | --- | @@ -212,7 +225,9 @@ Displays Start Process, allowing the user to specify some basic details needed t ## Process Details component -This component displays detailed information on a specified process instance +Displays detailed information on a specified process instance + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | | processInstanceId | string | (required): The numeric ID of the process instance to display | -### Events +#### Events | Name | Description | | --- | --- | @@ -236,7 +251,9 @@ This component displays detailed information on a specified process instance ## Process Instance Details Header component -This is a sub-component of the process details component, which renders some general information about the selected process. +Sub-component of the process details component, which renders some general information about the selected process. + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | | processInstanceId | string | (**required**): The ID of the process instance to display tasks for | | showRefreshButton | boolean | (default: `true`): Whether to show a refresh button next to the list of tasks to allow this to be updated from the server | -### Events +#### Events | Name | Description | | --- | --- | @@ -283,13 +302,15 @@ Lists both the active and completed tasks associated with a particular process i Displays comments associated with a particular process instance and allows the user to add new comments +### Basic Usage + ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | @@ -297,7 +318,9 @@ Displays comments associated with a particular process instance and allows the u ## Process Attachment List component -This component displays attached documents on a specified process instance +Displays attached documents on a specified process instance + +### Basic Usage ```html If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-activiti-processlist +``` + +### Build from sources You can build component from sources with the following commands: @@ -394,7 +436,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -403,7 +445,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -413,6 +455,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-activiti-tasklist/README.md b/ng2-components/ng2-activiti-tasklist/README.md index 53aeb2a54e..53b8494545 100644 --- a/ng2-components/ng2-activiti-tasklist/README.md +++ b/ng2-components/ng2-activiti-tasklist/README.md @@ -1,90 +1,99 @@ -# APS Task List Component +# Activiti Task List library + +Contains the Activiti Task List component and other related components and classes. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Activiti Task List](#activiti-task-list) - * [DataColumn Properties](#datacolumn-properties) - * [Events](#events) - * [Properties](#properties) -- [Activiti Task Details](#activiti-task-details) - * [Properties](#properties-1) - * [Events](#events-1) - * [Custom 'empty Activiti Task Details' template](#custom-empty-activiti-task-details-template) +- [Activiti Task List component](#activiti-task-list-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) + + [DataTableAdapter example](#datatableadapter-example) + + [DataColumn Properties](#datacolumn-properties) +- [Activiti Task Details component](#activiti-task-details-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) + * [Details](#details-1) + + [Custom 'empty Activiti Task Details' template](#custom-empty-activiti-task-details-template) - [Activiti Apps Component](#activiti-apps-component) - * [Properties](#properties-2) - * [Events](#events-2) - * [How filter the activiti apps](#how-filter-the-activiti-apps) -- [Activiti Filter](#activiti-filter) - * [Properties](#properties-3) - * [Events](#events-3) - * [How filter the activiti task filters](#how-filter-the-activiti-task-filters) - * [FilterParamsModel](#filterparamsmodel) - * [How to create an accordion menu with the task filter](#how-to-create-an-accordion-menu-with-the-task-filter) + * [Basic Usage](#basic-usage-2) + + [Properties](#properties-2) + + [Events](#events-2) + * [Details](#details-2) + + [How filter the activiti apps](#how-filter-the-activiti-apps) +- [Activiti Filter component](#activiti-filter-component) + * [Basic Usage](#basic-usage-3) + + [Properties](#properties-3) + + [Events](#events-3) + * [Details](#details-3) + + [How filter the activiti task filters](#how-filter-the-activiti-task-filters) + + [FilterParamsModel](#filterparamsmodel) + + [How to create an accordion menu with the task filter](#how-to-create-an-accordion-menu-with-the-task-filter) - [Activiti Checklist Component](#activiti-checklist-component) - * [Properties](#properties-4) + * [Basic Usage](#basic-usage-4) + + [Properties](#properties-4) - [Task Attachment List Component](#task-attachment-list-component) - * [Properties](#properties-5) - * [Events](#events-4) + * [Basic Usage](#basic-usage-5) + + [Properties](#properties-5) + + [Events](#events-4) - [Create Task Attachment Component](#create-task-attachment-component) - * [Properties](#properties-6) + * [Basic Usage](#basic-usage-6) + + [Properties](#properties-6) + [Events](#events-5) -- [Activiti Task Header](#activiti-task-header) - * [Properties](#properties-7) - * [Events](#events-6) -- [TaskDetailsModel](#taskdetailsmodel) +- [Activiti Task Header component](#activiti-task-header-component) + * [Basic Usage](#basic-usage-7) + + [Properties](#properties-7) + + [Events](#events-6) + * [Details](#details-4) + + [TaskDetailsModel](#taskdetailsmodel) - [Task People Component](#task-people-component) - * [Properties](#properties-8) + * [Basic Usage](#basic-usage-8) + + [Properties](#properties-8) + [Events](#events-7) + * [Details](#details-5) + [How to customize the people component behavior](#how-to-customize-the-people-component-behavior) + [Involve People single click and close search](#involve-people-single-click-and-close-search) + [Involve People single click without close search](#involve-people-single-click-without-close-search) + [Involve People double click and close search](#involve-people-double-click-and-close-search) + [Involve People double double without close search](#involve-people-double-double-without-close-search) - [ADF Comments Component](#adf-comments-component) - * [Properties](#properties-9) + * [Basic Usage](#basic-usage-9) + + [Properties](#properties-9) + [Events](#events-8) - [Start Task Component](#start-task-component) - * [Properties](#properties-10) + * [Basic Usage](#basic-usage-10) + + [Properties](#properties-10) + [Events](#events-9) -- [Task Audit Directive](#task-audit-directive) - * [Properties](#properties-11) +- [People Search component](#people-search-component) + * [Basic Usage](#basic-usage-11) + + [Properties](#properties-11) + [Events](#events-10) -- [People Search](#people-search) - * [Properties](#properties-12) - * [Events](#events-11) - * [How to use](#how-to-use) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) + * [Details](#details-6) +- [Task Audit Directive](#task-audit-directive) + * [Basic Usage](#basic-usage-12) + + [Properties](#properties-12) + + [Events](#events-11) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -Displays lists of process instances both active and completed, using any defined process filter, and -render details of any chosen instance. +## Activiti Task List component -## Prerequisites +Renders a list containing all the tasks matched by the parameters specified. -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-activiti-tasklist -``` - -## Activiti Task List - -This component renders a list containing all the tasks matched by the parameters specified. +### Basic Usage ```html ``` -### DataColumn Properties +#### Properties + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| appId | string || The id of the app. | +| processDefinitionKey | string || The processDefinitionKey of the process. | +| processInstanceId | string || The processInstanceId of the process. | +| assignment | string || The assignment of the process.
    Possible values are:
  • assignee : where the current user is the assignee
  • candidate: where the current user is a task candidate
  • group_x: where the task is assigned to a group where the current user is a member of.
  • no value: where the current user is involved
| +| state | string || Define state of the processes. Possible values are: `completed`, `active` | +| hasIcon | boolean | true | Toggle the icon on the left . | +| landingTaskId | string | | Define which task id should be selected after the reloading. If the task id doesn't exist or nothing is passed it will select the first task | +| sort | string | | Define the sort of the processes. Possible values are : `created-desc`, `created-asc`, `due-desc`, `due-asc` | +| data | DataTableAdapter | | JSON object that represent the number and the type of the columns that you want show (see the [example](#datatableadapter-example) section below) | + +#### Events + +| Name | Description | +| --- | --- | +| onSuccess | Raised when the task list is loaded | +| rowClick | Raised when the task in the list is clicked | + +### Details + +This component displays lists of process instances both active and completed, using any defined process filter, and +render details of any chosen instance. + +#### DataTableAdapter example + +```json +[ + {"type": "text", "key": "id", "title": "Id"}, + {"type": "text", "key": "name", "title": "Name", "cssClass": "full-width name-column", "sortable": true}, + {"type": "text", "key": "formKey", "title": "Form Key", "sortable": true}, + {"type": "text", "key": "created", "title": "Created", "sortable": true} +] +``` + +#### DataColumn Properties Here's the list of available properties you can define for a Data Column definition. @@ -120,41 +166,11 @@ Here's the list of available properties you can define for a Data Column definit | sr-title | string | | Screen reader title, used for accessibility purposes | | class | string | | Additional CSS class to be applied to column (header and cells) | -### Events +## Activiti Task Details component -| Name | Description | -| --- | --- | -| onSuccess | Raised when the task list is loaded | -| rowClick | Raised when the task in the list is clicked | +Shows the details of the task id passed in input -### Properties - -| Name | Type | Default | Description | -| --- | --- | --- | --- | -| appId | string || The id of the app. | -| processDefinitionKey | string || The processDefinitionKey of the process. | -| processInstanceId | string || The processInstanceId of the process. | -| assignment | string || The assignment of the process.
    Possible values are:
  • assignee : where the current user is the assignee
  • candidate: where the current user is a task candidate
  • group_x: where the task is assigned to a group where the current user is a member of.
  • no value: where the current user is involved
| -| state | string || Define state of the processes. Possible values are: `completed`, `active` | -| hasIcon | boolean | true | Toggle the icon on the left . | -| landingTaskId | string | | Define which task id should be selected after the reloading. If the task id doesn't exist or nothing is passed it will select the first task | -| sort | string | | Define the sort of the processes. Possible values are : `created-desc`, `created-asc`, `due-desc`, `due-asc` | -| data | DataTableAdapter | | JSON object that represent the number and the type of the columns that you want show | - -Example: - -```json -[ - {"type": "text", "key": "id", "title": "Id"}, - {"type": "text", "key": "name", "title": "Name", "cssClass": "full-width name-column", "sortable": true}, - {"type": "text", "key": "formKey", "title": "Form Key", "sortable": true}, - {"type": "text", "key": "created", "title": "Created", "sortable": true} -] -``` - -## Activiti Task Details - -The component shows the details of the task id passed in input +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -181,7 +197,7 @@ The component shows the details of the task id passed in input | showChecklist | boolean | true | Toggle `Checklist` feature for Header component | | fieldValidators | FormFieldValidator[] | [] | Field validators for use with the form. | -### Events +#### Events | Name | Description | | --- | --- | @@ -192,7 +208,9 @@ The component shows the details of the task id passed in input | executeOutcome | Raised when any outcome is executed, default behaviour can be prevented via `event.preventDefault()` | | onError | Raised at any error | -### Custom 'empty Activiti Task Details' template +### Details + +#### Custom 'empty Activiti Task Details' template By default the Activiti Task Details provides the following message for the empty task details: @@ -217,7 +235,9 @@ Note that can put any HTML content as part of the template, including other Angu ## Activiti Apps Component -The component shows all the available apps. +Shows all available apps. + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | | layoutType | string | (**required**) Define the layout of the apps. There are two possible values: GRID or LIST. | | filtersAppId | Object | Provide a way to filter the apps to show. | -### Events +#### Events | Name | Description | | --- | --- | | appClick | Raised when an app entry is clicked | -### How filter the activiti apps +### Details + +#### How filter the activiti apps If you want to show some specific apps you can specify them through the filtersAppId parameters @@ -267,15 +289,17 @@ You can use inside the filter one of the following property } ``` -## Activiti Filter +## Activiti Filter component -The component shows all the available filters. +Shows all available filters. + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | @@ -286,7 +310,7 @@ The component shows all the available filters. If both `appId` and `appName` are specified then `appName` will take precedence and `appId` will be ignored. -### Events +#### Events | Name | Description | | --- | --- | @@ -294,7 +318,9 @@ If both `appId` and `appName` are specified then `appName` will take precedence | onSuccess | Raised when the list is loaded | | onError | Raised if there is an error during the loading | -### How filter the activiti task filters +### Details + +#### How filter the activiti task filters ```html ``` -### Properties +#### Properties | Name | Type | Description | | --- | --- | --- | @@ -363,9 +391,12 @@ The component shows the checklist task functionality. | readOnlyForm | boolean | Toggle readonly state of the form. Enforces all form widgets render readonly if enabled. | | assignee | string | (**required**) The assignee id where the subtasks are assigned to. | + ## Task Attachment List Component -This component displays attached documents on a specified task +Displays attached documents on a specified task + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -437,13 +471,18 @@ The purpose of the component is to populate the local variable called `propertie ![adf-task-header](docs/assets/adf-task-header.png) -### Events +#### Events | Name | Description | | --- | --- | | claim | Raised when the task is claimed. | -## TaskDetailsModel +### Details + +The purpose of the component is to populate the local variable called `properties` (array of CardViewModel), with all the information that we want to display. + + +#### TaskDetailsModel ```json { @@ -457,7 +496,9 @@ The purpose of the component is to populate the local variable called `propertie ## Task People Component -This component displays involved users to a specified task +Displays involved users to a specified task + +### Basic Usage ```html +``` + +#### Properties + +| Name | Type | Description | +| --- | --- | --- | +| results | Observable | The params to show people list | + +#### Events + +| Name | Description | +| --- | --- | +| searchPeople | Raised when the search people with new keyword | +| success | Raised when select the user and click action button | +| closeSearch | Raised when click the clse button | + +### Details + + ```html + + {{ 'TASK_DETAILS.LABELS.ADD_PEOPLE' | translate }} + {{ 'PEOPLE.ADD_USER' | translate }} + + +``` + ## Task Audit Directive -This directive provide a way to fetch the Task Audit information in the pdf or json format. +Provides a way to fetch the Task Audit information in the pdf or json format. + +### Basic Usage ```html + + + + +``` + +#### Dropdown menu + +You can use the following example to create a dropdown menu: + +```html + + ... + + + + + + + + +``` + +The code above is based on the `` component from the `@angular/material` library. You can use any custom menu component as well. + +![](docs/adf-toolbar-03.png) + +Once you click the menu button you should see the following menu items as defined earlier: + +![](docs/adf-toolbar-04.png) + +#### Custom color + +Besides the default color you can use 'primary', 'accent', or 'warn' values: + +Depending on the overall application theme the colors of the toolbar should change. + +For example: + +![](docs/adf-toolbar-05.png) + +![](docs/adf-toolbar-06.png) + +![](docs/adf-toolbar-07.png) + +## Accordion Component + +Creates an accordion menu, optionally with a custom header and icon. + +### Basic Usage + +```html + + + + + +``` + +```ts +@Component({ + selector: 'my-component' +}) +export class MyComponent implements OnInit { + + titleHeading: string; + + constructor() { + this.titleHeading = 'My Group'; + } + +} +``` + +#### Properties + +| Name | Type | Description | | --- | --- | --- | -| toolbar | toolbar component | [Docs](src/components/toolbar/toolbar.md) | -| node-permission | disable elements based on node permissions | [Docs](src/directives/node-permission.md) +| heading | string | The header title. | +| isSelected | boolean | Define if the accordion group is selected or not. | +| headingIcon | string | The material design icon. | +| hasAccordionIcon | boolean | Define if the accordion (expand) icon needs to be shown or not, the default value is true | + +## Card View component + +Displays a configurable property list renderer. + +![adf-custom-view](docs/assets/adf-custom-view.png) + +### Basic Usage + +```html + + + +``` + +#### Properties + +| Name | Type | Description | +| --- | --- | --- | +| properties | [CardViewItem](#cardviewitem)[] | (**required**) The custom view to render | +| editable | boolean | If the component editable or not | + +### Details + +You define the property list, the CardViewComponent does the rest. Each property represents a card view item (a row) in the card view component. At the time of writing two different kind of card view item (property type) is supported out of the box ([text](#card-text-item) item and [date](#card-date-item) item) but you can define your own custom types as well. + +#### Editing + +The card view can optionally allow its properties to be edited. You can control the editing of the properties in two level. +- **global level** - *via the editable parameter of the card-view.component* +- **property level** - *in each property via the editable attribute* + +If you set the global editable parameter to false, no properties can be edited regardless of what is set inside the property. + +#### Defining properties + +Properties is an array of models which one by one implements the CardViewItem interface. + +```js +export interface CardViewItem { + label: string; + value: any; + key: string; + default?: any; + type: string; + displayValue: string; + editable?: boolean; +} +``` + +At the moment three models are defined out of the box: + +- **[CardViewTextItemModel](#card-text-item)** - *for text items* +- **[CardViewMapItemModel](#card-map-item)** - *for map items* +- **[CardViewDateItemModel](#card-date-item)** - *for date items* + +Each of them are extending the abstract CardViewBaseItemModel class, and each of them are adding some custom functionality to the basic behaviour. + +```js + this.properties = [ + new CardViewTextItemModel({ + label: 'Name', + value: 'Spock', + key: 'name', + default: 'default bar' , + multiline: false + }), + new CardViewMapItemModel({ + label: 'My map', + value: new Map([['999', 'My Value']]), + key: 'map', + default: 'default map value' , + clickable: true + }), + new CardViewDateItemModel({ + label: 'Birth of date', + value: someDate, + key: 'birth-of-date', + default: new Date(), + format: '', + editable: true + }), + ... +] +``` + +##### Card Text Item + +CardViewTextItemModel is a property type for text properties. + +```js +const textItemProperty = new CardViewTextItemModel(options); +``` + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| label* | string | --- | The label to render | +| value* | any | --- | The original value | +| key* | string | --- | the key of the property. Have an important role when editing the property. | +| default | any | --- | The default value to render in case the value is empty | +| displayValue* | string | --- | The value to render | +| editable | boolean | false | Whether the property editable or not | +| clickable | boolean | false | Whether the property clickable or not | +| multiline | string | false | Single or multiline text | + +##### Card Map Item + +CardViewMapItemModel is a property type for map properties. + +```js +const mapItemProperty = new CardViewMapItemModel(options); +``` + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| label* | string | --- | The label to render | +| value* | Map | --- | A map that contains the key value pairs | +| key* | string | --- | the key of the property. Have an important role when editing the property. | +| default | any | --- | The default value to render in case the value is empty | +| displayValue* | string | --- | The value to render | +| clickable | boolean | false | Whether the property clickable or not | + +##### Card Date Item + +CardViewDateItemModel is a property type for date properties. + +```js +const dateItemProperty = new CardViewDateItemModel(options); +``` + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| label* | string | --- | The label to render | +| value* | any | --- | The original value | +| key* | string | --- | the key of the property. Have an important role when editing the property. | +| default | any | --- | The default value to render in case the value is empty | +| displayValue* | string | --- | The value to render | +| editable | boolean | false | Whether the property editable or not | +| format | boolean | "MMM DD YYYY" | any format that momentjs accepts | + +#### Defining your custom card Item + +Card item components are loaded dynamically, which makes you able to define your own custom component for the custom card item type. + +Let's consider you want to have a **stardate** type to display Captain Picard's birthday (47457.1). For this, you need to do the following steps. + +##### 1. Define the model for the custom type + +Your model has to extend the CardViewBaseItemModel and implement the CardViewItem interface. +*(You can check how the CardViewTextItemModel is implemented for further guidance.)* + +```js +export class CardViewStarDateItemModel extends CardViewBaseItemModel implements CardViewItem { + type: string = 'star-date'; + + get displayValue() { + return this.convertToStarDate(this.value) || this.default; + } + + private convertToStarDate(starTimeStamp: number): string { + // Do the magic + } +} +``` + +The most important part of this model is the value of the **type** attribute. This is how the Card View component will be able to recognise which component is needed to render it dynamically. + +The type is a **hyphen-separated-lowercase-words** string (just like how I wrote it). This will be converted to a PascalCase (or UpperCamelCase) string to find the right component. In our case the Card View component will look for the CardView**StarDate**ItemComponent. + +##### 2. Define the component for the custom type + +As discussed in the previous step the only important thing here is the naming of your component class ( **CardViewStarDateItemComponent**). Since the selector is not used in this case, you can give any selector name to it, but it makes sense to follow the angular standards. + +```js +@Component({ + selector: 'card-view-stardateitem' // For example + ... +}) +export class CardViewStarDateItemComponent { + @Input() + property: CardViewStarDateItemModel; + + @Input() + editable: boolean; + + constructor(private cardViewUpdateService: CardViewUpdateService) {} + + isEditble() { + return this.editable && this.property.editable; + } + + showStarDatePicker() { + ... + } +} + +``` +To make your component editable, you can have a look on either the CardViewTextItemComponent' or on the CardViewDateItemComponent's source. + +##### 3. Add you custom component to your module's entryComponents list + +For Angular to be able to load your custom component dynamically, you have to register your component in your modules entryComponents. + +```js +@NgModule({ + imports: [...], + declarations: [ + CardViewStarDateItemComponent + ], + entryComponents: [ + CardViewStarDateItemComponent + ], + exports: [...] +}) +export class MyModule {} +``` + +## Node Permission directive + +Selectively disables an HTML element or Angular component + +### Basic Usage + +#### Properties + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| adf-node-permission | [Permissions](https://github.com/Alfresco/alfresco-ng2-components/blob/master/ng2-components/ng2-alfresco-core/src/models/permissions.enum.ts) | null | Node permission to check (create, delete, update, updatePermissions, !create, !delete, !update, !updatePermissions)| +| adf-nodes | MinimalNodeEntity[] | [] | Nodes to check permission for | + +### Details + +The `NodePermissionDirective` allows you to disable an HTML element or Angular component +by taking a collection of the `MinimalNodeEntity` instances and checking the particular permission. + +The decorated element will be disabled if: + +- there are no nodes in the collection +- at least one of the nodes has no expected permission + +#### HTML element example + +The best example to show `NodePermissionDirective` in action is by binding DocumentList selection property to a toolbar button. + +For example the "Delete" button should be disabled if no selection is present or if user has no rights to delete at least one node in the selection. + +```html + + + + + + ... + +``` + +The button will become disabled by default, and is going to change its state once user selects/unselects one or multiple documents that current user has permission to delete. + +#### Angular component example + +You can apply the directive on any angular component which implements the NodePermissionSubject interface. The upload drag area component can be a good candidate, since this one implements that interface. Applying the directive on an angular component is pretty much the same as applying it on an html element. + +```html + + ... + +``` + +When designing a component you want to work this directive with, you have two important things to care about. + +#### Implementing the NodePermissionSubject interface + +The component has to implement the NodePermissionSubject interface which basically means it has to have a boolean **disabled** property. This is the property which will be set by the directive. + +```js +import { NodePermissionSubject } from 'ng2-alfresco-core'; + +@Component({...}) +export class UploadDragAreaComponent implements NodePermissionSubject { + public disabled: boolean = false; +} +``` + +#### Defining your components as an EXTENDIBLE_COMPONENT parent component + +The directive will look up the component in the dependency injection tree, up to at most one step above the current DI level (@Host). Because of this, you have to provide your component with forward referencing as the EXTENDIBLE_COMPONENT. + +```js +import { EXTENDIBLE_COMPONENT } from 'ng2-alfresco-core'; + +@Component({ + ... + providers: [ + { provide: EXTENDIBLE_COMPONENT, useExisting: forwardRef(() => UploadDragAreaComponent)} + ] +}) +export class UploadDragAreaComponent implements NodePermissionSubject { ... } +``` ## Upload Directive Allows your components or common HTML elements reacting on File drag and drop in order to upload content. -Used by attaching to an element or component. ### Basic usage @@ -131,7 +569,11 @@ You can decorate any element including buttons, for example: ``` -### Modes +### Details + +Used by attaching to an element or component. + +#### Modes Directive supports several modes: @@ -146,7 +588,7 @@ It is also possible combining modes together.
...
``` -#### Click mode +##### Click mode For the click mode you can provide additional attributes for the File Dialog: @@ -168,12 +610,12 @@ For the click mode you can provide additional attributes for the File Dialog: ``` -#### Drop mode +##### Drop mode For the moment upload directive supports only Files (single or multiple). Support for Folders and `accept` filters is subject to implement. -### Events +#### Events Once a single or multiple files are dropped on the decorated element the `upload-files` [CustomEvent](https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent) is raised. The DOM event is configured to have `bubbling` enabled, so any component up the component tree can handle, process or prevent it: @@ -227,7 +669,7 @@ detail: { } ``` -### Styling +#### Styling The decorated element gets `adf-upload__dragging` CSS class name in the class list every time files are dragged over it. This allows changing look and feel of your components in case additional visual indication is required, @@ -256,10 +698,52 @@ for example you may want drawing a dashed border around the table row on drag: } ``` +## Context Menu directive + +### Basic Usage + +```html + + +``` + +```ts +@Component({ + selector: 'my-component' +}) +export class MyComponent implements OnInit { + + menuItems: any[]; + + constructor() { + this.menuItems = [ + { title: 'Item 1', subject: new Subject() }, + { title: 'Item 2', subject: new Subject() }, + { title: 'Item 3', subject: new Subject() } + ]; + } + + ngOnInit() { + this.menuItems.forEach(l => l.subject.subscribe(item => this.commandCallback(item))); + } + + commandCallback(item) { + alert(`Executing ${item.title} command.`); + } + +} +``` + +### Details + +See **Demo Shell** or **DocumentList** implementation for more details and use cases. + ## Alfresco Api Service Provides access to initialized **AlfrescoJSApi** instance. +### Basic Usage + ```ts export class MyComponent implements OnInit { @@ -276,6 +760,8 @@ export class MyComponent implements OnInit { } ``` +### Details + **Note for developers**: _the TypeScript declaration files for Alfresco JS API are still under development and some Alfresco APIs may not be accessed via your favourite IDE's intellisense or TypeScript compiler. @@ -289,11 +775,17 @@ api.nodes.addNode('-root-', body, {}); ## AppConfigService +Supports app configuration settings, stored server side. + +### Details + The `AppConfigService` service provides support for loading and accessing global application configuration settings that you store on the server side in the form of a JSON file. -> You may need this service when deploying your ADF-based application to production servers. -> There can be more than one server running web apps with different settings, like different addresses for Alfresco Content/Process services. -> Or there is a need to change global settings for all the clients. +You may need this service when deploying your ADF-based application to production servers. + +There can be more than one server running web apps with different settings, like different addresses for Alfresco Content/Process services. + +Or there is a need to change global settings for all the clients. The service is already pre-configured to look for the "app.config.json" file in the application root address. @@ -357,7 +849,7 @@ export class AppComponent { Your custom components can also benefit from the `AppConfigService`, you can put an unlimited number of settings and optionally a nested JSON hierarchy. -### Different configurations based on environment settings +#### Different configurations based on environment settings The CoreModule allows you to provide custom application configuration path. That means you can evaluate the final file name based on conditions, for example environment settings: @@ -379,9 +871,9 @@ if (process.env.ENV === 'production') { }) ``` -### Variable substitution in configuration strings +#### Variable substitution in configuration strings -The `AppConfigService` also supports a limited set of variable substitutions to greatly simplify certain scenarios. +The `AppConfigService` also supports a limited set of variable substitutions to greatly simplify certain scenarios. ```json { @@ -400,9 +892,9 @@ The supported variables are: | hostname | `location.hostname` | | port | `location.port` | -### Unit testing +#### Unit testing -You can also provide custom values for the entire service. +You can also provide custom values for the entire service. This might become handy when creating unit tests. ```ts @@ -423,11 +915,14 @@ describe('MyTest', () => { ``` In the example above custom values are applied on the top of all the values the `AppConfigService` has previously loaded. -If there is an 'app.config.json' file loaded at unit test run time then your custom values will overwrite exiting values with the same keys if present. +If there is an 'app.config.json' file loaded at unit test run time then your custom values will overwrite exiting values with the same keys if present. ## User Preferences Service -The `UserPreferencesService` allows you to store preferences for the components. +Stores preferences for components. + +### Details + The preferences are bound to a particular `prefix` so the application can switch between different profiles on demand. For example upon login you can set the `prefix` as current username: @@ -476,6 +971,10 @@ Known properties: ## Notification Service +Shows a notification message with optional feedback. + +### Details + The Notification Service is implemented on top of the Angular 2 Material Design snackbar. Use this service to show a notification message, and optionally get feedback from it. @@ -484,13 +983,13 @@ import { NotificationService } from 'ng2-alfresco-core'; export class MyComponent implements OnInit { - constructor(private notificationService: NotificationService) { + constructor(private notificationService: NotificationService) { } ngOnInit() { this.notificationService.openSnackMessage('test', 200000).afterDismissed().subscribe(() => { console.log('The snack-bar was dismissed'); - }); + }); } } ``` @@ -500,7 +999,7 @@ import { NotificationService } from 'ng2-alfresco-core'; export class MyComponent implements OnInit { - constructor(private notificationService: NotificationService) { + constructor(private notificationService: NotificationService) { } ngOnInit() { @@ -511,88 +1010,11 @@ export class MyComponent implements OnInit { } ``` -## Context Menu directive - -_See **Demo Shell** or **DocumentList** implementation for more details and use cases._ - -```html - - -``` - -```ts -@Component({ - selector: 'my-component' -}) -export class MyComponent implements OnInit { - - menuItems: any[]; - - constructor() { - this.menuItems = [ - { title: 'Item 1', subject: new Subject() }, - { title: 'Item 2', subject: new Subject() }, - { title: 'Item 3', subject: new Subject() } - ]; - } - - ngOnInit() { - this.menuItems.forEach(l => l.subject.subscribe(item => this.commandCallback(item))); - } - - commandCallback(item) { - alert(`Executing ${item.title} command.`); - } - -} -``` - -## Accordion Component - -The component provides a way to easily create an accordion menu. You can customize the header and the icon. - -```html - - - - - -``` - -```ts -@Component({ - selector: 'my-component' -}) -export class MyComponent implements OnInit { - - titleHeading: string; - - constructor() { - this.titleHeading = 'My Group'; - } - -} -``` - -### Properties - -| Name | Type | Description | -| --- | --- | --- | -| heading | string | The header title. | -| isSelected | boolean | Define if the accordion group is selected or not. | -| headingIcon | string | The material design icon. | -| hasAccordionIcon | boolean | Define if the accordion (expand) icon needs to be shown or not, the default value is true | - ## Authentication Service -The authentication service is used inside the [login component](../ng2-alfresco-login) and is possible to find there an example of how to use it. +Provides authentication for use with the Login component. -### Events - -| Name | Description | -| --- | --- | -| onLogin | Raised when user logs in | -| onLogout | Raised when user logs out | +### Basic Usage **app.component.ts** @@ -614,227 +1036,24 @@ export class AppComponent { } ``` -## ADF Card View +#### Events -The CardViewComponent is a configurable property list renderer. You define the property list, the CardViewComponent does the rest. Each property represents a card view item (a row) in the card view component. At the time of writing two different kind of card view item (property type) is supported out of the box ([text](#card-text-item) item and [date](#card-date-item) item) but you can define your own custom types as well. +| Name | Description | +| --- | --- | +| onLogin | Raised when user logs in | +| onLogout | Raised when user logs out | -```html - - +### Details -``` +The authentication service is used inside the [login component](../ng2-alfresco-login) and is possible to find there an example of how to use it. -![adf-custom-view](docs/assets/adf-custom-view.png) +## Translation service -### Properties +Supports localisation. -| Name | Type | Description | -| --- | --- | --- | -| properties | [CardViewItem](#cardviewitem)[] | (**required**) The custom view to render | -| editable | boolean | If the component editable or not | +### Details -### Editing - -The card view can optionally allow its properties to be edited. You can control the editing of the properties in two level. -- **global level** - *via the editable parameter of the card-view.component* -- **property level** - *in each property via the editable attribute* - -If you set the global editable parameter to false, no properties can be edited regardless of what is set inside the property. - -### Defining properties - -Properties is an array of models which one by one implements the CardViewItem interface. - -```js -export interface CardViewItem { - label: string; - value: any; - key: string; - default?: any; - type: string; - displayValue: string; - editable?: boolean; -} -``` - -At the moment three models are defined out of the box: - -- **[CardViewTextItemModel](#card-text-item)** - *for text items* -- **[CardViewMapItemModel](#card-map-item)** - *for map items* -- **[CardViewDateItemModel](#card-date-item)** - *for date items* - -Each of them are extending the abstract CardViewBaseItemModel class, and each of them are adding some custom functionality to the basic behaviour. - -```js - this.properties = [ - new CardViewTextItemModel({ - label: 'Name', - value: 'Spock', - key: 'name', - default: 'default bar' , - multiline: false - }), - new CardViewMapItemModel({ - label: 'My map', - value: new Map([['999', 'My Value']]), - key: 'map', - default: 'default map value' , - clickable: true - }), - new CardViewDateItemModel({ - label: 'Birth of date', - value: someDate, - key: 'birth-of-date', - default: new Date(), - format: '', - editable: true - }), - ... -] -``` - -### Card Text Item - -CardViewTextItemModel is a property type for text properties. - -```js -const textItemProperty = new CardViewTextItemModel(options); -``` - -#### Options - -| Name | Type | Default | Description | -| --- | --- | --- | --- | -| label* | string | --- | The label to render | -| value* | any | --- | The original value | -| key* | string | --- | the key of the property. Have an important role when editing the property. | -| default | any | --- | The default value to render in case the value is empty | -| displayValue* | string | --- | The value to render | -| editable | boolean | false | Whether the property editable or not | -| clickable | boolean | false | Whether the property clickable or not | -| multiline | string | false | Single or multiline text | - -### Card Map Item - -CardViewMapItemModel is a property type for map properties. - -```js -const mapItemProperty = new CardViewMapItemModel(options); -``` - -#### Options - -| Name | Type | Default | Description | -| --- | --- | --- | --- | -| label* | string | --- | The label to render | -| value* | Map | --- | A map that contains the key value pairs | -| key* | string | --- | the key of the property. Have an important role when editing the property. | -| default | any | --- | The default value to render in case the value is empty | -| displayValue* | string | --- | The value to render | -| clickable | boolean | false | Whether the property clickable or not | - -### Card Date Item - -CardViewDateItemModel is a property type for date properties. - -```js -const dateItemProperty = new CardViewDateItemModel(options); -``` - -#### Options - -| Name | Type | Default | Description | -| --- | --- | --- | --- | -| label* | string | --- | The label to render | -| value* | any | --- | The original value | -| key* | string | --- | the key of the property. Have an important role when editing the property. | -| default | any | --- | The default value to render in case the value is empty | -| displayValue* | string | --- | The value to render | -| editable | boolean | false | Whether the property editable or not | -| format | boolean | "MMM DD YYYY" | any format that momentjs accepts | - -### Defining your custom card Item - -Card item components are loaded dynamically, which makes you able to define your own custom component for the custom card item type. - -Let's consider you want to have a **stardate** type to display Captain Picard's birthday (47457.1). For this, you need to do the following steps. - -#### 1. Define the model for the custom type - -Your model has to extend the CardViewBaseItemModel and implement the CardViewItem interface. -*(You can check how the CardViewTextItemModel is implemented for further guidance.)* - -```js -export class CardViewStarDateItemModel extends CardViewBaseItemModel implements CardViewItem { - type: string = 'star-date'; - - get displayValue() { - return this.convertToStarDate(this.value) || this.default; - } - - private convertToStarDate(starTimeStamp: number): string { - // Do the magic - } -} -``` - -The most important part of this model is the value of the **type** attribute. This is how the Card View component will be able to recognise which component is needed to render it dynamically. - -The type is a **hyphen-separated-lowercase-words** string (just like how I wrote it). This will be converted to a PascalCase (or UpperCamelCase) string to find the right component. In our case the Card View component will look for the CardView**StarDate**ItemComponent. - -#### 2. Define the component for the custom type - -As discussed in the previous step the only important thing here is the naming of your component class ( **CardViewStarDateItemComponent**). Since the selector is not used in this case, you can give any selector name to it, but it makes sense to follow the angular standards. - -```js -@Component({ - selector: 'card-view-stardateitem' // For example - ... -}) -export class CardViewStarDateItemComponent { - @Input() - property: CardViewStarDateItemModel; - - @Input() - editable: boolean; - - constructor(private cardViewUpdateService: CardViewUpdateService) {} - - isEditble() { - return this.editable && this.property.editable; - } - - showStarDatePicker() { - ... - } -} - -``` -To make your component editable, you can have a look on either the CardViewTextItemComponent' or on the CardViewDateItemComponent's source. - -#### 3. Add you custom component to your module's entryComponents list - -For Angular to be able to load your custom component dynamically, you have to register your component in your modules entryComponents. - -```js -@NgModule({ - imports: [...], - declarations: [ - CardViewStarDateItemComponent - ], - entryComponents: [ - CardViewStarDateItemComponent - ], - exports: [...] -}) -export class MyModule {} -``` - -## TranslationService - -### Registering translation sources +#### Registering translation sources In order to enable localisation support you will need to create a `/resources/i18n/en.json` file and register its parent `i18n` folder with your component or application module. @@ -870,7 +1089,7 @@ assets/ng2-alfresco-core/i18n/en.json You can register as many entries as you would like. -### Switching languages +#### Switching languages Depending on your application, you may want to have buttons or dropdown menus to allow language selection for the end users. @@ -894,7 +1113,22 @@ class MyComponent { * getRendition(nodeId: string, encoding: string) * isRenditionAvailable(nodeId: string, encoding: string) -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-core +``` + +### Build from sources You can build component from sources with the following commands: @@ -906,7 +1140,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -915,7 +1149,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -925,6 +1159,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-core/docs/adf-toolbar-01.png b/ng2-components/ng2-alfresco-core/docs/adf-toolbar-01.png new file mode 100644 index 0000000000000000000000000000000000000000..ca81330cd206bc772e66b3a3315a596bdafc5663 GIT binary patch literal 14044 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 I%)s}50GmGD3;+NC literal 0 HcmV?d00001 diff --git a/ng2-components/ng2-alfresco-core/docs/adf-toolbar-02.png b/ng2-components/ng2-alfresco-core/docs/adf-toolbar-02.png new file mode 100644 index 0000000000000000000000000000000000000000..1e81967f3e8bca680bdfe1b98f5142d0f75ced42 GIT binary patch literal 36976 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�YE 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 Cvf+;a literal 0 HcmV?d00001 diff --git a/ng2-components/ng2-alfresco-core/docs/adf-toolbar-03.png b/ng2-components/ng2-alfresco-core/docs/adf-toolbar-03.png new file mode 100644 index 0000000000000000000000000000000000000000..97c19d094e81c17aaf108df796039642e8b4d6c2 GIT binary patch literal 14016 zcmeHtbzD^Kw*N?n3P?(a2of`NNlAx-lnjj^4TE&Z5TYO;B``E7pfu9m3L`Bk-JQ}6 zck{mIp7WmbyXW5FpWk0+e?G%(X79D1^{n`Q*Lt2E^i)Ou79J%Y2n4#Ns34;b0^xH2 z=gv4-z~2dX?I{rG<{c|(>8Fa)()3Rq?ai%h%|IZ9pcrjz&8RlAl!gq#JG%5}>QeTv z_t@&(GW>K z@LqaVIc+6xscd$}-;nH0h)GNgWxEmat%qC&`-F=)>O*{np|9Vz?`=N6TOpjC`(eR& z=uhQN8#+!CK}3hYI9iG>T+SMTc>>vAp!>=^N@^!6cA^)@02Oq1lg^_{S_XRh>l{~^ zh~gCGfbL-Uz6)`vCdmzP$RSaU82&DIDz%OYif=c;?Yr@maMzryu>UzVCbztecpx&c z@{S3CD^>{lHvApS{CwvdXynZzt5pJrzDqJ*7moWOG2#KAs}$a>BZ(KyOBT;kJGL8` zS@ifs0>y0yZa#WiDr8X!E7ReXZi&O&R`a%&x%Zuo&}iD>-hqjipfm{yO9`DZK71zO z1{R2Qy6{YjVd!-nLwoQp;<+9|au$E17st^1W!}w9Jaf5@*>uda^>Dq3UNZ#51kkc|zIzg}Bhy3jdzOj*nQx^=94Rr|E*u&+L&a^)L?{~~OeJ*& zenLpdS=Kb*^d{Zo`7>L@3osNvPTO0~He!HWc^;4Wo1E~=O79Ex+Z2Hv;ZY9Xj9rdp zI=n(0OVVE)KuHB3a_Lrg4|_j<)R|@PCeFdNB4QlQqr;$9Ts670DBq$~HN%R7Uf)Q- z<%d(Q$wmAE%@8TM3p!(_!3A;9gI0X;Im{B&!ZF%#=)6rO8IFh`P zVOF1wlq2rn<&1ED;g?CcG@Ve1y%`YL^p)JUypng5XBDYQogA~Qy2pe?g#OOlRCGAP zMZgxV@l>$->9EstR}=7AFLgbVNtD@{h?WRO=!xSdDeBG`#8{Hhq{ny^BuxCqpO%7C z5@E0!J~Go9QHH+hUn6}H@vys*-;Wtaz`NZl_8fNm=_!+RFGa4ZQDO=>UklF(xxu~gpJY^q*HhcwZ<69f=pFfj1F3A3cHen({D zH_X`m4tqBI4MVTOoe!@wn7m}(bV?%_nSXd@P>=WxFf=g9M`-+z&A_kn-(x)gK{d}C z{7F-jbWkp|HzqTa<6N@wCQ=TW z-_>~@ggh{d#%kAThqvo_czD1)$dB80M2}^6%yv!}AU_VA+rVu1Rk7e4(Y^-1xQ-b_qdQd(qM#jJCS zREv6xf3P+wcJzGo`xvhns1klOTXY!fggT}A7xpn$dA23iuj-TOUTVixc#1917NfW6 z#gEN0+pS`d&hKH8ho4JUlviq&Emq(;GFrrg#)FRs?+n6oXmb3m*{lz&x2;PC*#^S0 z_qn(NxS8T2yP)5M8Y|n5L{(lT9SUt$#>`Q+x`dy86gQkuPR=#Vo6Pc-J}<%2_-4eU zY?>@r(u)2>zhB>}c#)%vt*ayfeNGEm6KW9-q4hC7GvL(h&}Y}RDHu}8cg<(8quG$$ z(BI%3%`C%qrVud{i5H=A30vD+>vIuv_NbEYTlcS-%kWy1aFpbmCog7I`FjL-ygk;!A877< zZBaCsW`p+pbqB`9n^oKjj%>sv0u!;1sC#xZmn)a~S=Y0#_bF8#r&PjbkAtT2X!1(( z-E^i()QWJ6bWHlKcUy z_Z?U^6844-rji%xzttiAS0ZPNCeo1_Jy8of8^=F78bjvF#@6C1;@!R+8g6Ne4~e6t zeiNtjGJr3grtEz?Lpu*X7dg{9n>*_`r^8yt&cGhPzKJD*(S1wwt_%*|EnRYFcId-6 z8hvt6idhmKiTTH@{CxLIMfcR=JmTo{_^EFZ;7$>GOEj~-rt77~W%Oqflo5Z&6Vx7Z zV#?#-I4~dFrkZY-wj`Sx{t4OnZiIMOe2B&M$$FhozmS@~UaiU5z)|%P0j@Xh8nNdc zmiyhRwMiNA-<7Qu?=vG=wp3^nW+lw}qwBM8YlM86Ofu)OJ17n5=g+iIl@O42z_Mv= zB9T&(YEOxVggNrAIcO{byJ;+m`t6C zS4-e-++B#-HMGDogLRxmkj868@qb8;n23|^R%{b))}FE0?&%ze7k*`~T_6ingQ=$2 zOn#|-^eD@?f{;jsxO_gh*+!-2hvr^LRz+j_$F%9WydxcK3-+GH9$2cWxWz(}#oHTi z8@gJSikHf}`V%YM4Y$0ujvtcI-` z4(>NBw;Y)>Li5RnsI%T7nb6%V_Zq|V!nBt~D%Hg3J@aN?Br#$u0zcq9E)K3+?fWXw zfH)T^7O`_dQX=`aY=Uf#ZR`tn^|fmZJ>WAZNUCN*KD!q%j>#if|NAH8${WfRc3*7C z>^2|Zv)hcARGMudAPaXF1lhdUDA~){w4Zqow~ve(ENBfDK6$0rR^Bt_F=oGoGv2Fd zr*BXlRas)Z)Nim|(|x&krZ)lWnqaPJ82WAFX`OD zi0IYaccIxjSQmHc+8V7|Yx)J5dRN)&!n?V+p{HTLKfXBb?agx9y;g(i7P!S(ty*bx zCb{xxMLIul@RI9P-Zb2_r^v8j@<5(Dd{fL^!uwd}XkK}$II}eKbB}ZCpjZXmyHw(1 z!){A7IUM3-ben+WJp0UIfxTZl@M7mA7tZBSxK%d2|07Y$o_}(vw#4U`015xzZ+Q3V z3_%MWzxa^1F5dP-q?9$Qe>n)!k4)U&$#fDl@+Kq`-U$9 zW9xP@=qX8tJtT;}?=TI+@AA#(E#4p@w5M~JlH-h^=4qPGcmhoCvJ1(L>P+iE))s<8 zFBl(}l*F{AHIv_*nfviW&km%J5Aq^?|Nf>u&E4Z_{10{LjcuYUiK-kj?hR95Z*4zz ztd6Fh9aUL2TdYeeC>&@Ka9=9uIDtT9%vYZqit6`%gFrV@tTds{&?k>YOzrK!&tKS^ zn1S8xUIKT6K%(v?^K*K4J6o8Oh`Si$A9siV=T|>N80r7G#o0!T5&GmQy|lff z89hIk56s0Vjz>>VFY5ThTtr<)?r-A2e`1W5&dx7IAP_e-X#o?2TwQ^1gSjAoe>Na0diATwQ!95fTd0hcof*st7(<*#NPtW94}t&Z z(m#g$i>S^&M7g;I{wn#GD}R#|geI85wB6|-_b|okpv1m=(k8#oFr^Hc8*bB>eOc2i>kGPphJiy!FNxZT zA0^IBLTG_s4j30@nLh^jfq{X5<6L8;E2)9UlEzi$r6TuH)b4Lnku)9=yq<)wWEY^H zja;tjb<F=Sc$n}}zor<@3p7(?SUwv=p?-`!^WW4)%>y^k1~IJ3ptQn{FUlMS ziBNUipJV(C$GkY(?Xh)1>o|9h;tai(^Cjy58?7tAoO!i0p-?xy>CjMti`pC>L3 z$1ml{%Ik%UBRzd#lK+!(nd|Aee+LNa*jk6{1@*k7q_Hq|qHWOibX;YoFVu&4%-y+` z?|%6CHagxG7`byj9S4+w6f)dtWxiHIM4;dBTcEZrX1<<|S+RhQb@QRhsD|<%hNH(u zL+cP8exZEtS~@<306KcMQN>;_h;IWy>{Qr>P`H+k9}NK=_df`NuNTDBI5-?j#!;M+ z*VFMoiT2O-`cI<$vpop^lW2dfKBm#|ZKvwR%I(I6($(zi_J`uQP36Kztz|wY0C>bt z1CZFkXDvafJpQz1Qq{0O*E>5@bi_@C? zvE?ZtU$tModSyFO%zUspkx2A7j*CH8SJ&j|_lyVgit7Yg$3$P&|1#XaUb1HX{maOw zC76`mlSUJq9RAZWyY+GkpCi>uJ>&z)Gnk!SXjoWS@g|@nVG2Q*zP-`8_Gm>}SxcTyNibaOcs|PE^8C=EXK*zbQptcaslYXj zk9QVYG_-r%f~7hxaqu`UP1QPT%sLP)z3KAow|j?&DMH9NbD*)mn!V|ulciP~9Qu{N zlMXBR?s;`5C(VVN9&Cgl5Qy2a5OPSEu+!p;>#Hy=g=OV}-r`uPRmD1KIyIehu8q|t4TaB5+m6!+O6 z!@MtB{G`x=^OTIAI|xoaldZ|R5o6-}kKZ8>WX~7y_Ru;q)x?45t6WU5VIw@(*hA9! zd=HnnpuoOO{Z1oOrDeLwpDDRh)T}+4g3t1&#I2gD)8nO7)5FaPhvlE2@?@2IGu`^J zbysr8ls0t_`;;LqG;ZTWQ{Ja`X9r{UI&S0!&T8ZCbD`YcXGcmC-> z&IX<Kke<7E9(?d4!1Xl<+lEuZ08-4SZb8-uU%gf7$i%jJgKd9u?uY5_w>pDld zvh(A`IB_%)9EaTqq?eyLQ3* z#l^+o{nNv(aAsx1_rob4qayFoQmgH8r=Au7n%h@v0zQyK45^(KJKIK`^OfIP(FPLG zf!CPCfWW3->`Ej@$G**xtNdwgf9)5Nw?|atnc>OrpV9;^{siI_56<)}1?)yi@X5g( zqOIrzqJ%&!!nQqD2eOMi_g87(R)#>TP|bQj{i`;^wFVPmvzB`}3H+0KunI2pS|2W| zJe+)G+LIz?5d+^S`(?7&8E>}H*Y>T%yo-%JcP~Ok?_xPUyj?|alTt}s&$vpx;cang zKxV3UwL6<59(%*Z$=deht1Z$5=hIh9$!@KEpOr)Wmh$x~%o&z94dcY&o@Bo_+p_y7 z_CF<|N+Kr}lKJQz4-SWZ{)}L7b#;9vHeQljN{pxpPCBjyn1UBShHzO<()gI~v76rl z$ttIqm=M2e=4~VI7X+bM9gBcIbKy{^Q*ulk>s)WdJ&Ql zGr-7w=B7ediTRV6n03CzX2sUA za=Q?DT8|8<8{oIr_84~4@9&6obedBI?F~m(y6kJW<;Gpd>~!GvXdPnldX#J1NV=Yr zi@knTrsQG$%1Mu<d!5;`8L_*ccOyv!2kIYx5i2-oCy&-vSA~4v79T1Ms7wLEZScq(?lY zPhxnXBNn+)F=cqrME%f}<6(B?@1jsjezy9voeqT?vm`rD;3NfC)dWyU;D?Xc>*?ur zCh+G%1>h%p&>|CAva^jR#>d&2DZ!_kHD8BStA!os6*Bt6d;pZlJ1g!0hxABXiU!=G zBEu%2eLvtclOW<^eUp+e>v!B>PaJppkv?bP*=p`rb06cDRv7Bcq64_A2hBNU@bfWp zcRgoztpmZC3r&e_{zs9)oO!l!ST^yi46YbBY zZeq_pz6IRk_Sl&>(Gx_uW}LPKxY>eOq`}i~VR!f8*w_Q3YNw^{;I4$kMAL)y5z@6C zUDiS`&n0$Dgpt>F%h9wyK{45i^DLzPi1DFt)f%#ozcKM7LCC@6plD;HgvBOB#oQa< z(c-A6ntCG<6|1buD}pz$y0ii-$AY_pl}=SK0l*C7w;B4Lqm`>ysPfik1e0blAU*9!p89_bak~ka{~1%3q07NhI?qxHYt-_j8B|^AHgxcFq6^H4#-! ze_pV|$3Cgo=+L}MHrV?t&El+k><*TeCS^?*ufScW4Yjp5?RH>+r&WoQuNHTOAqDj* z)f$@I5u#$=a&DWJ3T0NM9XpcD0KKn0H`of0jfS(E8#0nfzW5+q>;P&zQSI_C2Z~x_WwZ08{o3 z4r;CLHseFS13VG|@6py?eR;9~&~$Hqe-vph9|HATO;r32DH4RjVueBA>BngC*&KAUQ7ZMB7$uz}NFFQxj_f63k0 z*vMZwB0rh7x{Qj7(uy4!AEz!m_$soEsec6AVV-MaW0U9><04DI@fC>e+tfmY0OclO zYH>E|-G$a~l#k7p{W1*c0N2<)yVS)(Ou-K)hD$6|1uQ&_J&cX%uc|rSj$4A`gsNiu zn))t-T16%;!5o%wfTR$sm{d3WV=;r+1&A0Iw`{;uUq z0FpXKVD);@>}!3O430fwhn*A;4T6(lkrz81kdmF1#vK5SX@SfS2Wn0>c2%3xE8J#2 z$xJo!Ip9MZ?8r%Gs84t)U}NI#)c8 zD<(bJ0s5~~H>ln?`jQA^gJ;G{2i|T0np7pT1t-mb4;|9qVqAd2*3I?Y>-bi8j9uTT zI@d8kuOX*f4H9y4a>X7G{~p)MYezGIbj1Swm91N2w(k@DsPu~W{#0C)=lcz zzyQF7^g#9NPR65>eMTZzpg-n(Ndi@AS_b$ocF}vcOK=XM2WxBYTnXOc8=~_$Q_D%+ zOvJ-LD0843g45KP2=>AxFh%}B?a^!qw}Bu(Kj}la&AcHFb%TW{p4V1z@?EAvFYeUI z&lRq~6fJaVNx%||SJao{wbQnfwtk*qQxF7&yWTXA6F&^TWI7@>0 z8m>pd0w(KTxn)o#VIs(LztEr>lAX+j`hE*lt*Yb^2yBGg`Y^Y4zs>?$M~Q+t>E6LX zH=Bl}F&F@EULGe*gvLHgs@EO-^FTJt*Af7=D12JjS(@^>4BeBDZ;jhhtN=HhAB^cl zcvKshv3fl4Te!Hms03=$%)l@p)E?q1&#mBVLiEI|ASrQ31Paf(1gE}#BaqN%JO^5Qrild6Us12?YFsyh0oV6fet;=Y z*270Eb>i@DcyMF#Xh`7jYYf?v$GgEwp?M%~cy3sGs z4(|oQ?b~tyYEp|hvjXY&j1n@zW?*-wjt)T?#6L;_tLSJi;w3Nz zUvP(^P_+LWIjT`iNFU*U)vW+@$Lq??&(A;isy-YbJB78HI69#6NSSPGl)Onmpq-qN zp3YQVQ{b?Xm-UEGAeeLpVkA}_awb^>0 zVmBUg0^<`w#mUQB4)0P>yqlSs$)OPu5lO45sj)Ut17;NBxpVLY<>j{S^hO}bNNe1- z!iZT^l8{=RDb?B84`|_gz0f+({q^>ctocE0qfj8667nj`%J@^@2O|mZ;YBwSY)?;4 zOn{^HgPyK#T4pB8hsdQ%AX+Xfe#@aeKF&PrZ-Cg4)6>S(VxD`o*s&TYdxRs**Qt*9c%mq!|w9+sA@SCnX0@!y0MBTWJ=c%AkR z)!rG0@Q1cBuvj&P%WiICX_>`ZRVl&3!cs!z8&31EJdaAJ%v#IU|D}`DZgH4Rp|T#( zMfZst)i9yFe29U^79rJ<3O~>R8Z<~G4BfE3e{_^m+X(J5?zxuFkXK96W^zCZ1us^O z@n0iAd_jKtS9?~^1#qt?Wr7E^(Yxat38s{7Z4Ew>;`~4@1wdl^ry9-J_b}YNvSa)MjfI7 z{Q4ma>mUO7NFYwPn!J$x&D)8 z|BRgfpVRE)B7h*pqt^rd8)yq?c6N3PsU?$ZKzU&v)2+cJARwTc&vw0BzzDuqxbC;W zI5Wcj&qnw^;Y^uWXpIUHE08>Sy;R2`Q3QZRA=B>b_2eAM0ARU0?tDF|;CleDWb~J7 zU(YPU_yDlngrVH${An#&;5{L5pVip)OzD>dkfRfpAj%!!AK>f92<%3Xuas`YT#t#n l0df@fPYk=BR3yd)wl!h%gQ9e|A|Tye0s=}6sDRQb-Q5Dx-O`;yNH?5o z@cUDL&+|WLowd%J^Ww`|!wmP__Z9ov`PqB(UQPyj6O$AZ2?^=u6RF1vNJyw5NJ!T- zFwnpir!yjSBqZ$H#^T~~PsGKk@kfh#+tD-A?Y$J-ROToLXL4~X!X6e1h zSmT)D6C8?)K`SOER}d+2eT4Nc6=NlG(u@X@I+KG0>iWJ{KtLfYky(26lWW?#0$Xt$ zmu?ldTd`X*o1I^-iS|W>M@I)UUJGsPA%2X0!jAv(!D<;~+qG3~bsZK;G&k#f7c2^UaAU;DfGs2^9n z6vQaVM7oXo=3St5B|%o8btZvq=#TG`r()~Zk-oIQywQJ64sX|xD1YDu`Sk}-Q(^xW z|MJ@}aUIYCQMTRR(Jd@=zEumuE-+rhweG(p;;?7F9~ds|ms%n9cD)6E$*^eYEWTsA zj+Rc7liy$1Y!LgATrsavxkZUOhj`Ox%x!rOlgIbIGvevaSl>H%>Bb{YKtNXn(Zh0| zjk<=0L_d>%CPqE%{h7KwU^n80W`yV*)wvoN5{lfhy89U!S58Zj(L-2EshDzm4x#DL+e8ydOwa>F;4@_wABm()! z#Lifs5P`*1`;zB(&`&5W`ihs7-|~^#6w?{`Uw9nD_+R)v6N&* z0@7Mth;gc}bm;v%ETK-XywdQNXQIl{H~swU^N7t#%Q-e5uC*wU$A+)S?$My#LV0JX zFZd(Wp4$xh+bK__+z;Cq4lh~H`p9crXas5PZc*N{z;nTH6cu#3`~GfGRK4ciqxXFH zZ+$39SVSYV*I=Ww&7mbIn?6^tlQ_-a_gAr$!Y z1y7ysX1whiO`@GB)FYot54NwduiKA|Uovc4BF>9sj~5Wot-j-CwA6j;XFtczm#Lqe zOAmdH&9ZJh(=;WcL;7x1wYTEb5gId!G2ic~J@o`hD=DL0)B>s-&-|Ij#{Dz;YEt7m$$-}%Elwz zByo~&3lGq~`m4X}{>(=7o>t%ZGm_>TLj6=VuHiQ&4VTBH!#+3l;;rt=w0tS2&F-QS z#4(z8K03jZxmrjyj5thXn4_}UT%4U zvGxA(U7y!tcHXBC-+z7*BdsMd@zm^I+&za|5PW~Bdmqr+ycc8w?iENKr`+u)>euPN zp}>;?+Y4is9i|=sfYRFbO4#{E#iwe2x0s3N9+H$1iXS*W*oFswns4n2)1)br&Q;#b z)QX>Am-zBh%sTD6!b65Y27^y%?dt9B?V8Tc&hE~{$89@;#}YdRJEx0mt%vQNNttq8 z8MT8MO1JE}O8i_txcHw$NG9JIsD9m6>^5eiL9xNPLA{ZTtX=<RU-q5q5+e7Y|6q!CI zj3x&r+a^UrjDsN=`|Rv~4`@Dzb*VM-ek*S~5|nX`Ipp0e51%J(wuhZ22&HqKHKRP&8ql&WTw?BG>?(>vnOAP93O0hVQF`i~X|pJGXfbJ+ z<_^o`IOI^9Q*4NCXl<~JrIn!Dk?`yAf8i&y4}tH&`|XA7oGZ!fWmjtTG9T1@8SQ+y zbZ03cE$A2on_Ps~U#qD#+b96KU6eAx_pI|g|G#|f8zgfRsZ1~MB(zZK% zWCkSW-29e%^*_Gz);m>L7j4_(+ke#iDE86i=F=s?fMO=^AkEl_>&SKA^Rq0a6yH6_f zEUw&Q?)d$5Hbr((j-&c?k$l080`->zCcDkU6A|W`FI*=>42kv1dUKmLOKNL`MCtg&DM>ncM>7ZWvKKgYZ6BPp#QwLa#l$Yt3mAi?xFj$3Iv9v=f-E8dbx*UaO zP9mdIH6z9;%a%VryKham5w-V2dpdTpwy~zgXEkiDU^2NyvFGEW`o?i<$G5=wl5zN# zvM-Kb4|TRwg@=Wa;~Rw`Zrbk4r*V6YXUOLP=lo~NXY*$r=Mc0N^c3_#bZj(!)b5*t zcOGM4-qawrV^S0NOrb?ANHRz8P-Nj5Js0QwV!=K6&(5Ezvbo4_;@+6X^AKsE_lES5 z-?-~T!}D19-NX0ofhYP8t!)Mu0@`Gg&6AcT;$ev`o$p5RcZG-P9G&A?F%{5ln5_|W{I zIB+TihDWw7H%@?5S9L+$XkdDHSeLdM@6QhxVZx9aEhiZQFBZ3wySc74V9l z{)vI%G$C0>+3C=!_}MS=Q4hZDE{5;w7@-+hbex3}eo_9&^&vKN^0RpNlQzBv)mfwM zp3cE9e6EJ7xe^xg7P4`sQ(vneJxbRr!@DJeU%HUhU@BA9scVjmI84x3#VGS*^B90#*i=5y7^2XOV}|jgge8gi%$+<461GnD(Ob zQ2ujQ&9>5>ap!T%EsTjiC37w9%8%tmddmaa+g06{OJ|ys7G0CHRdvHZOm5xdwm%=t>{tbOtmLE{%G0frhgEQ zGUZnYtA$w966Z~BBhJI(dnI-hH~9L8*M?n=aI-{ALe?m9c)vQBby>G>8?-=W2;xZi zzqs1WD4k@qm~)J6#>xn~pLZ^BP#B5#=+-tv?azftcSlCC3Fugu zIKCEfYnpAJ#c2uonkA#E$*;|?S#{r@V(VaC*uHCPtO8y?!Z!V`yw9Fvb7@0U(QS7e6Fa=I&7}l2EtX^oiJ=%~lr&m*70(%xIBmK-K?Z=OoLW-8z4(WM;oL zTG^6oYPh<{bA+3KYwxFf_vtKd6NF26*u&<+?!vZV*{HFoHnjGWJJ;#h3CrI2d00$X zm{!Ca+6qj){6u48r0R@oZz52)aAJ|<2vRKB-c$7-CZT#=zD?cYc+ZP0H-BAp;x1Cd z3`Hs?H_f|@d}7@i{Td__Bc9<`cb^p%g*PWP5M$5Ix3+4UBT3~Txe*2hVOvt%Ij+R| zP=oTVO>i|@mie($-88F*suvSlM}5zZtOTPO+9jEqI|vePSV^hdA|VmcB3{>?DBSxA z;)gh6B{e&>=g;`{EzMb9ys~_0!0Kdf1@1;d5_IARAI%NyUQjuin_1ZMI|<#rx`Q8l zMqFmQOLcXNovF}WwdZnF;+8fBR9vi_tn7D%F{!Ai1Z`d!@+&-+{O57-m(bnUc6L_$ zY;2B>j;xLxtd=%LY!CSO_}JJVvORpr0`6e3b+)j3;lyHLOY>`x|BUn4z*gVJ*vih> z(t-*x?u(a}_I5&d?;02z9@UDu}qsFK6sz zV5aui*xbOv7R(|1-~l(c;MD{F>#ILg{`IK(pGP@3|Le)WzWL`#K{mt={@T$ma$Q{o z^b*DtWcy8fVN3=)v>9+5mB2ePcp-jrz>EH$ckr1#oi4CD0leEidHhJp>Dv0F zb2g>&?B%xYxaKhCbyP;*mswP_zE4F{rPLm`lO_~Cxf^^t`?cB`7B=bo4@z>0eIj_& z3J>T5XOIo18NKBb=>vTgn2L)DG_W+(Q?M?MIu8%O#0bP1@s%Ai>c>$QV>_u6})Uz4z@h?Ub_KRs-Ch zAdc+r?oPqK(=5PT-`8BU^z1+PftyhqsD)9l{=U5uA@_dfT@TamVUUn1h^Uy?*xCJ| zV9rXdgm&uN_41LPDhO_PX-G>ys#b zs%6?|j1Yd>4(nULH*Z4IYk@InAyS{ZmvfVo7_oUfFVUwz1}vr>PVK$ZEZaWNUc$e7 z@!kKuR3v13yw`Ly#=~i&rTj-+Ne>!B3-4UX|cka<1&1Pou3^luX`t#eqMPC zM*I&sPmpuO;w8rw$45jsSgx*4QuWfWKQTWn;U4Q5S8Ol!N#>by^0@Xdvf!#};mElpa6rIC0e!STxP6iLj^PHGu{S|7TJ# zJ+@eadV=DFN;cfCsq|%ynbgJ}!#Io^L0GSD%wqfnf>Q!G>5GCKHCSHKXlc3bD1W{D z7fkcNhe#An#!LG#m8~=JbvC@DsnMcDXtRSKu{F`<>l)X24aVn7owSq9l@AFCPb+F- zKg^_4(4PFWaRdq2rNADZ7YOB+6>ZLbcb_DR%qeYgS4VIJ-b##U*3YkIt`o!Em6DLd zz`U>Wt`liyu`}tn*m2!+pgtJ;{*>rL|4fqi4ehH z%+O7-SnRr}ua-JaIn#}6+n<}&ogZw^s$HE<`ulGIgiM80tzJF(FB%J(R42`YpW5%0 ze$L8fnWD_YCvPIn{%bsTRAd~_Iq{0F)KcR~`$){7YD!Bw-TphOpD zoJYzipWH7WtR#lC>>Gk*aZr^05nw8IjBDs3Q(U>OLaZf}m#^zyy8BZ&{G6q~5?zyf z`EJKM>n0TBe0%TVI;t&BRbM8C(>D(a0pI;M&!92Ph|*69S?pH&Q13HE8xUBIoP-E$ zl0ZJ#UkN}IM)giR6G{V>|6?2;#Z@ za|45IZOOHH2t^}2843%*ZTlq&&rx+eju)91tb3CSk7zJ`q1KQRLb%E9oOvz}8~tEMN(|x9q;>Rbt&vKUyOAaX3fY&s@RQ5im*abUsL&-D=l5UA5uiV{76p{gS7XyR zX#SsSQH%;Fpx70x9hthUYExljOoxax!~E=Md$jh<2eEQFHZRY!c?gPF5-)pyWkh*b zqWnahy~|$=~WBJ^YP#yp#20Dl#<-&bzsO_*!y; zRO-0WwEN-Yym---9+JcNT8?vN#R{3TqQ?m(^@Yy$32O)zwHgeQlvL@cJe>cZ!bF{r zK&PYSxXLc&UcIT{PEL~1C1NtrL+QGH3ljAoff77jFH*N6@Rx|QUicz~`F2k42`5l5 zS|-}k52Q}&hP}Y)-rP(0TPY`8C&xQR%FPP$ES{_n9gp^vToZWFfC`DYlD-5<JQTX zQgP-f2SSGv1OBOx5%ft9`&R9|JB$_5j(pEoG|qk@pPp4h1v?;M|DlR^@!k?e1hhZ(mt>`riCOu>Evsqq-4JC{PIxOU*SS<){ms2X#Mwp`{4dJ` z1fIZIb)>_arYzi7(sU%ZON`cElJRiNl!|WB zylG864zMq40g5ua{z~2avtKf*nS@qd20;;RvI6+E`^gGmAs#GaJOLn}pTKFQl zZAODI0pSQHOpkoyO>|a7IeQWJCeMGueu>5btDU4CTL7G7~tI(<cc2`29iy{!gGirvWk;Murqp6 zSmqF%qjBiZBuYx(9)h{WBNn% z^aQXn+^&5GZ<;#PDiZRF*gH^_D|uR@1xEcvsBXxHx+G@E1f{>kHgF(ogqgHhe#@n3 z({;f7pK}2@-(JZymGYYzdgY*tKg@#h&$9UI!z6y0d4=m3Aqq_^uzxrmu}BHTFi!st zgZlpm+PF-5(`Y;D>c-#Eh=|>swn4H(h$kbnsFl)ebYt&dT2$&5Pz3H;dD2$JPTO8AHTr)^J#pS(22qY;%8XSJ*Uh@O9zr-p4i2cN- z3x#*`@$Ry}dXeFE-K?9b zKrYR51)j-k!&&F|?cu`)P7d<-LK@7Np+1ML~yrMax|3rOEVPH{MtU! zEsyh0iiq4|LNFmN1|IqTx91DD|Jq?FkPg%G+=TDr2Ue6=={RrJ_--V zr<1`R`1-tKT;Tu3C^A-$trmJvX@T^FGKyM#VwCj!iwKO2U=NM9H6uPW+7MXgaqdXb zU{J;BW))kuP7S|n_0EhBF3z}FQI}+s)A{~LgQ6lrC%~kn13aDr+C7qgN53IEwcFxEWwXfI^r#^=TYPA8x$Op9coss za&~f$quEjG#bhc|cupDR&aRaxDt9Ro027Fo-TqPpc2Yn;;ckI*rqM1E^BFBN@=ukH z^b4bb`aSu0-)VS9kB`{&0+XKK+A33Qy7`vhj$78%_($s|t(6j|%WC&? ztTswU?%y=nTj`tiBeTHJZwYxmW=Stlh8aTXybxw}vYNJ>#@sE{&SUlsv%U{)roc26 zFgl~VD+&2;Wr>8mfdy1NW$p+I@6NvBSFG>#VYR`VpY=o9rpO2&tBL-Um{IlkY?v^_ zcJmh_G@HA~%xjdbieL97S*;}c8_xHcQFZZ-z3`{-vvWg*inq7bGu{JYnHXI!_ZQRt zz`KSnA?ybXH&LP)Egm{_`ncP%AtNnLqq1YSM+CxJxsvqrXCv|`mo%pkFdB@ z%IU*ovUXnHewQ;RRqHbs>XIp@V!e8Avw?E!`3B&n;rro2bk@hVE1PZlpU`o+waB-i z|J=NR5yI{FaM_6s%rS*!-~AWcilPI@>bN&|gqC-0uOn9xwsqS3+~BEI3cT`oDcZ-7 z)Yy1mY{j4>;(Cp#6kEPZZ*otnj$BTp=~iI}>*#~1^WC+qJU@Z0YL2rFOV5r<2J#8p z9-&5gC`Gt?<9I;}#M9$5m#GSoOI~Fs9`&YA_pRnrqy;y`SeP?X=Npn#8#6w2itm3$J}8R*$#s=3_a82@v=st0aba zsIu1V^;-=ot2X%?m$RnL>AU50_x;o}6HS;yMuigAJ;KKQ%hPcH*1n?dY7Mv2zi=3x z6pk?MZ|MD2r1HeMDX7pBx7F*TBifGI4ygw9VTQ|E&Wqs{Z#Nt77{%Nw9W%+wf7ujZ zwcSLF>r{V0sHzp#qt`DZ9l?A9ox)D8woYa5^~81y1j0S~>f_HrMcL~$-^aJqZCVCr zUU$dvjh0tmPPuNy25*Q%PUMF7R+3?UY;LnyQ!(zY6BLdU4`yx&cqhmBhg0HH@vaq+ zwJ-h-L@)+bfu^{wMaO%WcgHA6`3^d?t5*4WOT|X%c!TqDY$QYhhU&3ls@nnIUFyPe z*$R!cbektbX}D98r&-48w#cM=<8aE=a@ZV%Y&Ur(ti&%`$8bG<`XoTuM2_2J8-N;E zGf~L}O5g3c1LQ-5kMySEZj-MbE_h?HwoZ+tpsXArxK$j45*~s%-(iaxfMqV-zCGji zrpd_PO9J+hZAv-!#&3!zL;wTpww-(EVl}u5?NNYPURp5E&q%@ijU9TUxJ=Qs0(5SB z><_8>S8de_SWW|d57LG*g5&8V7>fe6Rk!Orr8df@TughJAJlwyY5&A<>>Ah&Wcue& zo(I3z^=tmL$LV5K_4&d0qpgU3o^)e|XoiLE z6E}|~j`+4|pM{xp68cqb=m}A2VX9N@;7t1ZX9M#BT!3=onb*(*-VbyPHx>I6I;R3- zu3HVa#|W|Oin_t^Kin0w=BL|XG^cizbv*;m4akFvIV@^CSH`C=97qHl*57Qh)t%Y! z&b&d{;qF4?-z=Z^Mvj|HawOCS*wC?S0Bgm<2dj35G;Al%?Dg{}+tz*$c{OU?oSoJS zTD&jRhV5T-4o{i*UfQSfu&v z3q3ooDW!{(lQU%ZNvF>*zNd@BuwCx%iY6G`s9273o@CnA*R(J#v!hCePIn8RuAA`) ztvLV}A@6XC8e&TiynjiNlRj8O$%qcTk()(G#xWqTLb-R*o&MGe8d!uyxpdI2-^_yK z#SK}uZ-ctqKZ6i%$$ z9y4H2$fO)MmZadtODRR7wbzFI;5a_lm8Fjc=D1J1tN@n!Y`lx$`-7>K>%d%`8 za>e$Jg21A5kE2G2VNqtg%wVTKfHQ+ib?|_0@vUm*`lDN@e&&i!`Xv97g~_8tGoqmH zBOFHEF;>lYj250xUtSy*SxVaac$3#)yViSOS04ZzAfOlV;gpMM(Y=-0e?dF9_GE3n zue_RCgCUNMmN&o%S`x*u*JbI!q2)MfKl;VM9^tGc|04YZ1nH|1wQ&9-{q;3+@~(Ih zk(Drpp4^=@Jpg;XIN4i0E_+!~^UH>f-wYYf(Igf=9qn0SYiGsM$^~F+0`yz;iouAB zk=$rfuf!Jj$<$#jadXg}kM@1b$Js^Qmg`M|Y#Ev(HqP4B^P$K(k?Az+#8TvH6)E3}DxtyWdI{!J2{afj#Rw?fac?TU%YS5#;dbZBp7vd80~Xg&5B{|}%i z8@4=b3inaGl);e(dfB zra9-lQC3cA`xs}@6PVBWHq5j0^tA*>*vaW>kPvNTfv)#LUEaQ z@snahQIGKWCPSgRJZ3wAo-sAANpwhvHeyZ#o}k%3I0aR&R6=gOd>TYZTF4{$bl~Pj zq?XMS;ay2MreYM!NhbsS4pwrg^o87i-A5qQI zi4BJDbg=b|SKCZEFB`C})gH|SHg@q$$8a(AjsjG5f|gmm@Lu$43R;&*f7J(0aYh}x z5Hic^2UT(9+HksfH=6_cxT)Y&Jn2C1T!fcs2GoIiO|0!Jieq#yR)pOzBx|<%lT*Zd zeNS#=Mv5}lW7K|an`|<`#?$Yz?DnOnLIL;S+=64)lG%_t;HcK?nkqO&~*r(%ZQY4F3vao}#W%l7D%O15&!V zrOX18b&E(VR~axhz^Dy8{)vB~fuVOn5Sk>Ri+J420XVf|@=3V=VPo)+HWfI!>pbtN z5l8obK1VQU*t6Y(LFiBvBsd3bL)7vHF!RIb3nqV=dEkbAa@bYW4T*KIb3yo`HHaXU z>@Y0rcfuA=lnRf$#1H)3eN+jjB~ z&4lQ{Xj3f8YMdZDl5aAU*-!CRCYJQRY@AkQuq1*~7QhL$ubS6l`@K8S9xzUcqiH0I zCXr!x%xM1Z_xJdX#l{1q7Dg!GE;%}&8Tlv8a|wSN#)LFL@3E>HROkj@9~QVAid26q z9_26MyF3Q;s3B`hHu-AzEmyL!kyU&WL|{nO%{1DZ_=4dBNs| z!Q$r!`t4C8rf?cwjh?q?e{KHZHE$YWjH^=-XF)8i>e8S!C^_+hz)JAh8uaGv!gZt%es{%k&O5UJe&Q2XJM`Y`VzO^XWJst6sNkO+`~u>b+p znFpok*|xgqXP*3ruf0@$O-s7RVg&u|I9)@{qy=DEvQ6wv>)lTqnAK-H9kbm6TV`dh za`bip4>95hn~Tjn@wXCeb{K)*CI@(|^z3HUR=0YH(7}&YVf5iV6=KsGh-coUn%W?z@b7UY<7saH(L5#?a+3Y)Uu9vDE3yLxZOz9EL$ziJ6`l z%P7y(7%uvzJGOZH1HbJTt$vNR__-y6Y|T>1U6gaha4f=6TKE1i90dY@($L;&nvp8f z+2alN#?np8t5OT06ylGuX=iu=q7zmN6Lr;48vx=OY^@gPC&%vb_J9-%X>$n0c)IlB z_`HY~*AH2bosTaLCmk($EqtK}1of!L^Wx)vA67n0aHsXmcXWH(sYPB~lA9{@hSL6_ z@60<~`roTSLKeC!hb^b&IFnd8tZgzWf+;1VZ>sh&Rhd?@#wW~Y%@VvNcMbKrWXVxD=2_S><$(-BgdlkKAG+lH3 zg^f4@ucp1fnwpe$0>tNR7T2@2awWA-F-_(sV+p|}UPN8PSBXF(gQBQC^?|}66-@)S zAH&I38_an%2O8Xs>%lxzt-@(8f-=_<8|ocuSD(e3cgYNt)b0;!jxul=QizKfa14&c zS{K_awy%@g%W20`?hbUu8U}{s{CqylU$#!hvZGn>Qi8JExO#iuYf2VIzE+f_4|gd6 znHTOaVbx?T9t3?YW_E5HdGLXC&RFQ7n7#WZVUh`VoCtbw_oDua@M|IfDxOZSlSEad zeK9?eER&2EiB*hOKTnT;IynH+m9H*H>nIBbxSda2>|{n)4mI_MYx;Ov8TOP`#=DoH zY#}3`_sxBFKIDmrbTv=3mmZxegh#gFlXIP-7X3Hd_CjQ~=PECGRY97$WHa94Mo66N zW`$K3*T}2+ki3#fd-v0kz10CtKYm$}bG!1*N;sN(-1dBnKb!liG|GjVxnt0lvdH-@ z_krg;i)pI8_w!Vw&$#y2$m*W)U5Kl}u-Am74kv778^uebW>Z9dLO_;?nbX7$&sQ;O za`5%>>GUO~2iPmmSWL}~re{7A(z{4dxZxWWmAEAFLX146qDGBXEuTv8>}R8T(E;CT z%Ew{XzVbukA=UX$@R=Q`Hk!ylL6s)IJ(#Ok+x?887Db?H>V)3vC}8p~5?1 zes$aEk60aNL|&A4i)%aMCtBIs4@6nPWCT9m&|$OT!zm#SZ@ywu4MQ0+08G*W4yI z=57Egl4!3*wb~3w{v*!>6F(nAD7{wiX~-V>!8}YP?z(~XrTf7sT@26<)&p8!-%`Uwt-%5f{wd-O>Qy{Vb=~kTxnNiWV z1SjefeT^bP&Sdd;u1WNs{B20XNuzF&;F$Vey5@u8J`ZcFfi>P>cEhp(xIxeAdtHv=0i2?RwKjc5xZtk+xL{ z&lMyXbDVZ>L?oIV2c9usXWU@MR1D!;`n=yfvc_+3=Ds;^sblIO?5h-i^qp=P3pUrI zS#)0VJQ3#6Q$xQ}3o=UHxn=l)4Ye=TQq?8OrafH8mxEB0UxR=U$ktaynT!3FzSf>BVS6?>IwE+3Qm*J8>Z9{?Bcr; znV*nNnq*DYwdFMNP~X0lNJv^oy~U^*Mr&pujdTrv^p=>~_>#yGq+7spb3$ONCc3lg zkSD%pzVi#8<5K4#j$5^7PmKD?D6k!)ZYI z_?$X`|Eg!4fD99v(we2uP3{%@+T)tp57MkR5N3IIfVH?+?8W+zf?3=6Q!O>SK8f9p z?RH?KZ+UD7>b_Ogai*OjMv=Np0%*h+E4_)w z2Tle{onIcEyB;q_?skd$Vc&pKI=@o0ZX(<@x7Tq7=x@Vwp2<)4)&)&OSYSb}jd1gQ z{yF_MfqtP>eani)h*=uQu~hH*!4G|yFM@AG7M?QY5I6v&G5==+*7CR=u8#Zu&}KZ zx}w5$>qs-|JkLiwDI&CN+SWM`My?UaKtxWO@Y)EdaD$u0UnHK#U!E=R_ACiJRRPfR zv~LTDh0m4_+Q!RcDe2T@wOy(hfRbBU?szzYoNH5m%E*MWK_eWi~ zYIp>X7d{?e+=Umy2ho?iW62OD0B0l`2pg`ZAI#NoH<0!a;B$t6%*y6Vwe(tN4Yp>_DSR(5|L=6R-H z4nR=%ca)1DeNG_>qoj}wA_>#(K{!FVw zm26&^Y6rq=zZP$9oHGzdIpW_U--m|w{K1;-vPDls!nL>F&a43OylE8g?f~1eXrXY# zK6x}|)(0B|wb?A`dr6Q^D22UJ9^}D5nk=s3*Jsv6*%QEF^S%Ip^a~HbF$cUoAV+@( zN963MAta~i;s~1M@y+v~D89?%Xg|$%`+XaI|a?=OaZUGzV$Q%ByuDYCXDaI^g1Agt)9ES^=5c|KSd@BB&H} zI-nvbCgIX?GSH*i9n5CIC(6Lz1JeA{`U`U0q*TIR8}QD{M{w8d zoI&kQ!(yavocZvDw!XNh;x^V&jw@W-!7CS77id>3PmXb1#5&JT zS4%elf8NOEsbfH@&@_Ty7Pu8wUT2cL%V4IMA#YxZ4r+dcW!64UVHuS2OS)Y)AI8Dz z5}rzuv(P(tBig0@NgjSfLev($xS}Kswz^Ho_K{8&2gq|=7E8EMjJ0I%J0!N%ceKHb zN5f^c;pe;#(ZKm*4kG94ABt#?KU<(XhPk@y^`|^}F_+oT0HeDrx6_i~Sa z-{-WQDX$Y^8Q>Gk`??ncFZjDWhH~+Dn0%AS#e5jmsuXa4Nefb-W1I?)Y4U`(-^;$b zrg4_6OQS$gdbY$<*XBb>k;eQ@sz*@?2Hj18Wz_&hF*_H?)-6)nLg~5yYiO#ECjAb} zUxd6<*`r?qg%P3V?_-OpYrE}q$#XeRSqTcCMRT(V_}5OyI*c)p)$jU?oKa5z6*YQb zI4vQF$yDpv56W_1@vkum)K`0cr^%kvcdF|sggZnVre0`f^%;4*Wvzwnj~Xt&y98mK z$=69I5t;`6&$ygEYUXi4<)@3W5}R!$)OD55kSB^lZwaK- z9|LMct4p#t#;*T~Gw6=0-HqMab2+26?A4R7%{v?MJXft%h3z0*Sm&Btrft}8A>@bh z2?SEK?r%kk`dy@a{-@}&O6UMRuYzdev3)hK=zC~xidWD$H`6@iT*7?7*)3prWM$kT8aaj&t7JakfHCf|2>$P|tR|RN z>T*D^#*Op--5*cR8L{LtJ3|iA$<8%HghCc6JlW2DZuFpFGcT)z zWge2V4coi0;}td>g&h=9Q3*>9)jEZI0i_Jlk!kBk+pr7C4NhdEQG-bH;;Ph*?Rz7X z6sgYkoNYx<-Fddj<@jHl4X$sqm9XuGn8!Jx^^(J`)Pxe@-1R)|{+`_K>%~ znxE8nPGW?GM}5!!JqkALtY2Rql#{qSv?kq>$gmY0wU-y!i(M7oCtI0&LnG`-KD@%a z?I=G8OR`NJpW70f{YWXa=b7AJYOM{+WdXp(=-0wi+KZrJ#c0XAa<;0?JvW;^PZ7== zE@$a+xjuX$MBS7egPtP$vCiJ^b*w#a+#9WnnVizpN;MI=T05cY7W zWK#itF@Q^xW9t1nJd;UEKBF#aM72k@6LNXfGK=U1k#z>KkCMj(eQdGDF4?jDhVV~N z`SF7WW2NKX1fsmA&{^57vvzMNJ~rM!a4Wcb+~nKso{r=mXC3OCvXf-(!_P~8j8RIw zaiQwF6YBu0deIt6&F|JBEy(Afivr_S>wS+X|MCmw9!rOQPTFw6wgArXF|MI`R^iHY z59k5q_9TCr7(xyK5!*Vuge7%gFoDU+1M%?Sh)7)zK3AXUgEZW$ppbd4%szCT^NNXWZS z5Hhh`=}pCg6Qsq@X(N|XmHM9DA ziciGL*U=pXZ$Et_QU8SFM>)ip$N{&efTb)!l);K5El;HW64p1Hur^9Txy--yXT?TO5#{gEZs4KxzLm9 z?7EAS(Um(QhI1RN`zY#(al{oSDIX$LJTW4#U#s-Yt5}Lks5O@FO&rO?rQjb-Ta{m9 z(Kw+T!u6*s4z z7tYDhh&}g}-R-wa28YrU=s9IBxDncpZb3&H{kA}B>I+S+L9Mp&Hx*9lVk4A*=ESPV7Ko|r_R2wRTSAwy&w$6eCl}w zf57NVqtWhteM45fc<;0b1$38^_uZqvB%XP;z23D2idy6&X9E(51NKsNSz%y!+S!E!IU=7uTkW2ZkR zO~?|;!?eGuCG zV<7^{D45M`gjn{EKg#ekM6d8om4Tvu0}&5K-ufOZ)&sXuOQdJ@&wAxJ|G>NSZ+0mwJpFF_&VO&2ot3A+6e*q030 z*fP(@iXIn&=k=kv>M(!j!q*$R#;M_jR_)0VQRgcoMssjwAquZl^Bh)V(PXNp$)6|U zljc)qKaU{-p3&&3i@h`vUl6UQw6x6WbqYjjr)};cbcWEAe=@T`BQNF!nl~WD7Tn7u#U7yC<@~6#GR8JT)rQR1Fdz<{d0?oT_et5PS z^477G=CKlJPPOR$J{C+_m*Mv9`0QHnK{*Jwd?Xc03RhTkOmj+9^1kL=;Hluraq|S> zWS^?h$Z_f_7Xi4KsqJIRKT^ zF$UL*qKx1GTr?hLj-L=P|Iu#0cG`cQh*V%E|2l<-m`JEFjY<|)Xl%1@7%0h<3d`gI zMN*wATlIz`u_63B+a2wUuxo3)IR_={F&jTXkp#|vw}c=g90J9vsVAUnYy%M)gP3>q zLFM-mEq_E!ISy!S>4fNKh{vCd`6KGpqdy5!zMt23{`B6X7nh8?GurjjcKVmX3bX!O z_Y8JXY5*!SD)q1?Nf<;%&n}_{tNW5{jXB3aNZ*(Bo|35_gThzOc!jvmKG!TR+RpB& z`nV2-6!&+SUHF%K5G(`9liEG*@+5X>%lo{d(Rqg`>8CK**F*o!n_bZ_m zOX+HWh+$s3TMVkY`;!tb_ZmlPJG4nE6H@3V#|u7j9L2~7y&JKspFIe=T9kjJ&h*22 zoU5J+<;U~e-H}jg@xqZBo+wV&gdSZx!Si<` z>Eze(F>mkDh@2RZc*x#_GNbaKq}`s&L>kc_{$Ky9;34Sp*er#| zl8_&h?qBwrHs}Xa_02<1K=GJEv_m*1GXatDrw-7rLbBJKB}rpBHiRC6h!~3zMMskj z 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 u=GK#%^9s)}a+2U%<};8; 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 ZVpNU;={8ENU^~M&s!AG)74qhx{|9g`Dir_# literal 0 HcmV?d00001 diff --git a/ng2-components/ng2-alfresco-core/docs/adf-toolbar-06.png b/ng2-components/ng2-alfresco-core/docs/adf-toolbar-06.png new file mode 100644 index 0000000000000000000000000000000000000000..6b57d21e139118bd9f7694fd7054f7a1f6510562 GIT binary patch literal 14208 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 EFC%ViEdT%j literal 0 HcmV?d00001 diff --git a/ng2-components/ng2-alfresco-core/docs/adf-toolbar-07.png b/ng2-components/ng2-alfresco-core/docs/adf-toolbar-07.png new file mode 100644 index 0000000000000000000000000000000000000000..25034ab23efad572f2f79fce528d1ce8e0be271e GIT binary patch literal 14724 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 -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) - * [DataTable Properties](#datatable-properties) - * [DataColumn Properties](#datacolumn-properties) - * [DataTable Events](#datatable-events) - * [DataTable DOM Events](#datatable-dom-events) - * [Automatic column header translation](#automatic-column-header-translation) - * [Custom tooltips](#custom-tooltips) - * [Custom Empty content template](#custom-empty-content-template) - * [Custom Empty content template](#custom-empty-content-template-1) - * [Loading content template](#loading-content-template) - * [Column Templates](#column-templates) - * [Events](#events) - + [rowClick event](#rowclick-event) - + [rowDblClick event](#rowdblclick-event) - + [showRowContextMenu event](#showrowcontextmenu-event) - + [showRowActionsMenu event](#showrowactionsmenu-event) - + [executeRowAction event](#executerowaction-event) -- [Data sources](#data-sources) -- [Generate schema](#generate-schema) +- [DataTable component](#datatable-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) + + [DataColumn Properties](#datacolumn-properties) + + [DataTable DOM Events](#datatable-dom-events) + + [Automatic column header translation](#automatic-column-header-translation) + + [Custom tooltips](#custom-tooltips) + + [Custom Empty content template](#custom-empty-content-template) + + [Loading content template](#loading-content-template) + + [Column Templates](#column-templates) + + [Events](#events-1) + - [rowClick event](#rowclick-event) + - [rowDblClick event](#rowdblclick-event) + - [showRowContextMenu event](#showrowcontextmenu-event) + - [showRowActionsMenu event](#showrowactionsmenu-event) + - [executeRowAction event](#executerowaction-event) + + [Data sources](#data-sources) + + [Generate schema](#generate-schema) - [Pagination Component](#pagination-component) - * [Properties](#properties) - * [Events](#events-1) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) + * [Basic Usage](#basic-usage) + + [Properties](#properties-1) + + [Events](#events-2) + * [Details](#details-1) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) +## DataTable component + +Displays data as a table with customizable columns and presentation. + +![DataTable demo](docs/assets/datatable-demo.png) + See it live: [DataTable Quickstart](https://embed.plnkr.co/80qr4YFBeHjLMdAV0F6l/) -## Prerequisites - -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-datatable -``` - -## Basic usage +### Basic usage **app.component.html** @@ -99,8 +98,6 @@ export class DataTableDemo { } ``` -![DataTable demo](docs/assets/datatable-demo.png) - You can also use HTML-based schema declaration like shown below: ```html @@ -146,7 +143,7 @@ export class DataTableDemo { } ``` -### DataTable Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -165,9 +162,19 @@ export class DataTableDemo { | showHeader | boolean | true | Toggles header visibility | | selection | DataRow[] | [] | Contains selected rows | -### DataColumn Properties +#### Events -Here's the list of available properties you can define for a Data Column definition. +| Name | Description +| --- | --- | +| [rowClick](#rowclick-event) | Emitted when user clicks the row | +| [rowDblClick](#rowdblclick-event) | Emitted when user double-clicks the row | +| [showRowContextMenu](#showrowcontextmenu-event) | Emitted before context menu is displayed for a row | +| [showRowActionsMenu](#showrowactionsmenu-event) | Emitted before actions menu is displayed for a row | +| [executeRowAction](#executerowaction-event) | Emitted when row action is executed by user | + +### Details + +#### DataColumn Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -181,17 +188,7 @@ Here's the list of available properties you can define for a Data Column definit | class | string | | Additional CSS class to be applied to column (header and cells) | | formatTooltip | Function | | Custom tooltip formatter function. | -### DataTable Events - -| Name | Description -| --- | --- | -| [rowClick](#rowclick-event) | Emitted when user clicks the row | -| [rowDblClick](#rowdblclick-event) | Emitted when user double-clicks the row | -| [showRowContextMenu](#showrowcontextmenu-event) | Emitted before context menu is displayed for a row | -| [showRowActionsMenu](#showrowactionsmenu-event) | Emitted before actions menu is displayed for a row | -| [executeRowAction](#executerowaction-event) | Emitted when row action is executed by user | - -### DataTable DOM Events +#### DataTable DOM Events Below are the DOM events raised by DataTable component. These events bubble up the component tree and can be handled by any parent component. @@ -221,7 +218,7 @@ onRowClick(event) { ![](docs/assets/datatable-dom-events.png) -### Automatic column header translation +#### Automatic column header translation You can also use i18n resource keys with DataColumn `title` property. The component will automatically check the corresponding i18n resources and fetch corresponding value. @@ -235,7 +232,7 @@ The component will automatically check the corresponding i18n resources and fetc This feature is optional. Regular text either plain or converted via the `translate` pipe will still be working as it was before. -### Custom tooltips +#### Custom tooltips You can create custom tooltips for the table cells by providing a `formatTooltip` property with a tooltip formatter function when declaring a data column. @@ -268,7 +265,7 @@ export class MyComponent { To disable the tooltip your function can return `null` or an empty string. -### Custom Empty content template +#### Custom Empty content template You can add a template that will be shown when there are no results in your datatable: @@ -294,9 +291,7 @@ You can add a template that will be shown when there are no results in your data ``` -### Custom Empty content template - -You can use the empty list component if you want to show the default ADF empty template: +You can use the empty list component if you want to show the default ADF empty template. You can use any HTML layout or Angular component as a content of the empty template section by using the special `, , ` elements: @@ -330,7 +325,7 @@ You can use any HTML layout or Angular component as a content of the empty templ ![](docs/assets/adf-empty-list.png) -### Loading content template +#### Loading content template You can add a template that will be shown during the loading of your data: @@ -368,7 +363,7 @@ You can add a template that will be shown during the loading of your data: Note: the `` and `` can be used together -### Column Templates +#### Column Templates It is possible to assign a custom column template like the following: @@ -414,11 +409,11 @@ In the second case `entry` variable is holding a reference to the following data } ``` -### Events +#### Events -#### rowClick event +##### rowClick event -_This event is emitted when user clicks the row._ +Emitted when user clicks a row. Event properties: @@ -436,11 +431,11 @@ onRowClicked(event: DataRowEvent) { } ``` -_This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour._ +This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour. -#### rowDblClick event +##### rowDblClick event -_This event is emitted when user double-clicks the row._ +Emitted when user double-clicks a row. Event properties: @@ -458,11 +453,11 @@ onRowDblClicked(event: DataRowEvent) { } ``` -_This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour._ +This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour. -#### showRowContextMenu event +##### showRowContextMenu event -_Emitted before context menu is displayed for a row._ +Emitted before context menu is displayed for a row. Note that DataTable itself does not populate context menu items, you can provide all necessary content via handler. @@ -488,17 +483,17 @@ onShowRowContextMenu(event: DataCellEvent) { } ``` -_This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour._ +This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour. DataTable will automatically render provided menu items. -_Please refer to [ContextMenu](https://www.npmjs.com/package/ng2-alfresco-core) -documentation for more details on context actions format and behaviour._ +See the [ContextMenu](https://www.npmjs.com/package/ng2-alfresco-core) +documentation for more details on context actions format and behaviour. -#### showRowActionsMenu event +##### showRowActionsMenu event -_Emitted before actions menu is displayed for a row. -Requires `actions` property to be set to `true`._ +Emitted before actions menu is displayed for a row. +Requires `actions` property to be set to `true`. Event properties: @@ -512,11 +507,11 @@ value: { Note that DataTable itself does not populate action menu items, you can provide all necessary content via handler. -_This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour._ +This event is cancellable, you can use `event.preventDefault()` to prevent default behaviour. -#### executeRowAction event +##### executeRowAction event -_Emitted when row action is executed by user._ +Emitted when a row action is executed by the user. Usually accompanies `showRowActionsMenu` event. DataTable itself does not execute actions but provides support for external @@ -566,7 +561,7 @@ Once corresponding action is clicked in the dropdown menu DataTable invokes `exe where you can handle the process, inspect the action payload and all custom properties defined earlier, and do corresponding actions. -## Data sources +#### Data sources DataTable component gets data by means of data adapter. It is possible having data retrieved from different kinds of sources by implementing @@ -634,7 +629,7 @@ let data = new ObjectDataTableAdapter( ); ``` -## Generate schema +#### Generate schema It is possible to auto generate your schema if you have only the data row @@ -667,29 +662,67 @@ let schema = ObjectDataTableAdapter.generateSchema(data); ## Pagination Component +Adds pagination to the component it is used with. + +![](docs/assets/basic.png) + +### Basic Usage + +```html + + +``` + +#### Properties + +| Name | Type | Default | Description | +| --- | --- | --- | --- | +| pagination | Pagination | | Pagination object | +| supportedPageSizes | Array<number> | [ 25, 50, 100 ] | An array of page sizes | + +#### Events + +| Name | Type | Description | +| --- | --- | --- | +| change | EventEmitter<PaginationQueryParams> | Triggered for any action in pagination | +| nextPage | EventEmitter<Pagination> | Triggered on next page action | +| prevPage | EventEmitter<Pagination> | Triggered on previous page action | +| changePageSize | EventEmitter<Pagination> | Triggered on page size change action | +| changePageNumber | EventEmitter<Pagination> | Triggered on page change action | + +### Details + The pagination object is a generic component to paginate component. The Alfresco API are paginated and return a Pagination object. You can use the pagination object to feed the pagination component and then listen to the event which returns the current pagination and query again the API with the options chosen by the user. -![DataTable demo](docs/assets/pagination-demo.png) +Each event helps to detect the certain action that user have made using the component. -### Properties +For `change` event, a [PaginationQueryParams](https://github.com/Alfresco/alfresco-ng2-components/tree/master/ng2-components/ng2-alfresco-core/src/components/pagination/pagination-query-params.ts) (including the query params supported by the REST API, `skipCount` and `maxItems`) is returned. -| Name | Type | Default | Description -| --- | --- | --- | --- | -| supportedPageSizes | numer[] | [5, 10, 20, 50, 100] | This array describes the set of options shown in the pick list | -| maxItems | boolean | false | Max number of elements shown per page. If you pick another size from the pick list this option will be overwritten | -| pagination | Pagination | {count: 0, totalItems: 0, skipCount: 0, maxItems: 20 , hasMoreItems: true} | The Alfresco Api returns a pagination object, you can use it to feed the pagination component, or create your own. | +For all events other than `change`, a new [Pagination object](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-core-rest-api/docs/Pagination.md) is returned as in the folowing example, with updated properties to be used to query further. -### Events +## Project Information -| Name | Description -| --- | --- | -| changePageSize | Emitted when user picks one of the options from the pick list | -| nextPage | Emitted when user clicks next page button | -| prevPage | Emitted when user clicks previous page button | +### Prerequisites -All the events carry with them the current pagination object. +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). -## Build from sources +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-datatable +``` + +### Build from sources You can build component from sources with the following commands: @@ -701,7 +734,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -710,7 +743,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -720,6 +753,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-datatable/docs/assets/basic.png b/ng2-components/ng2-alfresco-datatable/docs/assets/basic.png new file mode 100644 index 0000000000000000000000000000000000000000..9ceb4da7abf4f8d1e590fa47adafebfb043c4c3d GIT binary patch literal 20119 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 Fng9emT>=0A literal 0 HcmV?d00001 diff --git a/ng2-components/ng2-alfresco-documentlist/README.md b/ng2-components/ng2-alfresco-documentlist/README.md index abe9c0c7b8..369e7bed35 100644 --- a/ng2-components/ng2-alfresco-documentlist/README.md +++ b/ng2-components/ng2-alfresco-documentlist/README.md @@ -1,42 +1,32 @@ -# DocumentList Component +# DocumentList library + +Contains the Document List component and other related components and classes. -- [Prerequisites](#prerequisites) -- [See also](#see-also) -- [Install](#install) -- [Document List](#document-list) - * [Properties](#properties) - * [Events](#events) - * [DOM Events](#dom-events) - * [Handling DOM events](#handling-dom-events) - * [Data Sources](#data-sources) - + [Node ID](#node-id) - + [Repository aliases](#repository-aliases) - + [DocumentList aliases](#documentlist-aliases) - * [Trashcan](#trashcan) - * [Shared Links](#shared-links) - * [Sites](#sites) - * [Favorites](#favorites) - * [Recent Files](#recent-files) - * [Setting default folder](#setting-default-folder) -- [Custom icons for selected rows](#custom-icons-for-selected-rows) -- [Calling DocumentList api directly](#calling-documentlist-api-directly) -- [Breadcrumb Component](#breadcrumb-component) - * [Properties](#properties-1) - * [Events](#events-1) -- [Dropdown Site Component](#dropdown-site-component) - * [Events](#events-2) -- [Custom columns](#custom-columns) - * [DataColumn Properties](#datacolumn-properties) - * [Column Types](#column-types) - * [Underlying node object](#underlying-node-object) - * [Date Column](#date-column) - * [Location Column](#location-column) - * [Column Template](#column-template) - * [Actions](#actions) +- [Document List component](#document-list-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) + + [DOM Events](#dom-events) + + [Data Sources](#data-sources) + - [Node ID](#node-id) + - [Repository aliases](#repository-aliases) + - [DocumentList aliases](#documentlist-aliases) + + [Setting default folder](#setting-default-folder) + + [Custom icons for selected rows](#custom-icons-for-selected-rows) + + [Calling DocumentList api directly](#calling-documentlist-api-directly) + + [Custom columns](#custom-columns) + + [DataColumn Properties](#datacolumn-properties) + + [Column Types](#column-types) + + [Underlying node object](#underlying-node-object) + + [Date Column](#date-column) + + [Location Column](#location-column) + + [Column Template](#column-template) + + [Actions](#actions) + [Menu actions](#menu-actions) + [Default action handlers](#default-action-handlers) - [Delete - System handler combined with custom handler](#delete---system-handler-combined-with-custom-handler) @@ -44,11 +34,17 @@ - [Delete - Disable button checking the permission](#delete---disable-button-checking-the-permission) - [Download](#download) - [Copy and move](#copy-and-move) - * [Error, Permission and success callback](#error-permission-and-success-callback) + - [Error, Permission and success callback](#error-permission-and-success-callback) + [Folder actions](#folder-actions) - * [Context Menu](#context-menu) - * [Navigation mode](#navigation-mode) - * [Events](#events-3) + + [Context Menu](#context-menu) + + [Navigation mode](#navigation-mode) +- [Breadcrumb Component](#breadcrumb-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) +- [Dropdown Site Component](#dropdown-site-component) + * [Basic Usage](#basic-usage-2) + + [Events](#events-2) - [Advanced usage and customization](#advanced-usage-and-customization) * [Custom tooltips](#custom-tooltips) * [Custom row filter](#custom-row-filter) @@ -58,33 +54,23 @@ + [Examples](#examples) * [Custom 'empty folder' template](#custom-empty-folder-template) * [Customizing default actions](#customizing-default-actions) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [See also](#see-also) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Document List component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +Displays the documents from a repository. -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## See also - -- [Walkthrough: adding indicators to clearly highlight information about a node](docs/metadata-indicators.md) - -## Install - -```sh -npm install ng2-alfresco-documentlist -``` - -## Document List +### Basic Usage ```html ``` -### Properties +#### Properties The properties currentFolderId, folderNode and node are the entry initialization properties of the document list. They cannot be used together, choose the one that suites more your use case. @@ -124,20 +110,24 @@ The properties currentFolderId, folderNode and node are the entry initialization | sorting | string[] | | Defines default sorting. The format is an array of 2 strings `[key, direction]` i.e. `['name', 'desc']` or `['name', 'asc']`. Set this value only if you want to override default sorting detected by the component based on columns. | | locationFormat | string | '/' | The default route for all the location-based columns (if declared). | -### Events +#### Events | Name | Description | | --- | --- | -| `nodeClick` | Emitted when user clicks the node | -| `nodeDblClick` | Emitted when user double-clicks the node | -| `folderChange` | Emitted upon display folder changed | -| `preview` | Emitted when document preview is requested either with single or double click | +| nodeClick | emitted when user clicks a list node | +| nodeDblClick | emitted when user double-clicks list node | +| folderChange | emitted once current display folder has changed | +| preview | emitted when user acts upon files with either single or double click (depends on `navigation-mode`), recommended for Viewer components integration | +| permissionError | emitted when user is attempting to create a folder via action menu without having the permission to do it | +| ready | emitted when the documentList is ready and loads all the elements| -_For a complete example source code please refer to +### Details + +For a complete example source code, refer to the [DocumentList Demo](https://github.com/Alfresco/alfresco-ng2-components/tree/master/ng2-components/ng2-alfresco-documentlist/demo) -repository._ +repository. -### DOM Events +#### DOM Events Below are the DOM events the DocumentList component emits. All of them are `bubbling`, meaning you can handle them in any component up the parent hierarchy, even if DocumentList is wrapped by another component(s). @@ -160,13 +150,11 @@ Every event is represented by a [CustomEvent](https://developer.mozilla.org/en/d Please refer to the DataTable documentation to find details about additional DOM events the DocumentList component bubbles up from the DataTable. -### Handling DOM events - -Here's a basic example on handling DOM events in the parent elements: +Below is a basic example of handling DOM events in the parent elements. ```html
+(node-dblclick)="onNodeDblClicked($event)">
@@ -177,15 +165,15 @@ Here's a basic example on handling DOM events in the parent elements:
``` -### Data Sources +#### Data Sources For the Document List data sources you can use one of the following options: -#### Node ID +##### Node ID The unique identifier of the Node. Gets automatically updated when you perform navigation to other folders. -#### Repository aliases +##### Repository aliases You can use one of the well-known reserved aliases: @@ -193,7 +181,7 @@ You can use one of the well-known reserved aliases: - `-shared-` - `-my-` -#### DocumentList aliases +##### DocumentList aliases The DocumentList component also provides support for the following reserved aliases you can use: @@ -222,7 +210,7 @@ The default column layout for non-reserved views is: - Modified (date) - Modified by -### Trashcan +__Trashcan__ ```html - -``` - -***Note:*** the `` and `` are the same component you can still use the old tag name - -![Breadcrumb](docs/assets/breadcrumb.png) - -### Properties - -| Name | Type | Description | -| --- | --- | --- | -| target | DocumentListComponent | (optional) DocumentList component to operate with. Upon clicks will instruct the given component to update. | -| folderNode | [MinimalNodeEntryEntity](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-core-rest-api/docs/NodeMinimalEntry.md) | Active node, builds UI based on `folderNode.path.elements` collection. | -| root | String | (optional) Name of the root element of the breadcrumb. You can use this property to rename "Company Home" to "Personal Files" for example. | - -### Events - -| Name | Returned Type | Description | -| --- | --- | --- | -| navigate | [PathElementEntity](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-core-rest-api/docs/PathElementEntity.md) | emitted when user clicks on a breadcrumb | - -## Dropdown Site Component - -DocumentList now provides a simple dropdown component to show and interact with the sites of the current user. - -```html - - -``` -![Dropdown sites](docs/assets/document-list-dropdown-list.png) - -### Events - -| Name | Returned Type | Description | -| --- | --- | --- | -| change | [SiteModel](https://github.com/Alfresco/alfresco-ng2-components/blob/development/ng2-components/ng2-alfresco-documentlist/src/models/site.model.ts) | emitted when user selects a site. When default option is selected an empty model is emitted | - -## Custom columns +#### Custom columns It is possible to reorder, extend or completely redefine data columns displayed by the component. By default special `$thumbnail` and `displayName` columns are rendered. @@ -576,7 +518,7 @@ You can also use HTML-based schema declaration used by DataTable, TaskList and o ``` -### DataColumn Properties +#### DataColumn Properties Here's the list of available properties you can define for a Data Column definition. @@ -592,7 +534,7 @@ Here's the list of available properties you can define for a Data Column definit | class | string | | Additional CSS class to be applied to column (header and cells) | | formatTooltip | Function | | Custom tooltip formatter function. | -### Column Types +#### Column Types The DataColumn `type` property can take one of the following values: @@ -602,7 +544,7 @@ The DataColumn `type` property can take one of the following values: - fileSize - location -### Underlying node object +#### Underlying node object DocumentList component assigns an instance of `MinimalNode` type (`alfresco-js-api`) as a data context of each row. @@ -647,7 +589,7 @@ Here's a short example: ``` -### Date Column +#### Date Column For `date` column type the [DatePipe](https://angular.io/docs/ts/latest/api/common/DatePipe-class.html) formatting is used. For a full list of available `format` values please refer to [DatePipe](https://angular.io/docs/ts/latest/api/common/DatePipe-class.html) documentation. @@ -655,7 +597,7 @@ For a full list of available `format` values please refer to [DatePipe](https:// ADF also supports additional `timeAgo` value for the `format` property. That triggers the date values to be rendered using popular ["Time from now"](https://momentjs.com/docs/#/displaying/fromnow/) format. -### Location Column +#### Location Column This column is used to display a clickable location link pointing to the parent path of the node. @@ -695,7 +637,7 @@ All links rendered in the column above will have an address mapped to `/files`: ... ``` -### Column Template +#### Column Template It is possible to provide custom column/cell template that may contain other Angular components or HTML elements: @@ -770,7 +712,7 @@ In the Example below we will add the [ng2-alfresco-tag](https://www.npmjs.com/pa ![Tag component in document List](docs/assets/document-list-tag-template.png) -### Actions +#### Actions Properties: @@ -982,7 +924,7 @@ Shows the destination chooser dialog for copy and move actions. By default the d ``` -###### Error, Permission and success callback +##### Error, Permission and success callback Defining error, permission and success callbacks are pretty much the same as doing it for the delete permission handling. @@ -1044,7 +986,7 @@ export class MyView { ![Folder Actions](docs/assets/folder-actions.png) -### Context Menu +#### Context Menu DocumentList also provides integration for 'Context Menu Service' from the [ng2-alfresco-core](https://www.npmjs.com/package/ng2-alfresco-core) library. @@ -1070,7 +1012,7 @@ export class MyView { This enables context menu items for documents and folders. -### Navigation mode +#### Navigation mode By default DocumentList component uses 'double-click' mode for navigation. That means user will see the contents of the folder by double-clicking its name @@ -1090,18 +1032,56 @@ The following example switches navigation to single clicks: ``` -### Events +## Breadcrumb Component -DocumentList emits the following events: +Indicates the current position within a navigation hierarchy. -| Name | Description | -| --- | --- | -| nodeClick | emitted when user clicks a list node | -| nodeDblClick | emitted when user double-clicks list node | -| folderChange | emitted once current display folder has changed | -| preview | emitted when user acts upon files with either single or double click (depends on `navigation-mode`), recommended for Viewer components integration | -| permissionError | emitted when user is attempting to create a folder via action menu without having the permission to do it | -| ready | emitted when the documentList is ready and loads all the elements| +![Breadcrumb](docs/assets/breadcrumb.png) + +### Basic Usage + +```html + + +``` + +***Note:*** the `` and `` are the same component - you can still use the old tag name. + +#### Properties + +| Name | Type | Description | +| --- | --- | --- | +| target | DocumentListComponent | (optional) DocumentList component to operate with. Upon clicks will instruct the given component to update. | +| folderNode | [MinimalNodeEntryEntity](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-core-rest-api/docs/NodeMinimalEntry.md) | Active node, builds UI based on `folderNode.path.elements` collection. | +| root | String | (optional) Name of the root element of the breadcrumb. You can use this property to rename "Company Home" to "Personal Files" for example. | + +#### Events + +| Name | Returned Type | Description | +| --- | --- | --- | +| navigate | [PathElementEntity](https://github.com/Alfresco/alfresco-js-api/blob/master/src/alfresco-core-rest-api/docs/PathElementEntity.md) | emitted when user clicks on a breadcrumb | + +## Dropdown Site Component + +Displays a dropdown menu to show and interact with the sites of the current user. + +![Dropdown sites](docs/assets/document-list-dropdown-list.png) + +### Basic Usage + +```html + + +``` + +#### Events + +| Name | Returned Type | Description | +| --- | --- | --- | +| change | [SiteModel](https://github.com/Alfresco/alfresco-ng2-components/blob/development/ng2-components/ng2-alfresco-documentlist/src/models/site.model.ts) | emitted when user selects a site. When default option is selected an empty model is emitted | ## Advanced usage and customization @@ -1456,7 +1436,25 @@ export class MyView { Typically you may want populating all your custom actions at the application root level or by means of custom application service. -## Build from sources +## See also + +- [Walkthrough: adding indicators to clearly highlight information about a node](docs/metadata-indicators.md) + +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-documentlist + +### Build from sources You can build component from sources with the following commands: @@ -1468,7 +1466,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -1477,7 +1475,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -1487,6 +1485,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-login/README.md b/ng2-components/ng2-alfresco-login/README.md index a03852dc64..bf16091d02 100644 --- a/ng2-components/ng2-alfresco-login/README.md +++ b/ng2-components/ng2-alfresco-login/README.md @@ -1,47 +1,39 @@ -# Login Component +# Login library + +Contains the Login component. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) -- [Properties](#properties) -- [Events](#events) -- [Change footer content](#change-footer-content) -- [Change header content](#change-header-content) -- [Extra content](#extra-content) -- [Custom logo and background](#custom-logo-and-background) -- [Customize Validation rules](#customize-validation-rules) -- [Controlling form submit execution behaviour](#controlling-form-submit-execution-behaviour) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Login component](#login-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) + + [Change footer content](#change-footer-content) + + [Change header content](#change-header-content) + + [Extra content](#extra-content) + + [Custom logo and background](#custom-logo-and-background) + + [Customize Validation rules](#customize-validation-rules) + + [Controlling form submit execution behaviour](#controlling-form-submit-execution-behaviour) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Login component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +Authenticates to Alfresco Content Services and Alfresco Process Services. -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -See it live: [Login Quickstart](http://embed.plnkr.co/PfZytJyHcl3xIsa8pdMo/) - -## Install - -```sh -npm install ng2-alfresco-login -``` - -## Basic usage - -This component allows to authenticate to Alfresco Content Services and Alfresco Process Services. +### Basic usage **app.component.html** @@ -68,7 +60,7 @@ export class AppComponent { } ``` -## Properties +#### Properties | Name | Type | Default Value | Description | | --- | --- | --- | --- | @@ -83,7 +75,7 @@ export class AppComponent { | showRememberMe | boolean | false | Toggle `Remember me` checkbox visibility | | showLoginActions | boolean | false | Toggle extra actions visibility (`Need Help`, `Register`, etc.) | -## Events +#### Events | Name | Description | | --- | --- | @@ -91,7 +83,9 @@ export class AppComponent { | onError | Raised when the login fails | | executeSubmit | Raised when the form is submitted | -## Change footer content +### Details + +#### Change footer content @@ -103,7 +97,7 @@ You can replace the entire content in the footer of the login component with you ` ``` -## Change header content +#### Change header content @@ -115,7 +109,7 @@ You can replace the entire content in the header of the login component with you ` ``` -## Extra content +#### Extra content You can put additional html content between `alfresco-login` tags to get it rendered as part of the login dialog. This becomes handy in case you need to extend it with custom input fields handled by your application or parent component: @@ -132,7 +126,7 @@ Here's an example of custom content: -## Custom logo and background +#### Custom logo and background It is possible changing logo and background images to custom values. @@ -156,7 +150,7 @@ Alternatively you can bind to your component properties and provide values dynam ``` -## Customize Validation rules +#### Customize Validation rules If needed it is possible to customise the validation rules of the login form. You can add/modify the default rules of the login form. @@ -194,7 +188,7 @@ export class MyCustomLogin { } ``` -## Controlling form submit execution behaviour +#### Controlling form submit execution behaviour If absolutely needed it is possible taking full control over form submit execution by means of `executeSubmit` event. @@ -236,7 +230,24 @@ export class MyCustomLogin { **Please note that if `event.preventDefault()` is not called then default behaviour will also be executed after your custom code.** -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +See it live: [Login Quickstart](http://embed.plnkr.co/PfZytJyHcl3xIsa8pdMo/) + +### Install + +```sh +npm install ng2-alfresco-login +``` + +### Build from sources You can build component from sources with the following commands: @@ -248,7 +259,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -257,7 +268,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -267,6 +278,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-search/README.md b/ng2-components/ng2-alfresco-search/README.md index 3070403dd4..77df2b6c11 100644 --- a/ng2-components/ng2-alfresco-search/README.md +++ b/ng2-components/ng2-alfresco-search/README.md @@ -1,40 +1,36 @@ -# Search Component +# Search library + +Contains the Search and Search Results components. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) -- [Properties](#properties) -- [Events](#events) -- [Basic usage Search results](#basic-usage-search-results) - * [Properties](#properties-1) - * [Events](#events-1) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Search component](#search-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) +- [Search Results component](#search-results-component) + * [Basic usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) + * [Details](#details-1) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Search component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-search -``` - -## Basic usage +### Basic usage ```html ``` -Example of a component that uses the search control. In this example the search term is simply logged to the console -but instead the component could emit an event to be consumed upstream, or it could trigger a change inside a search -results component embedded inside the same component. - -## Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -65,7 +57,7 @@ results component embedded inside the same component. | liveSearchMaxResults | number | 5 | Maximum number of results to show in the live search. | | liveSearchResultSort | string | | Criteria to sort live search results by, must be one of "name" , "modifiedAt" or "createdAt" | -## Events +#### Events | Name | Description | | --- | --- | @@ -74,7 +66,25 @@ results component embedded inside the same component. | fileSelect | Emitted when a file item from the list of find-as-you-type results is selected | | expand | Emitted when the expanded state of the control changes based on focus events and the content of the input control | -## Basic usage Search results +### Details + +```html + + +``` + +Example of a component that uses the search control. In this example the search term is simply logged to the console +but instead the component could emit an event to be consumed upstream, or it could trigger a change inside a search +results component embedded inside the same component. + +## Search Results component + +### Basic usage ```html ``` -Example of a component that displays search results, using the Angular2 router to supply a 'q' parameter containing the -search term. If no router is present on the page or if the router does not provide such parameter then an empty -results page will be shown. - -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -98,7 +104,7 @@ results page will be shown. | navigationMode | string | "dblclick" | Event used to initiate a navigation action to a specific result, one of "click" or "dblclick" | | navigate | boolean | true | Allow documentlist to navigate or not. For more information see documentlist component's documentation | -### Events +#### Events | Name | Description | | --- | --- | @@ -106,7 +112,34 @@ results page will be shown. | nodeDbClick | Emitted when user acts upon files or folders with double click **only when `navigation-mode` is set to false**, giving more freedom then just simply previewing the file | | resultsLoad | Emitted when search results have fully loaded | -## Build from sources +### Details + +```html + + +``` + +Example of a component that displays search results, using the Angular2 router to supply a 'q' parameter containing the +search term. If no router is present on the page or if the router does not provide such parameter then an empty +results page will be shown. + +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration, see this [page](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-search +``` + +### Build from sources You can build component from sources with the following commands: @@ -118,7 +151,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -127,7 +160,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -137,6 +170,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-social/README.md b/ng2-components/ng2-alfresco-social/README.md index 1ea0e855b6..52ca2d68df 100644 --- a/ng2-components/ng2-alfresco-social/README.md +++ b/ng2-components/ng2-alfresco-social/README.md @@ -1,68 +1,58 @@ -# Alfresco Social Component +# Alfresco Social library + +Contains the ADF Like and ADF Rating components. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) -- [adf-like](#adf-like) - * [Properties](#properties) - * [Events](#events) -- [adf-rating](#adf-rating) - * [Properties](#properties-1) - * [Events](#events-1) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [ADF Like component](#adf-like-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) +- [ADF Rating component](#adf-rating-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## ADF Like component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +![Custom columns](docs/assets/social1.png) -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-social -``` - -## Basic usage - -In this component there are two different components: - -* adf-like -* adf-rating - -## adf-like +### Basic Usage ```html ``` -### Properties +#### Properties | Attribute | Type | Default | Description | | --- | --- | --- | --- | | nodeId | string | | The identifier of a node.| -### Events +#### Events | Name | Description | | --- | --- | | changeVote | Raised when vote gets changed | -![Custom columns](docs/assets/social1.png) +## ADF Rating component -## adf-rating +![Custom columns](docs/assets/social2.png) + +### Basic Usage ```html ``` -### Properties +#### Properties | Attribute | Type | Default | Description | | --- | --- | --- | --- | | nodeId | string | | The identifier of a node | -### Events +#### Events | Name | Description | | --- | --- | | changeVote | Raised when vote gets changed | -![Custom columns](docs/assets/social2.png) +## Project Information -## Build from sources +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-social +``` + +### Build from sources You can build component from sources with the following commands: @@ -96,7 +99,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -105,7 +108,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -115,6 +118,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-tag/README.md b/ng2-components/ng2-alfresco-tag/README.md index 6a7a12e3b0..c5227a5de0 100644 --- a/ng2-components/ng2-alfresco-tag/README.md +++ b/ng2-components/ng2-alfresco-tag/README.md @@ -1,48 +1,35 @@ # Alfresco Tag Component +Contains the Alfresco Tag Node Actions list, Tag List and Node List components. + -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) -- [alfresco-tag-node-actions-list](#alfresco-tag-node-actions-list) - * [Properties](#properties) -- [alfresco-tag-node-list](#alfresco-tag-node-list) - * [Properties](#properties-1) -- [alfresco-tag-list](#alfresco-tag-list) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Alfresco Tag Node Actions List component](#alfresco-tag-node-actions-list-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) +- [Alfresco Tag Node List component](#alfresco-tag-node-list-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) +- [Alfresco Tag List component](#alfresco-tag-list-component) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Alfresco Tag Node Actions List component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +![Custom columns](docs/assets/tag3.png) -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-tag -``` - -## Basic usage - -In this component there are three different tags: - -* alfresco-tag-node-actions-list -* alfresco-tag-list -* alfresco-tag-node-list - -## alfresco-tag-node-actions-list +### Basic Usage ```html ``` -### Properties +#### Properties | Attribute | Type | Default | Description | | --- | --- | --- | --- | | nodeId | string | | The identifier of a node | -![Custom columns](docs/assets/tag3.png) +## Alfresco Tag Node List component -## alfresco-tag-node-list +### Basic Usage ```html ``` -### Properties +#### Properties | Attribute | Type | Default | Description | | --- | --- | --- | --- | @@ -74,11 +61,26 @@ In this component there are three different tags: ![Custom columns](docs/assets/tag1.png) -## alfresco-tag-list +## Alfresco Tag List component ![Custom columns](docs/assets/tag2.png) - -## Build from sources + +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-tag +``` + +### Build from sources You can build component from sources with the following commands: @@ -90,7 +92,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -99,7 +101,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -109,6 +111,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-upload/README.md b/ng2-components/ng2-alfresco-upload/README.md index 0034a6283c..09f4f444c0 100644 --- a/ng2-components/ng2-alfresco-upload/README.md +++ b/ng2-components/ng2-alfresco-upload/README.md @@ -1,69 +1,46 @@ -# Alfresco Upload Component +# Alfresco Upload library + +Contains components for handling uploads to Content Services. -- [Content](#content) - * [Components](#components) - * [Services](#services) - * [Directives](#directives) -- [Prerequisites](#prerequisites) -- [Install](#install) -- [UploadButtonComponent](#uploadbuttoncomponent) - * [Properties](#properties) - * [Events](#events) - * [Advanced usage](#advanced-usage) +- [Upload Button Component](#upload-button-component) + * [Basic Usage](#basic-usage) + + [Properties](#properties) + + [Events](#events) + * [Details](#details) + [How to show notification message with no permission](#how-to-show-notification-message-with-no-permission) + [How to disable the button when the delete permission is missing](#how-to-disable-the-button-when-the-delete-permission-is-missing) -- [UploadDragAreaComponent](#uploaddragareacomponent) - * [Properties](#properties-1) - * [Events](#events-1) -- [FileUploadingDialogComponent](#fileuploadingdialogcomponent) - * [Properties](#properties-2) -- [UploadService](#uploadservice) - * [Ignore list configuration](#ignore-list-configuration) - * [Events](#events-2) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Upload Drag Area Component](#upload-drag-area-component) + * [Basic Usage](#basic-usage-1) + + [Properties](#properties-1) + + [Events](#events-1) +- [File Uploading Dialog Component](#file-uploading-dialog-component) + * [Basic Usage](#basic-usage-2) + + [Properties](#properties-2) + * [Details](#details-1) +- [Upload Service](#upload-service) + * [Basic Usage](#basic-usage-3) + + [Events](#events-2) + * [Details](#details-2) + + [Ignore list configuration](#ignore-list-configuration) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Content +## Upload Button Component -### Components - -- [FileUploadingDialogComponent](#fileuploadingdialogcomponent) -- FileUploadingListComponent -- [UploadButtonComponent](#uploadbuttoncomponent) -- [UploadDragAreaComponent](#uploaddragareacomponent) - -### Services - -- [UploadService](#uploadservice) - -### Directives - -- FileDraggableDirective - -## Prerequisites - -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-upload -``` - -## UploadButtonComponent +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -87,21 +64,20 @@ npm install ng2-alfresco-upload | multipleFiles | boolean | false | Allow/disallow multiple files | | acceptedFilesType | string | * | array of allowed file extensions , example: ".jpg,.gif,.png,.svg" | | **(deprecated)** currentFolderPath | string | '/Sites/swsdp/documentLibrary' | define the path where the files are uploaded. **Deprecated in 1.6.0: use rootFolderId instead.** | -| **(deprecated)** rootFolderId | string | '-root-' | The ID of the root folder node. -**Deprecated in 1.6.2: use parentId instead.** | +| **(deprecated)** rootFolderId | string | '-root-' | The ID of the root folder node. **Deprecated in 1.6.2: use parentId instead.** | | parentId | string | empty | The ID of the root. It can be the nodeId if you are using the upload for the Content Service or taskId/processId for the Process Service. | | versioning | boolean | false | Versioning false is the default uploader behaviour and it renames the file using an integer suffix if there is a name clash. Versioning true to indicate that a major version should be created | | staticTitle | string | (predefined) | define the text of the upload button | | **(deprecated)** disableWithNoPermission ***use node permission directive from core instead*** | boolean | false | If the value is true and the user doesn't have the permission to delete the node the button will be disabled | | tooltip | string | | Custom tooltip | -### Events +#### Events | Name | Description | | --- | --- | | onSuccess | Raised when the file is uploaded | -### Advanced usage +### Details #### How to show notification message with no permission @@ -144,9 +120,11 @@ The UploadButtonComponent provides the property disableWithNoPermission that can ![Upload disable button](docs/assets/upload-disable-button.png) -## UploadDragAreaComponent +## Upload Drag Area Component -This component provides a drag and drop area to upload files to Alfresco. +Adds a drag and drop area to upload files to Alfresco. + +### Basic Usage ```html @@ -167,7 +145,7 @@ export class AppComponent { } ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -178,32 +156,55 @@ export class AppComponent { | **(deprecated)** currentFolderPath | string | '/' | define the path where the files are uploaded. **Deprecated in 1.6.0: use rootFolderId instead.** | | versioning | boolean | false | Versioning false is the default uploader behaviour and it renames the file using an integer suffix if there is a name clash. Versioning true to indicate that a major version should be created | -### Events +#### Events | Name | Description | | --- | --- | | onSuccess | Raised when the file is uploaded | -## FileUploadingDialogComponent +## File Uploading Dialog Component -This component provides a dialog that shows all the files uploaded with upload button or drag & drop area components. -This component should be used in combination with upload button or drag & drop area. +Shows a dialog listing all the files uploaded with the Upload Button or Drag Area components. + +### Basic Usage ```html ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | | position | string | 'right' | Dialog position. Accepted values are 'left' or 'right' | -## UploadService +### Details + +This component should be used in combination with upload button or drag & drop area. + +## Upload Service Provides access to various APIs related to file upload features. -### Ignore list configuration +### Basic Usage + +#### Events + +| Name | Type | Description | +| --- | --- | --- | +| queueChanged | FileModel[] | Raised every time the file queue changes. | +| fileUpload | FileUploadEvent | Raised every time a File model changes its state. | +| fileUploadStarting | FileUploadEvent | Raised when upload starts. | +| fileUploadCancelled | FileUploadEvent | Raised when upload gets cancelled by user. | +| fileUploadProgress | FileUploadEvent | Raised during file upload process and contains the current progress for the particular File model. | +| fileUploadAborted | FileUploadEvent | Raised when file upload gets aborted by the server. | +| fileUploadError | FileUploadEvent | Raised when an error occurs to file upload. | +| fileUploadComplete | FileUploadCompleteEvent | Raised when file upload is complete. | +| fileUploadDelete | FileUploadDeleteEvent | Raised when uploaded file is removed from server. | + +### Details + +#### Ignore list configuration Is possible add an ignore list for files that you don't want to allow upload on your CS. The configuration of this service is saved in the ***app.config.json file***.If you want more details about the configuration service follow this [link](https://github.com/Alfresco/alfresco-ng2-components/tree/master/ng2-components/ng2-alfresco-core#appconfigservice). @@ -228,21 +229,22 @@ Note: - Standard glob patterns work. - You can end patterns with a forward slash / to specify a directory. -### Events +## Project Information -| Name | Type | Description | -| --- | --- | --- | -| queueChanged | FileModel[] | Raised every time the file queue changes. | -| fileUpload | FileUploadEvent | Raised every time a File model changes its state. | -| fileUploadStarting | FileUploadEvent | Raised when upload starts. | -| fileUploadCancelled | FileUploadEvent | Raised when upload gets cancelled by user. | -| fileUploadProgress | FileUploadEvent | Raised during file upload process and contains the current progress for the particular File model. | -| fileUploadAborted | FileUploadEvent | Raised when file upload gets aborted by the server. | -| fileUploadError | FileUploadEvent | Raised when an error occurs to file upload. | -| fileUploadComplete | FileUploadCompleteEvent | Raised when file upload is complete. | -| fileUploadDelete | FileUploadDeleteEvent | Raised when uploaded file is removed from server. | +### Prerequisites -## Build from sources +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-upload +``` + +### Build from sources You can build component from sources with the following commands: @@ -254,7 +256,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -263,7 +265,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -273,6 +275,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-userinfo/README.md b/ng2-components/ng2-alfresco-userinfo/README.md index 21d3c9c42b..66288c22f2 100644 --- a/ng2-components/ng2-alfresco-userinfo/README.md +++ b/ng2-components/ng2-alfresco-userinfo/README.md @@ -1,42 +1,36 @@ -# Alfresco User Info Component +# Alfresco User Info library + +Contains the Alfresco User Info component. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) - * [Properties](#properties) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Alfresco User Info component](#alfresco-user-info-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + * [Details](#details) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Alfresco User Info component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-userinfo -``` - -## Basic usage +### Basic usage ```html ``` -### Properties +#### Properties | Name | Type | Default | Description | | --- | --- | --- | --- | @@ -46,10 +40,27 @@ npm install ng2-alfresco-userinfo | menuPositionY | string | | Custom choice for opening the menu bottom : `above` or `below` | | fallBackThumbnailImage | string | (alfresco image) | Fallback image for profile when thumbnail is missing| +### Details + This will show a round icon with user and on click some user information. If user is logged in with ECM and BPM the ECM image will be shown. -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-userinfo +``` + +### Build from sources You can build component from sources with the following commands: @@ -61,7 +72,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -70,7 +81,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -80,6 +91,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-viewer/README.md b/ng2-components/ng2-alfresco-viewer/README.md index 40ba246616..4243c22bab 100644 --- a/ng2-components/ng2-alfresco-viewer/README.md +++ b/ng2-components/ng2-alfresco-viewer/README.md @@ -1,42 +1,85 @@ -# Alfresco File Viewer Component +# Alfresco File Viewer library + +Contains the Alfresco Viewer component. -- [Prerequisites](#prerequisites) -- [Install](#install) - * [Configuring PDF.js library](#configuring-pdfjs-library) -- [Basic usage](#basic-usage) -- [Properties](#properties) -- [Supported file formats](#supported-file-formats) -- [PDF Conversion](#pdf-conversion) -- [Custom extension handler](#custom-extension-handler) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Alfresco Viewer component](#alfresco-viewer-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + * [Details](#details) + + [Supported file formats](#supported-file-formats) + + [PDF Conversion](#pdf-conversion) + + [Configuring PDF.js library](#configuring-pdfjs-library) + + [Custom extension handler](#custom-extension-handler) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) +## Alfresco Viewer component + See it live: [Viewer Quickstart](https://embed.plnkr.co/iTuG1lFIXfsP95l6bDW6/) -## Prerequisites +### Basic usage -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). +Using with node id: -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-viewer +```html + + ``` -### Configuring PDF.js library +Using with file url: + +```html + + +``` + +#### Properties + +| Attribute | Options | Default | Description | +| --- | --- | --- | --- | +| fileNodeId | string | | Node Id of the file to load | +| urlFile | string | | If you want to load an external file that does not come from ECM you can use this Url where to load the file | +| urlBlob | Blob | | If you want to load a Blob File | +| overlayMode | boolean | false | If `true` show the Viewer full page over the present content otherwise will fit the parent div | +| showViewer | boolean | true | Hide or show the viewer | +| showToolbar | boolean | true | Hide or show the toolbars | +| displayName | string | | You can specify the name of the file | + +### Details + +#### Supported file formats + +| Type | Extension | +| --- | --- | +| Media | wav, Mp3, Mp4, WebM, Ogv | +| Images | png, jpg, jpeg, gif, bmp | +| Text | pdf, txt | + +#### PDF Conversion + +![Rendition](docs/assets/renditions.png) + +Note for unsupported extensions the viewer will offer the possibility to convert to PDF if that kind of extension is supported by the [content service renditions service](https://community.alfresco.com/docs/DOC-5879-rendition-service) + +#### Configuring PDF.js library In order to configure your webpack-enabled application with the PDF.js library please follow the next steps. @@ -73,54 +116,7 @@ new CopyWebpackPlugin([ The Viewer component now should be able displaying PDF files. -## Basic usage - -Using with node id: - -```html - - -``` - -Using with file url: - -```html - - -``` - -## Properties - -| Attribute | Options | Default | Description | -| --- | --- | --- | --- | -| fileNodeId | string | | Node Id of the file to load | -| urlFile | string | | If you want to load an external file that does not come from ECM you can use this Url where to load the file | -| urlBlob | Blob | | If you want to load a Blob File | -| overlayMode | boolean | false | If `true` show the Viewer full page over the present content otherwise will fit the parent div | -| showViewer | boolean | true | Hide or show the viewer | -| showToolbar | boolean | true | Hide or show the toolbars | -| displayName | string | | You can specify the name of the file | - -## Supported file formats - -| Type | Extension | -| --- | --- | -| Media | wav, Mp3, Mp4, WebM, Ogv | -| Images | png, jpg, jpeg, gif, bmp | -| Text | pdf, txt | - -## PDF Conversion - -![Rendition](docs/assets/renditions.png) - -Note for unsupported extensions the viewer will offer the possibility to convert to PDF if that kind of extension is supported by the [content service renditions service](https://community.alfresco.com/docs/DOC-5879-rendition-service) - -## Custom extension handler +#### Custom extension handler If you want to handle other file formats that are not yet supported by the ng2-alfresco-viewer you can define your own custom handler. @@ -172,7 +168,22 @@ It is possible to define multiple `extension-viewer` templates: ``` -## Build from sources +## Project Information + +### Prerequisites + +Before you start using this development framework, make sure you have installed all required software and done all the +necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). + +> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-viewer +``` + +### Build from sources You can build component from sources with the following commands: @@ -184,7 +195,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -193,7 +204,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -203,6 +214,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE) diff --git a/ng2-components/ng2-alfresco-webscript/README.md b/ng2-components/ng2-alfresco-webscript/README.md index d543b7bfb3..9f2a2d7dee 100644 --- a/ng2-components/ng2-alfresco-webscript/README.md +++ b/ng2-components/ng2-alfresco-webscript/README.md @@ -1,39 +1,33 @@ -# Alfresco Webscript Component +# Alfresco Webscript library + +Contains the Alfresco Webscript Get component. -- [Prerequisites](#prerequisites) -- [Install](#install) -- [Basic usage](#basic-usage) -- [Properties](#properties) -- [Webscript View HTML example](#webscript-view-html-example) -- [Webscript View DATATABLE example](#webscript-view-datatable-example) -- [Webscript View JSON example](#webscript-view-json-example) -- [Build from sources](#build-from-sources) -- [NPM scripts](#npm-scripts) -- [Demo](#demo) -- [License](#license) +- [Alfresco Webscript Get component](#alfresco-webscript-get-component) + * [Basic usage](#basic-usage) + + [Properties](#properties) + * [Details](#details) + + [Webscript View HTML example](#webscript-view-html-example) + + [Webscript View DATATABLE example](#webscript-view-datatable-example) + + [Webscript View JSON example](#webscript-view-json-example) +- [Project Information](#project-information) + * [Prerequisites](#prerequisites) + * [Install](#install) + * [Build from sources](#build-from-sources) + * [NPM scripts](#npm-scripts) + * [Demo](#demo) + * [License](#license) -## Prerequisites +## Alfresco Webscript Get component -Before you start using this development framework, make sure you have installed all required software and done all the -necessary configuration [prerequisites](https://github.com/Alfresco/alfresco-ng2-components/blob/master/PREREQUISITES.md). - -> If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) - -## Install - -```sh -npm install ng2-alfresco-webscript -``` - -## Basic usage +### Basic usage ```html If you plan using this component with projects generated by Angular CLI, please refer to the following article: [Using ADF with Angular CLI](https://github.com/Alfresco/alfresco-ng2-components/wiki/Angular-CLI) + +### Install + +```sh +npm install ng2-alfresco-webscript +``` + +### Build from sources You can build component from sources with the following commands: @@ -202,7 +213,7 @@ npm run build > The `build` task rebuilds all the code, runs tslint, license checks > and other quality check tools before performing unit testing. -## NPM scripts +### NPM scripts | Command | Description | | --- | --- | @@ -211,7 +222,7 @@ npm run build | npm run test-browser | Run unit tests in the browser | npm run coverage | Run unit tests and display code coverage report | -## Demo +### Demo Please check the demo folder for a demo project @@ -221,6 +232,6 @@ npm install npm start ``` -## License +### License [Apache Version 2.0](https://github.com/Alfresco/alfresco-ng2-components/blob/master/LICENSE)