After discovering the ng2-alfresco-documentlist and the ng2-alfresco-viewer components, in this paragraph we are going to introduce the ng2-alfresco-upload displaying useful tools to upload files and folders into the repository. In this case we won’t see practical examples of customisations, but we would like to focus on a brief description to make their use more easier and understandable. Honestly, those components are not the hardest one to use (even if they offer a great support for the users) and the customisations can be developed exactly in the same way we saw in all the past examples.
Looking at the files component stored into the <my-adf>/app/components/files folder, let’s edit the files.component.html file and find the tags: alfresco-upload-drag-area, alfresco-upload-button and file-uploading-dialog. The first two components are used to control uploading of files (documents in Alfresco ECM) and folders. The third component, used in combination with the other two, is used to show the progress during the upload task.
The alfresco-upload-drag-area component is used to define an area in the screen, where the user can drag & drop the content to upload files and folders into Alfresco. As you can imagine, the area where the component acts is defined by the HTML source code contained into the alfresco-upload-drag-area tag. In this example in particular, the area is defined by the breadcrumb (represented by the alfresco-document-list-breadcrumb tag), the error messages, the Alfresco repository explorer (represented by the alfresco-document-list tag) and the pagination component (represented by the alfresco-pagination tag).
Differently from the alfresco-upload-drag-area component, the alfresco-upload-button is used to define a button on the screen, where the user can click and select the content to be upload directly into Alfresco.
As well described into the ng2-alfresco-upload documentation, the alfresco-upload-drag-area and the alfresco-upload-button componentscan be controlled using attributes, eventing and custom functions, in the same way it is described in the various examples of the current and past tutorials. What we would like to share here, is that both the components are strictly related to the file-uploading-dialog, showing the progress during the upload.
Below the picture showing how the file-uploading-dialog looks like, after a file upload using the alfresco-upload-drag-area component (in any case, using the alfresco-upload-button component would be exactly the same user experience).
The file-uploading-dialog component in the my-adf application.