Reorderer API - v0.4
This documentation refers to the v0.4 released version of the Reorderer code. For documentation specific to the trunk version, please see Reorderer API.
Reorderer Overview
The Reorderer will handle almost any arbitrary stream of markup you pass to it, assuming a very simple contract is maintained:
- The orderable elements are contained within some kind of container element.
- A selector for the container is passed to the Reorderer upon instantiation.
- A selector for the orderable elements themselves is also supplied.
Optional:
- Provide a callback function. This will be called by the Reorderer each time the user reorders an element, and is generally used to communicate ordering changes back to the server.
- Specify configuration options to customize the behaviour of the Reorderer. These are documented below.
Join the fluid-talk mailing list and ask your questions there.
Creating a Reorderer
Lists
fluid.reorderList(containerSelector, itemSelector, orderChangedCallback, options);
Allows reordering of elements in a vertical or horizontal list. More information is available at Simple List Reorderer API - v0.4.
Grids
fluid.reorderGrid(containerSelector, itemSelector, orderChangedCallback, options);
Allows reordering of a grid of items. More information is available at Simple Grid Reorderer API - v0.4.
Layouts
fluid.reorderLayout(containerSelector, layoutSelectors, orderChangedCallback, options);
Allows reordering of portlets, content blocks, or other chunks of layout. More information is available at Simple Layout Reorderer API - v0.4.
Advanced use of the Reorderer
For cases where more control over the configuration of the Reorderer instance is needed, a Reorderer can be constructed directly, and configured for your specific needs:
Reorderer(container, findMovables, layoutHandler[, options]);
Reorderer(container, findItems, layoutHandler[, options]);
For more information about these constructor functions, see Advanced Reorderer API - v0.4.