Fieldset: Field Configuration

You can define properties of a field in a fieldset by using the fieldConfig decorator or by using the controlConfig decorator, which is a shortcut for the fieldConfig decorator.

The controlConfig decorator accepts configuration of the associated control as a parameter. If you do not need to specify the type of the control (in the controlType property), you can use the controlConfig decorator instead of the fieldConfig decorator.

Example

Suppose that you have the following code in HTML.

<field name="FormatLocale"
    control-type="qp-selector" config.bind="{ displayMode: 'text', 
        suggester: { descriptionName:'CultureReadableName' } }">
</field>

We recommend that you rewrite the code above by using the fieldConfig decorator as follows.

@fieldConfig({
    controlType: "qp-selector",
    controlConfig: {
     displayMode: 'text',
     suggester: { descriptionName: 'CultureReadableName' },
    }
}) 
FormatLocale: PXFieldState;

If you do not need to change the default type of the control, you can make the TypeScript code shorter by using the controlConfig decorator, as shown in the following example.

@controlConfig({
   displayMode: 'text',
   suggester: { descriptionName: 'CultureReadableName' },
}) 
FormatLocale: PXFieldState;

<field name="FormatLocale"></field>