This FAQ is intended to provide answers to some of the questions asked about the FilteringTable widget, written by Tom Trenka.

It is maintained by Rachel Willmer from the answers provided by Tom on the dojo-interest mailing list (and a few things I've worked out for myself...)

1. Where can I see a FilteringTable widget in action?
2. What does it do?
3. Can I use it with an existing HTML table?
4. Can I use it with data acquired from a remote site?
5. Can I use it with a dynamically-created HTML table?
6. Can I colourise the cells?
7. What DataTypes can I use in a column?
   

1. Where can I see a FilteringTable widget in action?

Follow this link for the nightly test page.

2. What does it do?
   • Sort columns by clicking on the header
   • Multiple column sorting
   • Add filters to data to dynamically hide/show rows
   • Use existing HTML table or JSON data
3. Can I use it with an existing HTML table?

Yes. Just add dojoType="filteringTable" to the table definition. For example,

<script type="text/javascript">
dojo.require("dojo.widget.FilteringTable");
</script>
<table dojotype="filteringTable" ...>


You might also want to define the stylesheet settings, or set other FilteringTable parameters here, but they're not necessary.


Look at the documented source of the nightly test for more information.

4. Can I use it with data acquired from a remote site?

Yes. See the source of the nightly test for how to use JSON data to directly populate the data store.

5. Can I use it with a dynamically-created HTML table?

Yes. See how to do it here.

http://archive.dojotoolkit.org/nightly/tests/widget/test_FilteringTable_programmatic.html

Also, I've put a complete example where both column definitions and data are pulled from a remote server here

http://www.willmer.com/kb/2006/12/programmatic-usage-of-filteringtable/

6. Can I colourise the cells?
7. What DataTypes can I use in a column?