setProperties()

allows changing available configuration attributes of the control dynamically

setProperties(properties: object): void;

Parameters:

• properties: object - an object with the available attributes of the control and their new values

Example

form.getItem("datepicker").setProperties({
    editable: true,
    labelWidth: "100px",
    required: true
});

info

The method invokes the afterChangeProperties and beforeChangeProperties events.

It is possible to change values of the following configuration attributes of the DatePicker control:

{
    css: string,
    dateFormat: string,
    disabledDates: function,
    editable: boolean,
    errorMessage: string,
    height: string|number|"content",
    helpMessage: string,
    hiddenLabel: boolean, 
    icon: string,
    label: string,
    labelPosition: string,
    labelWidth: string|number,
    mark: function,
    mode: string,
    padding: string|number,
    placeholder: string,
    preMessage: string,
    required: boolean,
    successMessage: string,
    thisMonthOnly: boolean,
    timeFormat: number,
    timePicker: boolean,
    validation: function,
    valueFormat: string,
    weekNumbers: boolean,
    weekStart: string,
    width: string|number|"content",
}

You will find the description of these properties here.

Change log:

added in v7.0