Spry User Guide - Support - Adobe

var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
...
dsPhotos.sort("@path", "toggle"); // Toggle the Sort order of the rows of the data set using
the "@path" column.
To have the data in the data set sorted automatically whenever data is loaded, specify the column to sort by and the
sort order to use as an option to the data set constructor. Use the "sortOnLoad" option to the data set constructor
to specify a column to sort by. In the following example, the data set automatically sorts in descending order by using
the data in the @path column.
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo", { sortOnLoad: "@path", sortOrderOnLoad: "descending" });
By default, all values in the data set are treated as text. This can be problematic when sorting numeric or date values.
You can specify the data type for a given column by calling the setColumnType() method.
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
dsPhotos.setColumnType("@width", "number");
dsPhotos.setColumnType("@height", "number");
...
dsPhotos.sort("@width"); // Sort the rows of the data set using the "@width" column.
Current supported data types are "number", "date", and "string".
Set or change current row
Each data set maintains the notion of a current row.Bydefault,thecurrentrowissettothefirstrowinthedataset.
To change the current row programmatically, call the setCurrentRowNumber() method and pass the row number
of the row you want to make the current row. The index of the first row is always zero, so if a data set contains 10
rows, the index of the last row is 9.
❖ Use setCurrentRowByNumber() or setCurrentRow() to change the current row:
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
...
dsPhotos.setCurrentRowNumber(2); // Make the 3rd row in the data set the current row.
Each row in the data set is also assigned a unique ID that allows you to refer to a specific row in the data set even
after the order of the rows in the data set change. You can get the ID of a row by accessing its "ds_RowID" property.
You can also change the current row by calling setCurrentRow() and passing the row ID of the row to make the
current row.
var dsPhotos = new Spry.Data.XMLDataSet("/photos.php?galleryid=2000",
"/gallery/photos/photo");
...
var id = dsPhotos.getData()[2]["ds_RowID"]; // Get the ID of the 3rd row.
...
dsPhotos.setCurrentRow(id); // Make the 3rd row the current row by using its ID.
Remove duplicate rows
❖ Use the distinct() method to remove duplicate rows in a data set:
SPRY
User Guide
124