Skip to content

elements.file-card 0.35.0

Install from the command line:
Learn more about npm packages
$ npm install @tradeshift/elements.file-card@0.35.0
Install via package.json:
"@tradeshift/elements.file-card": "0.35.0"

About this version

Elements - file-card

Part of the reusable Tradeshift UI Components as Web Components. Demo

NPM Version Downloads per month

<style> table { width:100%; } </style>

➤ Properties

Property Attribute Type Default Description
state state String states.UPLOADING type/state of the file card: 'download', 'failed', 'uploading'
fileObject file-object Object File data object, {name, size, ...}
rtl rtl Boolean false
removable removable Boolean false Show a remove button on the card, which emit an event when it's been clicked
size size String sizes.FULL Size of the file card: 'full','medium','small'
errorMessage error-message String The error message to be shown on the file card when it's in failed state

➤ Slots

Name Description
remove-action-text To customize the remove action message
download-action-text To customize the download action message

➤ Events

Name Description Payload
remove Emitted when user clicks the remove action { file }

➤ How to use it

  • Install the package of fileCard
$ npm i @tradeshift/elements.file-card --save
  • Import the component
import '@tradeshift/elements.file-card';

or

<script src="node_modules/@tradeshift/elements.file-card/lib/file-card.umd.js"></script>
  • Use it like demo

  • Our components rely on having the Open Sans available, You can see the font-weight and font-style you need to load here, or you can just load it from our package (for now)

<link rel="stylesheet" href="node_modules/@tradeshift/elements/src/fonts.css" />

➤ Polyfills

For supporting IE11 you need to add couple of things

  • Don't shim CSS Custom Properties in IE11
<!-- Place this in the <head>, before the Web Component polyfills are loaded -->
<script>
	if (!window.Promise) {
		window.ShadyCSS = { nativeCss: true };
	}
</script>
You have two options for polyfills library:
  1. Use @open-wc/polyfills-loader
  • Installation
$ npm i @open-wc/polyfills-loader
  • Load it
import loadPolyfills from '@open-wc/polyfills-loader';

loadPolyfills().then(() => import('./my-app.js'));
  1. Use @webcomponents/webcomponentsjs
  • Installation
$ npm i @webcomponents/webcomponentsjs --save
  • Enable ES5 class-less Custom Elements
<script src="/node_modules/@webcomponents/webcomponentsjs/custom-elements-es5-adapter.js"></script>
<script src="/node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js" defer></script>

➤ How to contribute

Thanks for your interest and help!

  • First thing you need to do is read this [Component Checklist] which contains lots of important information about what you need to consider when you are creating/changing components

You can find some links to useful materials about what we are using and some tutorials and articles that can help you get started.

You can see a list of limitations that we should watch out for, here

➤ License

  • You can always create forks on GitHub, submit Issues and Pull Requests.
  • You can only use Tradeshift Elements to make apps on a Tradeshift platform, e.g. tradeshift.com.
  • You can fix a bug until the bugfix is deployed by Tradeshift.
  • You can host Tradeshift Elements yourself.
  • If you want to make a bigger change or just want to talk with us, reach out to our team here on GitHub.

You can read the full license agreement in the LICENSE.md.

Details


Assets

  • elements.file-card-0.35.0-npm.tgz

Download activity

  • Total downloads 8
  • Last 30 days 0
  • Last week 0
  • Today 0