<label>

This is a child tag, required for all form controls. The text contained between the <label> and </label> tags is used to identify the control to the user. On a standard form it is used as the caption for that control.

The contents are also used in other areas of XMod, when a friendly name is needed to display to the user. A good example of this is in a drop-down list of fields the user can choose from to determine which field to sort on.

Custom layout forms do not use the <label> tag for displaying a control's caption (since it is presumed you will handle that as part of your custom layout). However, it is still required because it is used elsewhere in XMod.

EXAMPLES:

Custom HTML Layout Form

<form format="custom">

  <controls>

    <!--Everything in here is HTML -->

    <table style="border: 1px blue solid; width=400px;">

           <tr>

        <td>

          <h2>Welcome To My Custom Form</h2>

        </td>

      </tr>

    </table>

    <table width="400" cellpadding="3">

      <tr>

        <td style="background-color:maroon; color:white;">

          Your Name:

        </td>

        <td>

          <input ref="UserName" width="250px" class="NormalTextBox">

            <label>User Name</label>

          </input>

        </td>

      </tr>

    </table>

  </controls>

</form>

Auto-Layout Form

In the example below, there are two labels.

<form> 

  <controls>

    <input ref="Name" width="250px" class="NormalTextBox">

      <label>Your Name</label>

    </input>

    <input ref="Address" width="250px" class="NormalTextBox">  </controls>

      <label>Your Address</label>

    </input>

  </controls>

</form>