Table(rows, caption, keys, maxColWidth, maxRowHeight)

Table constructor

Tables can be created in serveral ways, expecting an Array of objects as their first argument, and an array of columns as their next argument, OR a Table ORDER constant. See the section following the API guide for more information.

The following example creates a table with the current library items:

var table = new Table($library.items);
table.render();

+-------------------+------------+----------------+-------------------+------------------+-------------+-----------------+------------+-----------+--------------------+--------------------+--------------------+---------------------------+-------------------+------------------+------------------+------------+
| timeline          | symbolType | sourceFilePath | sourceLibraryName | sourceAutoUpdate | scalingGrid | scalingGridRect | itemType   | name      | linkageExportForAS | linkageExportForRS | linkageImportForRS | linkageExportInFirstFrame | linkageIdentifier | linkageClassName | linkageBaseClass | linkageURL |
+-------------------+------------+----------------+-------------------+------------------+-------------+-----------------+------------+-----------+--------------------+--------------------+--------------------+---------------------------+-------------------+------------------+------------------+------------+
|                   |            |                |                   |                  |             |                 | folder     | Folder    |                    |                    |                    |                           |                   |                  |                  |            |
| [object Timeline] | button     |                |                   |                  | false       | [object Object] | button     | Button    | false              | false              | false              |                           |                   |                  |                  |            |
| [object Timeline] | graphic    |                |                   |                  | false       | [object Object] | graphic    | Graphic   | false              | false              | false              |                           |                   |                  |                  |            |
| [object Timeline] | movie clip |                |                   |                  | false       | [object Object] | movie clip | MovieClip | false              | false              | false              |                           |                   |                  |                  |            |
+-------------------+------------+----------------+-------------------+------------------+-------------+-----------------+------------+-----------+--------------------+--------------------+--------------------+---------------------------+-------------------+------------------+------------------+------------+

It is also possible to pass in a non-Array object, such as a single library item, and when Table detects this, it automatically displays Property and Value columns. Passing in true as the keys parameter will also output a third Type column.

The following example prints a table of the properties and values of a single Library Item:

var table = new Table($library.items[0]);
table.render();		

+---------------------------+----------------------+
| Property                  | Value                |
+---------------------------+----------------------+
| timeline                  | [object Timeline]    |
| symbolType                | movie clip           |
| sourceFilePath            |                      |
| sourceLibraryName         |                      |

You may also add a caption to the table in the second parameter, which can be useful when reporting or debugging.

The following example displays a short caption about the

var clip = $selection[0];
var table = new Table(clip, $timeline.name + ' > ' + clip.name);
table.render();

+-------------------------------------------+
| Scene 1 > Symbol_02                       |
+---------------------+---------------------+
| Property            | Value               |
+---------------------+---------------------+
| instanceType        | symbol              |
| symbolType          | movie clip          |
| effectSymbol        | false               |
| libraryItem         | [object SymbolItem] |

The last two parameters in the constructor allow you to specify maximum column widths, and row heights, which is useful if you have a lot of data in your table and want to show more or less. The default maximum column width is 100, and the maximum row height is 2.

print(rows, caption, keys, maxColWidth, maxRowHeight)

Static table method to print a table

Table.print() is a one-line shortcut to instantiating and rendering a table, and is the easiest way to output a table in development or when when debugging:

Table.print($library.items);

render(output)

Renders the data in the class as an ASCII table

This example skips rendeing the table to the Output panel, and instead saves it to a file:

var table   = new Table($library.items);
var text    = table.render(false);

if(save('/temp/items.txt', text))
{
	alert('Items saved!');
}