Properties Config¶
The Properties Config is an object passed as an optional prop to the <CommonProperties<
React object containing the following fields:
-
containerType
string
: type of container to display the properties, can be “Modal”, “Tearsheet”, or “Custom”. default:"Custom"
-
rightFlyout
boolean
: If set to true, groups will be displayed as an accordion. If false, groups are displayed as tabs. default:false
-
applyOnBlur
boolean
: calls applyPropertyChanges when focus leave Common Properties. default:false
-
disableSaveOnRequiredErrors
boolean
: Disable the properties editor “save” button if there are required errors -
enableResize
boolean
: adds a button that allows the right-side fly-out editor to expand/collapse between small and medium sizes. default:true
-
conditionReturnValueHandling
string
: used to determine how hidden or disabled control values are returned in applyPropertyChanges callback. Current options are “value” or “null”. default:"value"
-
buttonLabels
object
:- primary
string
: Label to use for the primary button of the properties dialog - secondary
string
: Label to use for the secondary button of the properties dialog
- primary
-
heading
boolean
: show heading and heading icon in right-side fly-out panels. default:false
-
schemaValidation
boolean
: If set to true, schema validation will be enabled when a parameter definition has been set in CommonProperties. Any errors found will be reported on the browser dev console. It is recommended you run with schema validation switched on while in development mode. -
applyPropertiesWithoutEdit
boolean
: When true, will always callapplyPropertyChanges
even if no changes were made. default:false
-
maxLengthForMultiLineControls
number
- maximum characters allowed for multi-line string controls like textarea. default: 1024 -
maxLengthForSingleLineControls
number
- maximum characters allowed for single-line string controls like textfield. default: 128 -
convertValueDataTypes
boolean
- Default false. If set to true, currentParameter values whose data type does not match what is defined in the parameter definitions will be converted to the specified data type. -
trimSpaces
boolean
- Default true. If set to false, condition ops(isEmpty
,isNotEmpty
) andrequired
fields are allowed to only contain spaces without triggering condition errors. -
showRequiredIndicator
boolean
- Default true to show(required)
indicator. If set to false, show(optional)
indicator next to properties label. -
showAlertsTab
boolean
- Default true to show “Alerts” tab whenever there are error or warning messages. If set to false, Alerts tab won’t be displayed. -
returnValueFiltering
array
- Default []. When set this will filter out any values in the array in the parameters returned whenapplyPropertyChanges
is call. Only primitive data types are currently supported. -
categoryView
string
- View categories in right-flyout. Can be"accordions"
or"tabs"
. default:"accordions"
.