Skip to content

elements.basic-table 0.34.0

Install from the command line:
Learn more about npm packages
$ npm install @tradeshift/elements.basic-table@0.34.0
Install via package.json:
"@tradeshift/elements.basic-table": "0.34.0"

About this version

Elements - basic-table

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
dir dir String ltr Direction of the component 'rtl' or 'ltr'
cols cols Array []
List of columns configs, including:
- property: Property key of the column in data object,
- value: value of the title of column',
- visibility?: Which screen sizes this column should be visible -> 'always-visible'(default) or 'desktop-only' or 'mobile-only',
- size?: 'small' or 'medium' or 'large',
- display?: 'left' or 'right' or 'center',
- renderer?: you can pass a renderer function to customize the content of the cells in this column, args: (cellValue, rowObject)
selectedIds selectedIds Array [] List of selected rows ids (caveat: the row should include id property)
data data Array [] List of rows data objects

➤ Events

Name Description Payload
row-click Emitted on table row click { row }

➤ How to use it

  • Install the package of basicTable
$ npm i @tradeshift/elements.basic-table --save
  • Import the component
import '@tradeshift/elements.basic-table';

or

<script src="node_modules/@tradeshift/elements.basic-table/lib/basic-table.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.basic-table-0.34.0-npm.tgz

Download activity

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