# bootstrap table

[![Build Status](https://travis-ci.org/wenzhixin/bootstrap-table.png)](https://travis-ci.org/wenzhixin/bootstrap-table)

Bootstrap table displays data in a tabular format and offers rich support to radio, checkbox, sort, pagination and so on. The table has been designed to reduce development time and to require no specific knowledge from developers. It is both featherweight and feature-rich.

* [Documentation](http://wenzhixin.net.cn/p/bootstrap-table/docs/documentation.html)
* [Examples](http://wenzhixin.net.cn/p/bootstrap-table/docs/examples.html)
* [JSFiddle Examples](docs/jsfiddle-examples.md)
* [Extensions](http://wenzhixin.net.cn/p/bootstrap-table/docs/extensions.html)
* [Resources](docs/resources.md)

## Latest release

1.3.0 (2014-10-16)

## LICENSE

**NOTE:** Bootstrap Table is licensed under the [The MIT License](https://github.com/wenzhixin/bootstrap-table/blob/master/LICENSE). Completely free, you can arbitrarily use and modify this plugin. If this plugin is useful to you, you can **Star** this repo, your support is my biggest motive force, thanks.

## Bugs & Enhancements (next version)

- [x] Fix #119, #123: Save all `id` and `class` of `tr` and `td` for html table.
- [x] Fix #149: Hide empty data on Card view.
- [x] Fix #131: Add `onPageChange` event.
- [x] Add `onSearch` event.
- [ ] Fix #144: `onCheck` and `onUncheck` method are reversed when using `clickToSelect` option. (jQuery 1.7.2 bug).
- [x] Apply `width` column option to row style.
- [x] Add bootstrap-table-filter extension.
- [x] Add cs-CZ, es-CR, es-NI, pl-PL, ur-PK and ko-KR locales.
- [x] Fix `minimumCountColumns` option init error.
- [x] Fix #161: `undefined` or `null` string sort bug.
- [x] Fix #171: IE disabled button can be clicked bug.
- [x] Fix #185: Reset the page to the first page when changing the url with `refresh` method.
- [x] Fix #202: updateRow method keep the scroll position.
- [x] Add `smartDisplay` option.
- [x] Add `searchAlign` and `toolbarAlign` options.
- [x] Fix #193: Add `dataType` option.
- [x] Add flatJSON and editable extensions.
- [ ] Update documentation.

## Features

* Created for Bootstrap 3 (Bootstrap 2 supported)
* Responsive web design
* Scrollable Table with fixed headers
* Fully configurable
* Via data attributes
* Show/Hide columns
* Show/Hide headers
* Get data in JSON format using AJAX
* Simple column sorting with a click
* Format column
* Single or multiple row selection
* Powerful pagination
* Card view
* Localization

## How to get it

### Manual download

Use [Releases page](https://github.com/wenzhixin/bootstrap-table/releases) or [the source](https://github.com/wenzhixin/bootstrap-table/archive/master.zip).

### Bower

```
bower install bootstrap-table
```

### CDN

You can source bootstrap-table directly from a CDN like [CDNJS](http://www.cdnjs.com/libraries/bootstrap-table) or [bootcss](http://open.bootcss.com/bootstrap-table/).

## Reporting issues

Please provide jsFiddle when creating issues!

It's really saves much time. Use this as template:

[jsFiddle Bootstrap Table](http://jsfiddle.net/8svjf80g/1/)

Your feedback is very appreciated!

## Acknowledgements

Thanks to everyone who have given feedback and submitted pull requests. A list of all the contributors can be found [here](https://github.com/wenzhixin/bootstrap-table/blob/master/CONTRIBUTORS.md).

## Release History

Look at the [Change Log](https://github.com/wenzhixin/bootstrap-table/blob/master/CHANGELOG.md)

## Local build

To build bootstrap-table locally please run:

```
grunt build
```

Result will appear in `dist` directory.