footable

FooTable
========

FooTable is a jQuery plugin that aims to make HTML tables on smaller devices look awesome - No matter how many columns of data you may have in them.

Home Page |
WordPress Plugin (free) |
Demos

!FooTable

Features
--------

* Hide certain columns at different sizes
* Configuration via data attributes
* Built to work with Bootstrap
* Easy to theme
* Sorting
* Filtering
* Pagination
* Easy to extend with add-ons

What Is FooTable?
-----------------

FooTable is a jQuery plugin that transforms your HTML tables into expandable responsive tables. This is how it works:

1. It hides certain columns of data at different resolutions (we call these breakpoints).
2. Rows become expandable to reveal any hidden data.

So simple! Any hidden data can always be seen just by clicking the row.

Demos
-----

Check out the growing number of FooTable demos (with built-in documentation!)

Documentation
-------------

The docs are built into the demos! On every demo page, there is a docs tab that outlines how to use the specific feature.

Data Attribute Configuration
----------------------------

One of the main goals of FooTable was to make it completely configurable via data attributes. We wanted you to be able to look at the HTML markup and see exactly how the FooTable was going to function. Take a look at this markup for example:

``html












`

All available data attributes are listed in the data attributes demo

Breakpoints
-----------

FooTable works with the concepts of "breakpoints", which are different table widths we care about. The default breakpoints are:

`javascript
breakpoints: {
phone: 480,
tablet: 1024
}
`

So looking at the markup in the Data Attribute Configuration section, you can now tell that the Job Title, DOB and Status columns will be hidden when the table width is below 480 (phone).

There are also two built-in breakpoints called "default" and "all".

The "default" breakpoint is the fallback breakpoint for when the current table width is larger than any defined breakpoint. Looking at the above JS snippet the "default" breakpoint would be applied once the table width is larger than 1024 (tablet).

The "all" breakpoint is pretty straight forward in it's use. You can always hide a column on any table width by applying the data-hide="all" attribute to the header.

Usage
-----

Create a simple table (don't forget to set the data attributes for each column in your thead!):

`html


First Name	Last Name	Job Title	DOB	Status




























Name	Phone	Email
Bob Builder	555-12345	bob@home.com
Bridget Jones	544-776655	bjones@mysite.com
Tom Cruise	555-99911	cruise1@crazy.com


`

1. Include FooTable Core CSS

`html

`

2. [optional] Include FooTable Theme CSS

> FooTable is now built to work with Twitter Bootstrap out of the box - WOOT!

You can use one of our built-in themes if you want:

`html

`

Check out the metro theme demo or the original theme demo.

3. Include jQuery

`html

`

4. Include FooTable jQuery Plugin

`html

`

5. Initialize FooTable!

`html

``

Extensible
----------

Another goal of FooTable was to make it easily extensible. If you look at the code you will see that there is a plugin framework within the plugin, so extra mods can be attached just by including another javascript file.

We also didn't want to bloat FooTable, so you can only use what you need and leave out everything else.

Working add-ons:

* sorting
* filtering
* pagination (thanks @awc737)
* striping (thanks @OliverRC)

Other add-on ideas so far are:

* conditional formatting
* json loading
* column picker

Thanks
------

We would not have created FooTable without inspiration from others. Thanks must be given to:

* Catalin for his original table CSS
* @awc737 for creating the pagination add-on
* @OliverRC for creating the striping add-on
* Chris Coyier (also check out Chris' responsive table roundup post)
* Zurb
* Dave Bushell
* Filament Group
* Stewart Curry
* @akf and Lucid Meetings for creating the bookmarkable add-on