This project is a lightweight table/grid builder. It is meant to be easy configurable but also easy customisable (if you want to use it as a base for your own grid development). In The current version (0.1.0) the features are
- table markup: it is a table and follows the semantic of an HTML table.
- manage your layout: you can choose the number of columns and how the should be mapped to your data model
- format data: you can choose how the data are formatted within a given column:
- by giving your own format function
- using one of the built-in angular filters
- Sort data
- using your own algorithm
- using the 'orderBy' angular algorithm: in this case you'll be able to provide predicates as explained in orderBy filter documentation
- Filter data
- using a global search input box
- using the controller API to filter according to a particular column
- Select data row(s) according to different modes:
- single: one row selected at the time
- multiple: many row selected at the time. In this case you can also add a selection column with checkboxes
- Simple style: you can easily give class name to all the cells of a given column and to the header as well
- template cell:
- you can provide template for a given column header (it will be compiled so that you can attach directves to it)
- same for the data cells
- Edit cells: you can make cells editable and specify a type for the input so that validation rules, etc will be applied
- Client side pagination : you can choose the number of rows you want to display and use the angular-ui.bootstrap pagination directive to navigate.
- All the directives of the table use the table controller API. It means that you can easily change the templates and directives but still using the API to perform any operation
You'll find running examples and more documentation at the demo website
- You can clone the repository: the source code will be under smart-table-module directory.
- You can add the Smart-Table.min.js file to your application and then add the module 'smartTable.table' to your own app module. The build includes all the template in the $templateCache so you need only this file.
Follow the steps:
- clone this repository
- install node.js and run
scripts/web-server.js - you'll find a running example app at http://localhost:/example-app/index.html after you have started the web-server
Tests can be run with Testacular: you'll find the config file under config folder. Note, the coverage is done by Istanbul.js
Smart Table module is under MIT license:
Copyright (C) 2013 Laurent Renard.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
For more information on Smart Table, please contact the author at [email protected]