Skip to content

iron-data-table is a Web Component for displaying data as a table or grid. Built on top of iron-list using Polymer.

License

Notifications You must be signed in to change notification settings

Saulis/iron-data-table

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bower version Build Status Gitter

<iron-data-table>

Demos and API Documentation

Project currently inactive, maintainers needed

For a similar table component, I recommend using <vaadin-grid> 2.0

To install, run: bower install iron-data-table

iron-data-table displays a table or a grid of data. It builds on top of iron-list, which provides the foundation for features like virtual scrolling and templating.

It contains an array of data-table-column elements, which are used to define a template for the cells on each row item.

Rows use flex layout which enables cells to fit the available space.

Cell elements are placed outside the shadow root of the iron-data-table which allows them to be styled by the user.

Template model

Column templates should bind to template models of the following structure:

{
  index: 0,        // index in the item array
  selected: false, // true if the current item is selected
  item: {}         // user data corresponding to items[index],
  expanded: false  // true if row details have been expanded for the current item
}

For example, given the following data array:

data.json
[
  {"name": {
    "title": "miss",
    "first": "donna",
    "last": "davis"
  }},
  {"name": {
    "title": "mr",
    "first": "samuel",
    "last": "kelley"
  }},
  {"name": {
    "title": "ms",
    "first": "katie",
    "last": "butler"
  }}
]

The following code would render the table (note the name and checked properties are bound from the model object provided to the template scope):

<template is="dom-bind">
  <iron-ajax url="data.json" last-response="{{data}}" auto></iron-ajax>
  <iron-data-table items="[[data]]">
    <data-table-column name="First Name">
      <template>[[item.name.first]]</template>
    </data-table-column>
    <data-table-column name="Last Name">
      <template>[[item.name.last]]</template>
    </data-table-column>
  </iron-data-table>
</template>

Features (1.0)

  • Virtual, 'infinite' scrolling provided by <iron-list>
  • Lazy Loading
  • Data filtering
  • Data sorting
  • Multi-Column sorting (thanks to @userquin)
  • Item selection
  • Multi-Selection
  • Template support for each column
  • Two-way binding support
  • Custom styling support for templates
  • Flex support for Cells
  • Native Shadow DOM support
  • Column manipulation, resizing, hiding, reordering
  • Custom Header templates
  • Basic Angular 2 support with directives
  • Row Details (thanks to @gazal-k)

Roadmap

  • <iron-data-table> is not actively maintained. For a similar table component, I recommend using <vaadin-grid> 2.0

Contributing

I'd appreciate any help and feedback on the component. If you have any ideas, opinions, nitpicks or anything at all about it, please don't hesitate to send an issue, PR or a message in the Gitter chat.

Currently, I would be very interested in hearing comments especially about the styling mixins and the horizontal scrolling!

About

iron-data-table is a Web Component for displaying data as a table or grid. Built on top of iron-list using Polymer.

Resources

License

Stars

Watchers

Forks

Packages

No packages published