Skip to content
JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode [modernize] Adds Contextual Component API (#541) Jun 2, 2018
addon-test-support [TESTS] footer page object extends body page object Jul 31, 2019
addon [FEAT] Enforce maximum height (by percentage) for sticky footers and … Aug 15, 2019
app ember-th renders only the block when one is passed. Apr 1, 2019
config [CHORE] Add 3.4, 3.8 LTS to ember-try Jul 16, 2019
tests [FEAT] Enforce maximum height (by percentage) for sticky footers and … Aug 15, 2019
vendor Initial Commit from Ember CLI v2.12.1 Jun 26, 2017
.bowerrc Initial Commit from Ember CLI v2.12.1 Jun 26, 2017
.editorconfig Initial Commit from Ember CLI v2.12.1 Jun 26, 2017
.ember-cli Initial Commit from Ember CLI v2.12.1 Jun 26, 2017
.eslintignore [upgrade] Ember 3.0 (#528) May 17, 2018
.eslintrc.js Upgrade several project dependencies (#658) Mar 13, 2019
.gitignore Add yarn.lock Mar 13, 2019
.npmignore [upgrade] Ember 3.0 (#528) May 17, 2018
.npmrc Add .yarnrc and .npmrc Mar 13, 2019
.prettierrc.js [restructure] New Table API (#517) Apr 26, 2018
.release-it.json Update readme and release-it config Jul 31, 2019
.sass-lint.yml Enable strict BEM class name format Jun 12, 2019
.travis.yml [TESTS] Allow ember-beta scenario to fail at CI (#755) Aug 15, 2019
.watchmanconfig
.yarnrc Add .yarnrc and .npmrc Mar 13, 2019
CHANGELOG.md Release 2.1.2 Aug 16, 2019
LICENSE.md [upgrade] Ember 3.0 (#528) May 17, 2018
README.md Update version badge in README Aug 15, 2019
ember-cli-build.js [DOCS] Unconditionally enable faker for dummy app Jul 16, 2019
index.js DOCS: Fix rendering of addon docs pages Jul 10, 2019
jsconfig.json CHORE: Change jsconfig settings so that tests are included Jul 10, 2019
package.json
testem.js [upgrade] Ember 3.0 (#528) May 17, 2018
yarn.lock [CHORE] use vertical-collection @ ^1.0.0-beta.14 (#756) Aug 16, 2019

README.md

Build Status GitHub release

Ember Table

An addon to support large data set and a number of features around table. Ember Table can handle over 100,000 rows without any rendering or performance issue. This version of Ember Table supports Ember 1.11 to latest version of Ember.

Install

ember install ember-table

Features

  • Column resizing, column reordering.
  • Table resizing.
  • Fixed first column.
  • Custom row and custom header.
  • Handles transient state at cell level.
  • Single, multiple row selection.
  • Table grouping.

Documentation

Documentation is available at: https://opensource.addepar.com/ember-table/docs

Ember Table uses ember-cli-addon-docs for its documentation. To run the docs locally, clone the repo, run yarn && yarn start and then navigate to http://localhost:4200/docs.

Usage.

To use Ember Table, you need to create columns and rows dataset.

columns is an array of objects which has multiple fields to define behavior of the column. The objects can be simple POJOs, and there are no hard requirements about their shape. They may have a valuePath, and if they do this path will be used to get the value from each row for that column. If you only want to use the default template, you can also specify a name on the column which will be rendered in the template.

columns: [
  {
    name: `Open time`,
    valuePath: `open`,
  },
  {
    name: `Close time`,
    valuePath: `close`,
  },
];

rows could be a javascript array, ember array or any data structure that implements length and objectAt(index). This flexibity gives application to avoid having all data at front but loads more data as user scrolls. Each object in the rows data structure should contains all fields defined by all valuePath in columns array.

rows: computed(function() {
  const rows = emberA();

  rows.pushObject({
      open: '8AM',
      close: '8PM'
    });

    rows.pushObject({
      open: '11AM',
      close: '9PM'
    });

    return rows;
  })

Template

The following template renders a simple table.

  {{#ember-table as |t|}}
    {{t.head columns=columns}}

    {{t.body rows=rows}}
  {{/ember-table}}

You can use the block form of the table to customize its template. The component structure matches that of actual HTML tables, and allows you to customize it at any level. At the cell level, you get access to these four values:

  • value - The value of the cell
  • cell - A unique cell cache. You can use this to track cell state without dirtying the underlying model.
  • column - The column itself.
  • row - The row itself.

You can use these values to customize cell in many ways. For instance, if you want to have every cell in a particular column use a component, you can add a component field to your column (or feel free to use any other property name you like):

  {{#ember-table as |t|}}
    {{t.head columns=columns}}

    {{#t.body rows=rows as |b|}}
      {{#b.row as |r|}}
        {{#r.cell as |value column row|}}
          {{component column.component value=value}}
        {{/r.cell}}
      {{/b.row}}
    {{/t.body}}
  {{/ember-table}}

The rendered table is a plain table without any styling. You can define styling for your own table. If you want to use default table style, import the ember-table/default SASS file.

Optional Footer

You can also use the ember-tfoot component, which has the same API as ember-tbody:

  {{#ember-table as |t|}}
    {{t.head columns=columns}}

    {{t.body rows=rows}}

    {{t.foot rows=footerRows}}
  {{/ember-table}}

Migrating from old Ember table

To support smooth migration from old version of Ember table (support only till ember 1.11), we have move the old source code to separate package ember-table-legacy. It's a separate package from this Ember table package and you can install it using yarn or npm. This allows you to have 2 versions of ember table in your code base and you can start your migrating one table at at time. The recommended migration steps are as follows (if you are using ember 1.11):

  1. Rename all your ember-table import to ember-table-legacy. (for example: import EmberTable from 'ember-table/components/ember-table' becomes import EmberTableLegacy from 'ember-table-legacy/components/ember-table-legacy'. Remove reference of ember-table in package.json.
  2. Install ember-table-legacy using yarn add ember-table-legacy or npm install ember-table-legacy
  3. Run your app to make sure that it works without issue.
  4. Reinstall the latest version of this ember-table repo.
  5. You can start using new version of Ember table from now or replacing the old ones.

Releasing new versions (for maintainers)

We use release-it. To create a new release, run yarn run release. To do a dry-run: yarn run release --dry-run. The tool will prompt you to select the new release version.

You can’t perform that action at this time.