Wiki source code of Live Table component
Version 30.1 by ElenaOanaTabaranu on 2009/09/14
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | 1 Live Table component | ||
| 2 | |||
| 3 | #warning("This section documents a feature that is only available starting with XWiki Enterprise 1.9M2.") | ||
| 4 | |||
| 5 | #toc("" "" "") | ||
| 6 | |||
| 7 | 1.1 Summary | ||
| 8 | |||
| 9 | The *"Live Table"* component is a dynamic table loading data lazily using ajax requests as the user browse the table, in order to scale easily the display of very large amounts of data. Users can browse the table thanks to a pagination system. Filters on columns are available to search for specific entries. Columns can be made sortable in both direction. The video below demonstrate the main capabilities of the live table component: | ||
| 10 | |||
| 11 | {pre} | ||
| 12 | <object width="640" height="401"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=4474332&server=vimeo.com&show_title=1&show_byline=0&show_portrait=0&color=ffffff&fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=4474332&server=vimeo.com&show_title=1&show_byline=0&show_portrait=0&color=ffffff&fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="640" height="401"></embed></object> | ||
| 13 | {/pre} | ||
| 14 | |||
| 15 | 1.1 How to use | ||
| 16 | |||
| 17 | The Live Table component is made available in several ways to [Applications>code:Applications.WebHome] developers and developers of the [XWiki platform and products>dev:Main.WebHome], depending on their specific needs. The simplest, and most of the times preferred, way to embed a Live Table component is to use the <tt>livetable</tt> velocity macro, available in all pages of your wiki. With only one call to this macro, you will be able to display a live table of the data of your choice! For more specific needs, in the cases you need more control on the table behavior, or to build another component on top of the live table, it is possible to instantiate the live table from JavaScript. In this case, you, as opposed to the velocity macro, you will need to construct the HTML elements the JavaScript component expects yourself, either from JavaScript, either writing the [HTML directly in your wiki page>platform:Main.XWikiSyntax] | ||
| 18 | |||
| 19 | 1.1.1 Using the Velocity <tt>livetable</tt> macro | ||
| 20 | |||
| 21 | Please refer [Live Table Macro>code:Macros.LiveTableMacro] reference. | ||
| 22 | |||
| 23 | 1.1.1 HTML + JavaScript | ||
| 24 | |||
| 25 | TODO | ||
| 26 | |||
| 27 | 1.1.1 Example | ||
| 28 | |||
| 29 | The Live Table component could be extended with a special column containing the ratings of some documents from the wiki. |
