Image Picker Question Schema Properties
A question that presents image or video choices for selection.
Element type: imagepicker
Key properties: 19
Generation Hints
Section titled “Generation Hints”- Aliases: image choices, visual selector, picture picker.
- Use when: respondents choose one or more image-backed options.
- Recommended properties:
type,name,title,choices,multiSelect,imageFit.
{ "type": "imagepicker", "name": "layout", "title": "Choose a layout", "choices": [{ "value": "grid", "text": "Grid", "imageLink": "https://example.com/grid.png" }] }Key Properties
Section titled “Key Properties”choices
Section titled “choices”- Type:
imageitemvalue[] - Default:
[]
Gets or sets choice items. This property accepts an array of objects with the following structure:
choicesByUrl
Section titled “choicesByUrl”- Type:
restfull - Default:
—
Configures access to a RESTful service that returns choice items. Refer to the ChoicesRestful class description for more information. You can also specify additional application-wide settings using the settings.web object.
choicesFromQuestion
Section titled “choicesFromQuestion”- Type:
question_carryforward - Default:
—
Copies choice items from a specified question. Accepts a question name.
choicesFromQuestionMode
Section titled “choicesFromQuestionMode”- Type:
string - Default:
"all" - Allowed values:
all,selected,unselected
Specifies which choice items to copy from another question. Applies only when the choicesFromQuestion property is specified.
choicesVisibleIf
Section titled “choicesVisibleIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each choice item. If the expression evaluates to false, the choice item becomes hidden.
choicesEnableIf
Section titled “choicesEnableIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each choice item. If the expression evaluates to false, the choice item becomes read-only.
choicesOrder
Section titled “choicesOrder”- Type:
string - Default:
"none" - Allowed values:
none,asc,desc,random
Specifies the sort order of choice items.
contentMode
Section titled “contentMode”- Type:
string - Default:
"image" - Allowed values:
image,video
Specifies the type of content that choice items display.
multiSelect
Section titled “multiSelect”- Type:
boolean - Default:
—
Specifies whether users can select multiple images or videos.
imageFit
Section titled “imageFit”- Type:
string - Default:
"contain" - Allowed values:
none,contain,cover,fill
Specifies how to resize images or videos to fit them into their containers.
imageHeight
Section titled “imageHeight”- Type:
number - Default:
—
Specifies the height of containers for images or videos. Accepts positive numbers and CSS values.
imageWidth
Section titled “imageWidth”- Type:
number - Default:
—
Specifies the width of containers for images or videos. Accepts positive numbers and CSS values.
minImageHeight
Section titled “minImageHeight”- Type:
responsiveImageSize - Default:
133
Specifies a minimum height for image or video containers. Accepts positive numbers and CSS values.
maxImageHeight
Section titled “maxImageHeight”- Type:
responsiveImageSize - Default:
3000
Specifies a maximum height for image or video containers. Accepts positive numbers and CSS values.
minImageWidth
Section titled “minImageWidth”- Type:
responsiveImageSize - Default:
200
Specifies a minimum width for image or video containers. Accepts positive numbers and CSS values.
maxImageWidth
Section titled “maxImageWidth”- Type:
responsiveImageSize - Default:
3000
Specifies a maximum width for image or video containers. Accepts positive numbers and CSS values.
showLabel
Section titled “showLabel”- Type:
boolean - Default:
—
Specifies whether to display labels under images or videos. Labels text are taken from the text property of each object in the choices array.
colCount
Section titled “colCount”- Type:
number - Default:
0 - Allowed values:
0,1,2,3,4,5
Gets or sets the number of columns used to arrange choice items.
hideIfChoicesEmpty
Section titled “hideIfChoicesEmpty”- Type:
boolean - Default:
—
Specifies whether to hide the question if no choice items are visible.
Shared Properties
Section titled “Shared Properties”This page lists only properties that are specific to this element type or especially important for generation.
- Use Shared Question Properties for common fields such as
name,title,description,isRequired,requiredIf,visibleIf,enableIf,readOnly,defaultValue,validators,width, and layout options. - Use Shared Choice Question Properties for shared choice fields such as
choices,choicesByUrl,choicesFromQuestion,showOtherItem,showNoneItem, and special choice labels. - Use Choice Item for object choices and Choices By URL for remote choice loading.