/iron-data-table

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

Primary LanguageHTMLApache License 2.0Apache-2.0

Bower version Build Status Gitter

<iron-data-table>

Demos and API Documentation

For Angular 2 support, see angular2-iron-data-table

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 (1.1)

In random order: (please let me know if something is missing or misplaced)

  • Frozen Columns
  • Drag and Drop Column Resizing
  • Drag and Drop Column Reordering

Roadmap (1.x)

In random order: (please let me know if something is missing or misplaced)

  • Nested Row Grouping (Tree)
  • Row Grouping
  • Custom Footer templates

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!