@unicef-polymer/etools-file

<etools-file>

This element will allow you to select and prepare the files you are gonna upload. The component doesn't upload the files, it just manages an array of them, which is reachable from the parent component.

Usage

Examples

<etools-file files="{{files}}" label="Single file selection" accept=".jpg"></etools-file>

<etools-file files="{{files}}" label="Single file selection" readonly></etools-file>

<etools-file files="{{multipleFiles}}" multiple></etools-file>

<etools-file files="{{multipleFiles}}" multiple readonly></etools-file>

<etools-file files="{{files}}"
  label="Attachement (validation error shown)"
  invalid="[[invalid]]"
  error-message="Error message that will show only is invalid=true">
</etools-file>

Properties:

• accept, String - files types to accept for selection
• disabled, Boolean, default: false
• files, Array, default: [] – notifies
• label, String, default: 'File attachment'
• multiple, Boolean, default: false
• readonly, Boolean, default: false
• uploadLabel, String, default: 'Upload File'
• invalid, Boolean, default: false
• errorMessage, String, default: ''
• noFileAttachedMsg, String, default: 'No file attached'
• fileModel, Object, default null, file object model
• useDeleteEvents Boolean, default false
• activateFileTypes, Boolean, default false
• fileTypes, Array, default []
• fileTypesLabel, String, default 'File Type'
• showUploadDate, Boolean, default false
• showUploadBtnAbove, Boolean, default false

Styling

You can use defined variables to change main colors.

Custom property	Description	Default
--etools-file-secondary-text-color	Secondary text color	rgba(255, 255, 255, 0.54)
--etools-file-main-btn-color	Main buttons text color(upload and download buttons)	#00acff
--etools-file-delete-btn-color	Delete button text color	#f1572a
--etools-file-single-file-wrapper	Mixin applied to single file name wrapper	{}
--etools-file-filename-container	Mixin applied to the filename container	{}
--etools-file-readonly-filename-container	Mixin applied to the filename container(only if it's readonly)	{}
--etools-file-actions-multiple	Mixin applied to file action buttons container if multiple is true	{}
--etools-file-actions-single	Mixin applied to file action buttons container for single file selection	{}
--etools-file-error	Mixin applied to the error message element	{}
--etools-file-type-underline-color	File type underline color	rgba(0, 0, 0, 0.12)
--etools-file-area-with-type-border-color	File area with type underline color	rgba(0, 0, 0, 0.12)
--etools-file-label	File type underline color	rgba(0, 0, 0, 0.12)
--etools-file-area-with-type	File area with type mixin	{}
--etools-file-upload-button-paper-btn	Upload btn paper-button mixin	{}
--etools-file-upload-button	Upload button mixin	{}

Install

$ npm install --save etools-file

Preview element locally

Install needed dependencies by running: $ npm install. Run polymer analyze -i ./etools-file.js > analysis.json to generate the file used by the Demo pages. Make sure you have the Polymer CLI installed. Then run $ polymer serve to serve your element application locally.

Linting the code

Innstall local npm packages (run npm install) Then just run the linting task

$ npm run lint

You should also use polylint. If you don't have Polylint installed run npm install -g polylint. Then just run the linter on each file you wish to check like so

$ polylint -i filename.html

At the moment polylint crashes if it encounters a missing import. If that happens, temporarily comment out such imports and run the command again.

Running Tests

You need to have web-component-tester installed (if not run npm install -g web-component-tester)

$ wtc

or

$ wtc -p