Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

 

 

Description

The gallery widget provides a way to display a collection of images as a grid of enlargeable thumbnails, with the thumbnail size depending on the number of images in the collection, ranging from a single large image (still enlargeable if it had to be shrunk to fit the widget) to nine small thumbnails in a 3x3 grid. It implements paging similar to that of the table widget, with a maximum of nine thumbnails per page.

 

 

Syntax

Example
<gallery title="my.gallery.heading" imageAttribute="image" descriptionAttribute="description">
    <collectionSource function="getObjectsWithImageBlobs"/>
    <binding variable="selectedObject"/>
</gallery>

In the above example, the "getObjectsWithImageBlobs" function needs to return a collection of custom DSL objects with an "image" attribute that is of the primitive type blob. The FileUpload widget can be used to upload images as blobs (if the image data aren't provided from an external source, as is often done). Similarly, the object attribute specified for the descriptionAttribute attribute must be of type string.

 

 

User Interaction

Single-clicking on an image thumbnail will highlight and bind the selected image's object to the specified binding variable. Double-clicking a thumbnail will open the full size image in a pop-up modal. Click anywhere on the screen to close the modal.

 

Captions that are too long for the allotted caption space underneath the thumbnails will but cut off and end with an ellipsis ("...") instead. Hovering your mouse over the caption for one second will make a tooltip with the full caption appear.

 

 

Paging

For large data sets the gallery widget provides a paging mechanism. When a view with a gallery is loaded the default behaviour will be to display at most nine image thumbnails per page. This can, however, be adjusted by selecting the page size in the middle of the gallery footer area.

The page size options available start at 9 rows and is incremented by 9 all the way to a maximum of 99 records per page. Note that if the total number of records from the collection source is less that 99 and not a multiple of 9, the total number of rows will also be shown as an option. Also note that the page size option will only be visible when the number of records from the collection source exceeds 9.

 

 

Additional Mentions And References

 

  • No labels