Spry User Guide - Support - Adobe

Get data
After the XML data is loaded, it is flattened into a tabular format. Inside the data set, the data is actually stored as an
array of objects (rows) with properties (columns) and values.
The following example shows data selected with the /gallery/photos/photo XPath, in bold:
John Doe
john@doe.com
The data set then flattens the set of nodes into a tabular format, that the following table represents.
@path @width @height
sun.jpg 16 16
tree.jpg 16 16
surf.jpg 16 16
YoucangetalloftherowsinthedatasetbycallinggetData().Thedataisloadedasynchronously,soyoucanonly
access the data after it is loaded. You might need to register an observer to be notified when the data is ready. For
more information, see “Work with observer notifications” on page 126.
❖ Use the getData() method to fetch all the rows in the data set. To get the value of a specific column, index into
the row with the column name.
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
...
var rows = dsPhotos.getData(); // Get all rows.
var path = rows[0]["@path"]; // Get the data in the "@path" column of the first row.
Sort data
❖ To sort the rows of a data set using the values in a given column, call the sort() method on the data set:
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
...
dsPhotos.sort("@path"); // Sort the rows of the data set using the "@path" column.
Calling the sort() method of a data set sorts the rows in ascending order, using data in the specified column.
SPRY
User Guide
The sort() method takes two arguments. The first argument can be the name of the column, or an array of column
names to use when sorting. If the first argument is an array, the first element of the array serves as the primary sort
column; each column after that is used for secondary and tertiary sorting, and so on. The second argument is the
sort order to use, and must be one of the following strings: "ascending", "descending", or "toggle". If the
second argument is not specified, the sort order defaults to "ascending". Specifying "toggle" as the sort order causes
the data sorted in "ascending" ordertobesortedin"descending" order, and the reverse. If the column was never
sorted before, and the sort order used is "toggle", the data is initially sorted in "ascending" order.
123