The Thumbnails Field is meant to display small sized images in the UI, it may display several images at a time when used with JMESPath.
Schema Details
| Property | Type | Description | Required | Default | Enum |
|---|---|---|---|---|---|
| type | string | The type of field. | No | thumbnails | thumbnails |
| label | string/null | Label to show for this field. | No | null | |
| css_style | object/null | Style to apply in the HTML of the UI. | No | null | |
| css_class | string/null | CSS class to apply in the HTML component. | No | null | |
| translate | string/null | Translation key for the field. | No | null | |
| translate_label | string/null | Translation key for the label. | No | null | |
| analytics | object/null | Analytics configuration. | No | null | |
| if_not_exist | string/null | Show only if the specified field doesn't exist. | No | null | |
| if_exist | string/null | Show only if the specified field does exist. | No | null | |
| only_on_highlight | boolean | Show only when the value is highlighted. | No | false | |
| display | any | Value from the field. | No | null | |
| field | string | Path to field from which to retrieve the value (in JMESPath format). | Yes | ||
| field_highlight | string/null | Path to highlight field from which to retrieve the value, in case it is not the same as the field parameter (in JMESPath format). | No | null | |
| default | any | Default value to use in case no value was found for the field. | No | null | |
| transform | array/string/null | List of transformations to apply to the displayed values. | No | null | |
| suffix | string/null | Suffix to append to the value or values. | No | null | |
| prefix | string/null | Prefix to append to the value or values. | No | null | |
| suffix_label | string/null | Suffix to append to the label of the field. | No | null | |
| prefix_label | string/null | Prefix to append to the label of the field. | No | null | |
| sort | string/boolean | Sort order for values in an array. | No | false | asc, desc |
| unique | boolean | If the values are in an array, remove the duplicates. | No | false | |
| show_blank | boolean | If there is no value, or value is null, and show_blank is true, keep the field. | No | false | |
| replacement | string/null | Replacement string for matches in the transformations Transformation.REPLACE_FIRST, Transformation.REPLACE_LAST, and Transformation.REPLACE_ALL. | No | null | |
| pattern | string/null | Pattern used to look for matches in the transformations Transformation.REPLACE_FIRST, Transformation.REPLACE_LAST, and Transformation.REPLACE_ALL. | No | null | |
| detail | string/null | Detail view of the image. | No | null | |
| full_size | string/null | Full-size image URL. | No | null | |
| alt | string/null | Alternative text for the image. | No | null | |
| missing_icon | string | Icon to display when the image is missing. | No | image_not_supported |
Example JSON Representation
{
"type": "thumbnails",
"label": "Product Images",
"css_style": null,
"css_class": null,
"translate": null,
"translate_label": null,
"analytics": null,
"if_not_exist": null,
"if_exist": null,
"only_on_highlight": false,
"display": null,
"field": "images",
"field_highlight": null,
"default": null,
"transform": null,
"suffix": null,
"prefix": null,
"suffix_label": null,
"prefix_label": null,
"sort": false,
"unique": false,
"show_blank": false,
"replacement": null,
"pattern": null,
"detail": null,
"full_size": null,
"alt": "Product image",
"missing_icon": "image_not_supported"
}
Code Example of Usage
thumbnails_field_example = ThumbnailsField(
field="images",
alt="Product image",
missing_icon="image_not_supported"
)
Overview
Content Tools