Simple table extension with sorting, filtering, paging... for Angular2 apps
TypeScript CSS JavaScript HTML
Latest commit 4da74de Dec 9, 2016 @joepurdy joepurdy committed with valorkin Relax Angular2 peer dependancies (#321)
This commit changes Angular2 peer dependancies to use a caret instead of
  tilde.

  This ensures as the Angular2 team releases new minor versions
  rapidly this package will not throw an exception for UNMET PEER
  DEPENDANCY
Permalink
Failed to load latest commit information.
.config feat(build): ng-tables updated to common: May 18, 2016
components feat(compiler-cli): use ngc to generate *.metadata.json (#308) Oct 6, 2016
demo fix(demo): demo page link to html fixed Oct 7, 2016
gulp-tasks feat(package): update dependency version, use @angular/forms, fix gul… Aug 4, 2016
.editorconfig New: created ng2-table component Sep 30, 2015
.eslintrc New: created ng2-table component Sep 30, 2015
.eslintrc.json feat(build): ng-tables updated to common: May 18, 2016
.gitignore feat(compiler-cli): use ngc to generate *.metadata.json (#308) Oct 6, 2016
.ng2-config.js feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
.npmignore feat(compiler-cli): use ngc to generate *.metadata.json (#308) Oct 6, 2016
.travis.yml Release 1.2.0 (#303) Oct 5, 2016
CHANGELOG.md 1.3.2 Oct 7, 2016
LICENSE feat(build): ng-tables updated to common: May 18, 2016
README.md feat(compiler-cli): use ngc to generate *.metadata.json (#308) Oct 6, 2016
gulpfile.js feat(build): ng-tables updated to common: May 18, 2016
karma.conf.js feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
ng2-table.ts feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
package.json Relax Angular2 peer dependancies (#321) Dec 9, 2016
protractor.conf.js feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
spec-bundle.js feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
tsconfig.json Release 1.2.0 (#303) Oct 5, 2016
tsconfig.publish.json feat(compiler-cli): use ngc to generate *.metadata.json (#308) Oct 6, 2016
tslint.json feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016
webpack.config.js feat(package): update to rc.5 and use ng2-webpack-config (#268) Sep 5, 2016

README.md

ng2-table npm version

Simple table extension with sorting, filtering, paging... for Angular2 apps

Follow me twitter to be notified about new releases.

Angular 2 Style Guide Build Status Code Climate Join the chat at https://gitter.im/valor-software/ng2-bootstrap Dependency Status devDependency Status Throughput Graph

Usage & Demo

http://valor-software.github.io/ng2-table/


Installation

  1. A recommended way to install ng2-table is through npm package manager using the following command:

    npm i ng2-table --save

    Alternatively, you can download it in a ZIP file.

  2. More information regarding using of ng2-table is located in demo and demo sources.

Documentation

Inputs (Properties)

  • page (number) - the default page after the table component loading
  • itemsPerPage (number) - number of the displaying items (rows) on a page
  • maxSize (number) - number of the displaying pages before ...
  • numPages (number) - total number of the pages
  • length (number) - total number of the items after filtering (of it's chosen)

  • config (?any) - config for setup all plugins (filtering, sorting, paging):

    • paging (?boolean) - - switch on the paging plugin
    • sorting (?any) - switch on the sorting plugin
      • columns (Array<any>) - only list of the columns for sorting
    • filtering (?any) - switch on the filtering plugin
      • filterString (string) - the default value for filter
      • columnName (string) - the property name in raw data
    • className (string|Array<string>) - additional CSS classes that should be added to a
    • rows (?Array<any>) - only list of the rows which should be displayed

    • columns (?Array<any>) - config for columns (+ sorting settings if it's needed)
      • title (string) - the title of column header
      • name (string) - the property name in data
      • sort (?string|boolean) - config for columns (+ sorting settings if it's needed), sorting is switched on by default for each column
      • className (string|Array<string>) - additional CSS classes that should be added to a column header
      • filtering (?any) - switch on the filtering plugin
        • filterString (string) - the default value for filter
        • columnName (string) - the property name in raw data
    • Outputs (Events)

      • tableChanged: data change event handler
      • cellClicked: onclick event handler

      Filter

      The responsibility of the filtering issue falls on user. You should choose on which columns the filter would be applied. You could add any number of different filters. Filter string - it's a string for matching values in raw data. Column name refers to the property name in raw data. The rest logic you could organize by yourself (the order of filters, data formats, etc). Even you could use filter for list of data columns.

      You can also set up filtering param for columns, in this case filter box will appear in first row of the table.

      Sorting

      Data sorting could be in 3 modes: asc, desc and without sorting data (as it comes from backend or somewhere else). If you want to switch off the sorting for some of the columns then you should set it forcibly in columns config (set property sort to false value for each column you want)

      Paging

      Pagination could be used from ng2-bootstrap - pagination component. When the page is changed, the pagination component will emit event change-table with an object {page, itemsPerPage}. Then you can easily subscribe on it and request corresponding raw data.

      Troubleshooting

      Please follow this guidelines when reporting bugs and feature requests:

      1. Use GitHub Issues board to report bugs and feature requests (not our email address)
      2. Please always write steps to reproduce the error. That way we can focus on fixing the bug, not scratching our heads trying to reproduce it.

      Thanks for understanding!

      License

      The MIT License (see the LICENSE file for the full text)