Picture
The Picture
ViewTemplate allows embedding and displaying an image that is dynamically loaded from an EntityField. It is typically used to visualize media stored in the system, such as company logos, user profile pictures, or product images.
Overview
This ViewTemplate is configured to render a single image. The image source is defined by an EntityField
containing image data, typically stored as a Base64-encoded string. Optionally, an action can be triggered when the user clicks on the image.
Configuration
Required Properties
Property | Description |
---|---|
pictureField | Specifies the EntityField from which the image is loaded. The field must contain image data (e.g., Base64-encoded PNG or JPEG). |
pictureClickAction | Optional. Defines an Action that is triggered when the image is clicked by the user. This could open a larger version of the image, start a download, or navigate to another view. |
Example Use Case
A company logo stored in an entity field (COMPANY_LOGO
) is displayed in the header section of the company view. When the logo is clicked, a full-size version of the image is shown using a predefined action.
Usage Considerations
The image field must contain valid image data. Supported formats depend on the client rendering engine but generally include .png
, .jpg
, and .gif
.
If the image is large, consider using a scaled-down version in the pictureField
and linking the full-resolution image through the click Action.
Ensure that the Action specified in pictureClickAction
is appropriate for the context. Avoid defining actions that interrupt user workflows or perform irreversible operations on image click.