We need you!


The IzPack documentation needs work, and you are invited to edit it!

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


The section Built-in Panel Types introduces the various panels available in IzPack. The usage of each is described, and the panels are listed by their class name (this is the name that must be used with the classname attribute). 


classnameThe class name of the panel. The attribute value is case-sensitive, meaning that if the case in the installation file differs from the case in the class file, the compiler will throw an IllegalArgumentExceptionYes
idA unique identifier for a panel which can be used e.g. for referencing to reference this panel in userinput panel definitions.No
conditionThe id of a condition that has to be evaluated evaluate to true in order for this panel to appear. If this attribute is not specified. the panel is always shown.No
jarThe jar file where the classes for this panel can be found. If this attribute is empty or unspecified, the classes for this panel must be merged using the <jar> tag.No

Represents the percentage of left over vertical space to place on top of the components. Setting topBuffer=0 is useful if you don't want your panel to be moved up or down during dynamic validation (showing and hiding components within the same panel). The topBuffer attribute may also represent the number of pixels to place on top of the components rather than the percentage of left over space if the rigid attribute is set to true.
Default: 25 


When set to true, the topBuffer will represent the number of pixels to place on top of the components rather than a percentage. This is useful to avoid components moving up and down during dynamic validation (showing and hiding components within the same panel), and where you would still like a gap to be placed on top of the components.

Default: false


Nested Elements 


Specify optional, custom configuration parameters for a custom panel using the <configuration> element. Each parameter is specified using a nested <param> element, which must have both a name and a value attribute. 


Specifies an optional help file for a panel. The contents of the help file is shown in a small window on the panel, when the user clicks on the Help button.

The help file can contain text that is formated using html HTML elements(<p>,<h1>,<ul>,<li>, etc.).

The button is only shown when a help in for the language exists.

iso3The ISO3 representation of the language in which the help is written.Yes
srcThe path where the compiler will find the help file to display.Yes


Specifies an optional panel data validator. See the section Panel Data Validators.


Specifies one or more optional panel life-cycle actions.  See the section Panel Actions.


Code Block
titleA panel with help files in German and English.
<panel classname="HelloPanel" id="hello"  condition="verbosemode">
  <help iso3="deu" src="HelloPanelHelp_deu.html" />
  <help iso3="eng" src="HelloPanelHelp_eng.html" />


Code Block
titlePanel in the context of an installation specification
<installation version="5.0"
              xsi:schemaLocation="http://izpack.org/schema/installation http://izpack.org/schema/5.0/izpack-installation-5.0.xsd">

    <javaver   sion>1.6</javaversion>
    <res id="InfoPanel.info" src="doc/readme.txt" parse="yes"/>
    <res id="LicencePanel.licence" src="legal/License.txt"/>

  <guiprefs width="800" height="600" resizable="no">
    <laf name="substance">
      <os family="windows" />
      <os family="unix" />
      <param name="variant" value="mist-silver" />
    <laf name="substance">
      <os family="mac" />
      <param name="variant" value="mist-aqua" />
   <modifier key="useHeadingPanel" value="yes" />

   <panel classname="HelloPanel">
      <help iso3="deu" src="HelloPanelHelp_deu.html" />
      <help iso3="eng" src="HelloPanelHelp_eng.html" />        
   <panel classname="LicencePanel"/>
   <panel classname="TargetPanel"/>
   <panel classname="InstallPanel"/>
   <panel classname="UserInputPanel" id="myuserinput" condition="pack2selected" />
   <panel classname="FinishPanel" jar="MyFinishPanel.jar">
        <param name="MyParam1" value="some value"/>
        <param name="MyParam2" value="some other value"/>