Skip to main content


Element type: Dictionary

Shows several values to the end user in a pop-up menu for them to chose from. The variable value will be the selected item among the items you provided. The type of the value will depend on the ones you specified.


NameTypePossible valuesRequired
LabelFontConfigurationDictionary (Font)-
DistributionStringFit, Center
ItemsArray(String) or Array(Number)Required
MarginsDictionary (Margins)-
BorderDictionary (Border)-
Condition PRODictionary (Condition)-


Type Required

Type: String
Explanation: The type of the component has to be Input.

InputType Required

Type: String
Explanation: The type of the component which has to be List.

Variable Required

Type: String
Explanation: The variable used within the application and as a key in the input file Octory will create to let you retrieve the user inputs.


Type: String
Explanation: The label lets you give some insight to the end user about the value they need to enter. Its text will generally be placed on the left side of the input field.


If you do not specify a label, the input field will be centered. To keep the alignment with other input components which have a label, give the Label a whitespace for value.


Type: Dictionary (Font)
Explanation: Let you specify the font configuration to use. Default is "DefaultPrimary" if specified in the Font styles in the configuration file, or system font otherwise.


Type: String
Possible values: Fit, Center
Default: Center
Explanation: Specify how the label and the input field are stacked.

  • Fit gives them as much space as they need, but the input component will not be aligned with the other ones.
  • Center align the label and the input field in the horizontal middle of its container. This allows several input components to be aligned, although it may crop the text label.


Type: Number
Possible values: 0...1
Explanation: This value allows you to give more width to an input component, by specifying the percentage width it should take in its container. Default is most often 0.4.

Items Required

Type: Array(String) or Array(Number)
Explanation: Array of choices to propose to the end user. All the values need to have the same type to let Octory infer it. You can chose an array of String or Number. If Number is chosen, you can write Int or Real values, but you cannot mix them.


Type: Dictionary
Explanation: Let you force the user to choose a value in a List input component.

Input Text Validation

FontConfigurationDictionary (Font)


Type: String
Explanation: The text to display to the user when the input is empty or its value is incorrect. Default is "Incorrect or empty value".


Type: Dictionary (Font)
Explanation: The font configuration to use for the warning text.

Instruction Required

Type: String
Explanation: The text to display as an instruction to the user. This text will disappear when the user has selected an item.


Type: Dictionary (Margins)
Explanation: Add padding to the component's sides.


Type: Dictionary (Border)
Explanation: Add a top or bottom border to a component.

Condition PRO

Type: Dictionary (Condition)
Explanation: Allows to hide or show the component using a boolean expression.


List input component to choose a value among {Apprentice, Intermediate, Master, Expert, Legend} and a validation which prevents the user from going to the next slide until he has selected an item. A "Choose" instruction is displayed at first.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">
<!-- ... -->
<string>Please choose a value</string>
<!-- ... -->