Setting properties for editable areas in custom controls

Set properties for editable areas in the custom control. You can set properties for the name of the editable area as well as the facet name. You can also configure how and if the editable area is visible inside the custom control at run time.

Before you begin

To set properties for editable areas, do the following steps.
Note: This topic covers steps for setting properties for editable areas in custom controls as individual design elements. For information about setting properties for user interface (UI) controls that you add to editable areas in custom controls in XPages, see "Adding UI controls to editable areas in custom controls."

About this task


  1. Select the editable area in the custom control as an independent design element (meaning the custom control is not inside an XPage).
  2. In the Properties view, click the Editable Area tab.
  3. In the Name field, type the name of the editable area. This is the name of the editable area as it will appear in the XSP source code. The default name of the first editable area is callback1, the second callback2, and so on.
  4. Select the Visible check box to make the editable area visible at run time. To compute the value of this property, click the diamond-shaped icon, select Compute value, and use the script editor to write a formula.
  5. In the Facet Name field, either type a static name in the field, or click the diamond-shaped icon to compute the value of the field.
    • If the facet name is static (not computed), the UI control that you add to the editable area will inherit the facet name.
      Note: If this UI control is a container control that contains other UI controls, then only the container control inherits the facet name. This means that none of UI controls inside the container control get assigned to the facet.
    • If the facet name is computed, then you can determine the contents of the editable area dynamically. This means you can insert multiple UI controls with different facet names into the editable area. The script that you write determines which UI controls are displayed in the editable area at run time based on which facet name is returned by the script.
  6. Click File > Save to save your changes.