EditForm

This display component is the default display class used to render forms in a browser.

Form components are positioned in two columns, with titles on the left, and components on the right. Flyover help can be included with the titles. Multiple components can be concatenated on a single row.

Most edited properties include title, subTitle and adjacentTitleWidth.

<Form name=’Default User Form’ help=’account/modify-help.xml’>
   <Display class=’EditForm’>
     <Property name=’titleWidth’ value=’120’>
     <Property name=’adjacentTitleWidth’ value=’60’>
   </Display>

Additional EditForm properties include:

• adjacentTitleWidth– Specifies the width of the titles of adjacent fields. If this property is not defined, it defaults to zero. If you define adjacentTitleWidth as equal to zero, columns titles will automatically resize. If set to a non-zero value, then the title width of adjacent columns (for example, the second and third columns) will be the value of adjacentTitleWidth.

• border - Specifies the width in pixels of the table that contains the EditForm component. Defaults to 0, which indicates no border.

• cellpadding - Specifies the cellpadding of the table that contains the EditForm component. Defaults to 5.

• cellspacing - Specifies the cellspacing of the table that contains the EditForm component. Defaults to 0.

• componentTableWidth– Specifies the width (in pixels) of the EditForm. If not specified, this defaults to either 400 pixels or the value of the defaultComponentTableWidth global property for EditForm

• defaultComponentTableWidth - Specifies the width in pixels of the table in which Identity Manager renders each component. Identity Manager consults this property if the componentTableWidth property has not been explicitly set on the EditForm. When this component is not set, no width is specified for the component table.

• defaultRequiredAnnotationLocation - Specifies the default location (left, right, or none) with respect to the component to render the required annotation. Identity Manager consults this property if the requiredMarkerLocation property has not been explicitly set on the EditForm. Defaults to right.

• evenRowClass - Specifies the CSS class to use to style the even rows of the EditForm table (if the noAlternatingRowColors property is not set to true). Defaults to formevenrow.

• helpIcon - Specifies the icon to render for flyover help messages for components. Defaults to images/helpi_gold.gif.

• noAlternatingRowColors– Specifies whether rows in the EditForm are rendered in the same color. When noAlternatingRowColors is set to true, every row in the EditForm is rendered the same color. If not specified, this defaults to false.

• oddRowClass - Specifies the CSS class to use to style the odd rows of the EditForm table (if the noAlternatingRowColors property is not set to true). Defaults to formoddrow.

• requiredAnnotation - Specifies the annotation to render next to a required field. This defaults to an image of a red asterisk.

• requiredClass - Specifies the CSS class to use to style the required field legend. Defaults to errortxt.

• requiredLegendLocation - Specifies the location (top or bottom) at which to render the required legend if the form contains any required fields. Defaults to bottom.

• rowPolarity - Specifies the polarity of alternating gray and white row colors in a table. The default is true. A value of false inverts the polarity and gives the first form field a white background. The code shown in the following example results in a table whose first form field has a white background.

  <Display class=’EditForm’>
     <Property name=’componentTableWidth’ value=’100%’/>
     <Property name=’rowPolarity’ value=’false’/>
     <Property name=’requiredMarkerLocation’ value=’left’/>
     <Property name=’messages’>
        <ref>msgList</ref>
     </Property>
  </Display>

• tableClass - Specifies the CSS class to use to style the table that contains the EditForm component.

• tableWidth - Specifies the width in pixels of the table in which Identity Manager renders the EditForm component. Defaults to 400.

• titleClass - Specifies the CSS class to use to style help messages for components.