Difference between revisions of "CarouselView Options"
Yvonne.milne (Talk | contribs) (→Lianja 7.2 Enhancements) |
Yvonne.milne (Talk | contribs) (→Notes on Client Support) |
||
(One intermediate revision by the same user not shown) | |||
Line 256: | Line 256: | ||
[[Category:Sections]] | [[Category:Sections]] | ||
[[Category:Lianja v5.0]] | [[Category:Lianja v5.0]] | ||
− | [[Category:Lianja | + | [[Category:Lianja v8.0]] |
+ | [[Category:WebView Based Sections]] |
Latest revision as of 10:10, 12 April 2024
Contents
See Also
CarouselView Section Attributes, PanelView Options
Overview
CarouselView Sections are ideal as Welcome pages. The images can be selected by clicking on the left or right control arrows or by using the indicator dots at the bottom of the image. They can also be set to automatically cycle through at a specified interval. |
A CarouselView Section displays images along with their captions and sub captions.
It can also optionally have a menu.
The next and previous arrows (Controls) and the selection dots (Indicators) move through the images.
Menu
The Menu attribute is a | separated list of menuitems to be embedded at the top of the CarouselView section.
The menu may contain submenus. Sub menuitems are comma separated and in parentheses. The first menuitem cannot have sub menuitems.
Clicking on the [...] button pops up an editor. Just enter each menuitem (and its sub menuitems if required) on a line of its own and the | separators will be added for you.
Note: for single level menus, the menuitems can be comma-separated or | separated.
The Custom section menu Custom delegate is called when a menuitem or sub menuitem is selected.
Images
Add the images files to be used in the CarouselView Section to the App by dragging them into the Apps Workspace.
The Images attribute is a comma separated list of image file names specifying the images to be displayed.
Clicking on the [...] button pops up an editor. Just enter each file name on a line of its own and the comma separators will be added for you.
Captions
The Captions attribute is a comma separated list of captions to be displayed on the images.
Clicking on the [...] button pops up an editor. Just enter each caption on a line of its own and the comma separators will be added for you.
The Sub captions attribute is a comma separated list of captions to be displayed on the images.
Clicking on the [...] button pops up an editor. Just enter each sub caption on a line of its own and the comma separators will be added for you.
Show controls
The Show controls attribute determines whether the controls (next and previous arrows) are displayed.
Show indicators
The Show indicators attribute determines whether the indicators (selection dots) are displayed.
Cycle interval
The controls and the indicators are shown by default and are used to move through the images.
The Cycle interval attribute can be set to a non-zero value to cause the images to cycle automatically.
Here the Cycle interval has been set to 5, so the next image will be selected every 5 seconds.
Lianja 5.0 Enhancements
From Lianja v5.0, CarouselView Sections can be data bound and display the images from a blob column and the text from the associated 'caption' and 'subcaption' character columns.
The controls and indicators are used to navigate between records.
The CarouselView Section can be used as the 'child' section to a related 'parent' table. Note that the relation is set using the Keyfield and Keyfield expression.
The CarouselView Section records can also be filtered and sorted.
Full CRUD operations are supported in Desktop, Web and Mobile.
Database
The name of the database for the data bound table.
southwind
Table
The name of the data bound table.
images
Editable
Whether the images can be added and deleted by the end-user (True | False).
Order by
An optional order by expression to sort the data.
Filter
An optional filter expression to restrict the included records.
Image column
The name of the blob column containing the image files.
image
Caption column
The name of the character column for the image caption.
caption
The name of the character column for the image subcaption.
subcaption
Keyfield
The name of the column into which the Keyfield expression will be inserted when an image is added.
cust_id
This column is also used in conjunction with the Keyfield expression to restrict the included records for a related table: where keyfield = keyfield expression.
If a Filter is specified, this is prefixed to the where clause: where filter and keyfield = keyfield expression.
Keyfield expression
The expression that will be inserted into the Keyfield when an image is added. Use {expr} to insert dynamic values.
{cust.cust_id}
This column is also used in conjunction with the Keyfield to restrict the included records for a related table: where keyfield = keyfield expression.
If a Filter is specified, this is prefixed to the where clause: where filter and keyfield = keyfield expression.
Display images as photos
Whether the images should be shown as photos (True | False). This displays the images centralized and with a border. It is especially suitable for phone Apps or where the CarouselView controls and indicators should be displayed outside the image.
Display images as photos = False (default):
Display images as photos = True:
Lianja 8.0 Enhancements
From Lianja v8.0 the 'Lianja Carousel Demo' (example_carousel) App is included in the Lianja App Builder distribution to demonstrate CarouselView functionality.
The 'Custom Web Component Parameters Editor' can now be used to set the CarouselView Attributes:
Notes on Client Support
Attribute | Notes |
---|---|
Database | - |
Table | - |
Editable | - |
Menu | - |
Images | - |
Captions | - |
Sub captions | - |
Show controls | - |
Show indicators | - |
Cycle interval | - |
Order by | - |
Filter | - |
Image column | - |
Caption column | - |
Subcaption column | - |
Keyfield | - |
Keyfield expression | - |