Form Layout: Adding a Control Next to a Field

If you need to define an additional control—for example, a button, another field, or a label—next to a field, you can add the corresponding tag inside the field tag. Each field tag can include one tag or multiple tags, such as qp-field or qp-button.

You can add more than one control in place of a field in the following ways:

By adding the additional controls inside the field tag.
In this case, the controls inside the field tag are dependent on the behavior of the control bound to the field tag. For example, when the control bound to the field tag is hidden (for example, due to a feature switch or by user personalization), the dependent control is also hidden.
By default, the second control will occupy half of the space dedicated for the original field. If you need the second control to have a different width, you can specify class="col-N", where N is a number of columns that is less than 12. The minimum width is 2 columns. To move a field to the next line, specify col-12.
By replacing the contents of the field tag with controls specified inside the field tag (by using the replace-content attribute).
In this case, all controls specified in the field tag are independent of each other and the replaced control (except for nested controls).
If you need to specify the width of the controls, you need to specify col-XX classes for all controls nested in the field tag unless the controls are nested within each other.

Adding a Check Box Next to an Element

You can add a check box next to an element (defined by the field tag) so that they both occupy a space of a single control. To do that, you need to add the qp-field bound to this check box inside the field tag. For example, suppose that you need to add the Canceled check box next to the Cancel Date box, as shown in the following screenshot.

Figure 1. The Canceled check box next to the Cancel Date box

The following code can be used to add the check box next to the Cancel Date box (which corresponds to the CancelDate field).

<field name="CancelDate">
  <qp-field control-state.bind="CurrentDocument.Cancelled" config-enabled.bind="false"></qp-field>
</field>

Note:

You do not need to specify class="no-label" for the second control to omit the empty label of the check box because this class is used by default for a qp-field tag inside the field tag.

Adding a Button to the Next Line

You can add a button after a control so that it is displayed on the next line below the control. To do that, you need to add the button control inside the field tag and specify class="col-12" for the button control.

For example, suppose that you need to place the Address Lookup button on the next line after a check box, as shown in the following screenshot.

Figure 2. The Address Lookup button below a check box

The Address Lookup button is implemented by using the qp-address-lookup tag. The following code shows an example of moving the Address Lookup button to the next line.

<field name="OverrideAddress">
  <qp-address-lookup class="col-12" view.bind="Shipping_Address">
  </qp-address-lookup>
</field>

Adding a Label Next to an Element

You can add a label on the right side of an element, for example, when you need to display the unit of measure of the value. You do this by adding the qp-label tag inside the field tag.

Note:

We recommend that instead of adding labels next to an element, you rephrase the label of the element so that no label is required next to it.

Suppose that you need to display a label to the right of a box, as shown in the following screenshot with multiple labels.

Figure 3. Labels to the right of the boxes

You need to add the qp-label tag inside the field tag, as shown in the following example.

<field name="RunCntr">
  <qp-label caption="Times"></qp-label>
</field>

Replacing a Field

You can put arbitrary content, such as a text box and a button, instead of an element (that is, occupy the field space with arbitrary elements) by doing the following:

In the field tag, specify the replace-content attribute.
Optional: If the field whose content you are replacing has no definition in TypeScript, add the unbound attribute.
Inside the field tag, add all tags for the elements you want to add.

Suppose that you want to replace the content of an element with one button that occupies the whole space of the element, as shown in the following screenshot.

You need to add the qp-button tag inside the field tag, as shown in the following code.

<field name="fakename" replace-content unbound>
    <qp-button id="buttonShopRates" class="col-12" state.bind="ShopRates"></qp-button>
</field>

Adding Multiple Elements in a Line

You can put multiple elements, such as check boxes, in one line by placing them inside the single field tag and specifying the proper CSS class. For details about CSS classes, see Form Layout: CSS Classes.

Suppose that you need to show three check boxes in a single line, as shown in the following screenshots.

Figure 5. Three check boxes in a single line

You need to put three qp-field tags inside a single field tag and specify class="col-4" for each of the qp-field tags, as shown in the following code.

<field name="fake01" unbound replace-content>
    <qp-field control-state.bind="StaffScheduleSelected.WeeklyOnSun" config-enabled.bind="false" class="col-4"></qp-field>
    <qp-field control-state.bind="StaffScheduleSelected.WeeklyOnWed" config-enabled.bind="false" class="col-4"></qp-field>
    <qp-field control-state.bind="StaffScheduleSelected.WeeklyOnSat" config-enabled.bind="false" class="col-4"></qp-field>
</field>

Note:

You do not need to set class="no-label" to remove the label before each check box because this class is used by default in this case.

The col-4 class helps to distribute the check boxes equally, which means that each check box occupies 4 (12 / 3 = 4) columns out of the 12 columns that the replaced element occupies. (If you need to have four columns and need to distribute them equally, you should use class="col-3".)