...
Name | Required | Description | Value | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| yes | Used to specify what kind of field you want to place. | Any valid field type | |||||||||
| yes, if input field | The variable that should be substituted with the user input. | A variable name. | |||||||||
| no | The ID of a condition in install.xml which must evaluate to true in order to display the field. | A valid condition id in install.xml. | |||||||||
tooltip | no | The ID of a string to be displayed as the tooltip for the GUI components in this field. | The id of a string from langpacks. | |||||||||
omitFromAuto | no | Whether to omit the field variable's value from being written to the auto-install.xml record initiated from the FinishPanel (if used). Needs to be set on the 'spec' tag.```
<pwd
``` | true, false default: true for "password" fields, otherwise false | |||||||||
readonly | no | The
| true, false default: false | |||||||||
readonlyCondition | no | The
| true, false default: false | |||||||||
displayHidden | no | Enables to "grey out" the field not matching its specific condition. Makes just sense if a Setting
| true, false default: false | |||||||||
displayHiddenCondition | no | The
| true, false default: false | |||||||||
summaryKey | no | Id of a string that represents what name to display in the SummaryPanel of the UserInputPanel for this field. This attribute must be defined if you would like to summarize information about the user input made in this field in the SummaryPanel. Note that you will have to add the summaryKey attribute to the panel element itself also if you would like those to show up the field information in the SummaryPanel as well. |
...
Attributes of the <spec>
element:
Attribute | Description | Required | Possible Values | Default Value |
---|---|---|---|---|
id | Unique identifier, used for finding field label translations. | yes (if txt not defined) | any string | - |
txt | Default label text, overridden by existing translations. | yes (if id not defined) | any string | - |
size | Field size in characters for all text edit fields. | no | positive integer | - |
set | The set attribute forces the contents of the field whenever the panel is reached during navigating, even if the user has chosen a different value when the panel already appeared before. Variable references in the attribute's value are dynamically resolved during an installation. | no | true | false | (the current variable value is used if defined) |
default | The default attribute is the default for the contents of the field whenever the panel is reached during navigating, in case the underlying field variable is not defined during an installation at this state. Variable references in the attribute's value are dynamically resolved during an installation. | no | true | false | (the current variable value is used if defined) |
Example
In the following example, the variables: name1, name2, name3 will be substituted.
...