survey-core 1.11.3 → 1.11.5

package/typings/question_baseselect.d.ts

@@ -486,6 +486,11 @@ export declare class QuestionSelectBase extends Question {
     get hasHeadItems(): boolean;
     get hasFootItems(): boolean;
     get columns(): any[];
+    protected getObservedElementSelector(): string;
+    protected supportResponsiveness(): boolean;
+    allowMultiColumns: boolean;
+    protected onBeforeSetCompactRenderer(): void;
+    protected onBeforeSetDesktopRenderer(): void;
     get hasColumns(): boolean;
     get rowLayout(): boolean;
     get blockedRow(): boolean;
@@ -510,6 +515,10 @@ export declare class QuestionSelectBase extends Question {
     protected getDefaultItemComponent(): string;
     /**
      * The name of a component used to render items.
+     *
+     * [View Dropdown Demo](https://surveyjs.io/form-library/examples/dropdown-box-with-custom-items/ (linkStyle))
+     *
+     * [View Ranking Demo](https://surveyjs.io/form-library/examples/dropdown-box-with-custom-items/ (linkStyle))
      */
     get itemComponent(): string;
     set itemComponent(value: string);

package/typings/question_boolean.d.ts

@@ -31,10 +31,6 @@ export declare class QuestionBooleanModel extends Question {
     getDefaultValue(): any;
     get locTitle(): LocalizableString;
     get labelRenderedAriaID(): string;
-    leftAnswerElement: HTMLElement;
-    thumbMargin: string;
-    updateThumbMargin(): void;
-    afterRender(el: HTMLElement): void;
     beforeDestroyQuestionElement(el: HTMLElement): void;
     showTitle: boolean;
     label: string;

package/typings/question_checkbox.d.ts

@@ -149,4 +149,5 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
     get checkBoxSvgPath(): string;
     get isNewA11yStructure(): boolean;
     get a11y_input_ariaRole(): string;
+    get a11y_input_ariaRequired(): "true" | "false";
 }

package/typings/question_custom.d.ts

@@ -150,7 +150,7 @@ export interface ICustomQuestionTypeConfiguration {
      */
     onPropertyChanged?(question: Question, propertyName: string, newValue: any): void;
     /**
-     * A function that is called after the question value is changed.
+     * A function that is called after the question value is changed in the UI.
      *
      * Parameters:
      *
@@ -160,10 +160,12 @@ export interface ICustomQuestionTypeConfiguration {
      * The question's [name](https://surveyjs.io/Documentation/Library?id=Question#name).
      * - `newValue`: `any`\
      * A new value for the question.
+     *
+     * If you want to perform some actions when the value is changed in code as well as in the UI, implement the [`onValueSet`](https://surveyjs.io/form-library/documentation/api-reference/icustomquestiontypeconfiguration#onValueSet) function.
      */
     onValueChanged?(question: Question, name: string, newValue: any): void;
     /**
-     * A function that is called before a question value is changed.
+     * A function that is called before a question value is changed in the UI.
      *
      * This function should return the value you want to save: `newValue`, a custom value, or `undefined` if you want to clear the question value.
      *
@@ -231,6 +233,21 @@ export interface ICustomQuestionTypeConfiguration {
      * @returns An error text.
      */
     getErrorText?: (question: Question) => string;
+    /**
+     * A function that is called after the question value is set.
+     *
+     * Parameters:
+     *
+     * - `question`: [Question](https://surveyjs.io/Documentation/Library?id=Question)\
+     * A custom question.
+     * - `newValue`: `any`\
+     * A new value for the question.
+     *
+     * Unlike the [`onValueChanged`](https://surveyjs.io/form-library/documentation/api-reference/icustomquestiontypeconfiguration#onValueChanged) function, which is called only when the question value is changed in the UI, `onValueSet` is called when the value is changed in code as well.
+     *
+     * [View Demo](https://surveyjs.io/survey-creator/examples/smart-search-input/ (linkStyle))
+     */
+    onValueSet?: (question: Question, newValue: any) => void;
     onSetQuestionValue?: (question: Question, newValue: any) => void;
     valueToQuestion?: (val: any) => any;
     valueFromQuestion?: (val: any) => any;

package/typings/question_expression.d.ts

@@ -30,7 +30,7 @@ export declare class QuestionExpressionModel extends Question {
     unlocCalculation(): void;
     runCondition(values: HashTable<any>, properties: HashTable<any>): void;
     protected canCollectErrors(): boolean;
-    protected hasRequiredError(): boolean;
+    hasRequiredError(): boolean;
     private createRunner;
     /**
      * The maximum number of fraction digits. Applies only if the `displayStyle` property is not `"none"`. Accepts values in the range from -1 to 20, where -1 disables the property.

package/typings/question_matrixdropdown.d.ts

@@ -9,6 +9,8 @@ export declare class MatrixDropdownRowModel extends MatrixDropdownRowModelBase {
     get rowName(): string;
     get text(): string;
     get locText(): LocalizableString;
+    isRowEnabled(): boolean;
+    protected isRowHasEnabledCondition(): boolean;
 }
 /**
   * A class that describes the Multi-Select Matrix question type. Multi-Select Matrix allows you to use the [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel), [Checkbox](https://surveyjs.io/form-library/documentation/questioncheckboxmodel), [Radiogroup](https://surveyjs.io/form-library/documentation/questionradiogroupmodel), [Text](https://surveyjs.io/form-library/documentation/questiontextmodel), and [Comment](https://surveyjs.io/form-library/documentation/questioncommentmodel) question types as cell editors.

package/typings/question_matrixdropdownbase.d.ts

@@ -34,6 +34,7 @@ export interface IMatrixDropdownData {
     onTotalValueChanged(): any;
     getSurvey(): ISurvey;
     getDataFilteredValues(): any;
+    isMatrixReadOnly(): boolean;
 }
 export declare class MatrixDropdownCell {
     column: MatrixDropdownColumn;
@@ -81,6 +82,8 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     get rowName(): any;
     get dataName(): string;
     get text(): any;
+    isRowEnabled(): boolean;
+    protected isRowHasEnabledCondition(): boolean;
     get value(): any;
     set value(value: any);
     get locText(): LocalizableString;
@@ -133,7 +136,7 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     locStrsChanged(): void;
     updateCellQuestionOnColumnChanged(column: MatrixDropdownColumn, name: string, newValue: any): void;
     updateCellQuestionOnColumnItemValueChanged(column: MatrixDropdownColumn, propertyName: string, obj: ItemValue, name: string, newValue: any, oldValue: any): void;
-    onQuestionReadOnlyChanged(parentIsReadOnly: boolean): void;
+    onQuestionReadOnlyChanged(): void;
     private validationValues;
     hasErrors(fireCallback: boolean, rec: any, raiseOnCompletedAsyncValidators: () => void): boolean;
     protected updateCellOnColumnChanged(cell: MatrixDropdownCell, name: string, newValue: any): void;
@@ -512,6 +515,7 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
     onTotalValueChanged(): any;
     getDataFilteredValues(): any;
     getParentTextProcessor(): ITextProcessor;
+    isMatrixReadOnly(): boolean;
     getQuestionFromArray(name: string, index: number): IQuestion;
     private isMatrixValueEmpty;
     private get SurveyModel();

package/typings/question_ranking.d.ts

@@ -12,7 +12,6 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     private domNode;
     private dragOrClickHelper;
     constructor(name: string);
-    protected getDefaultItemComponent(): string;
     getType(): string;
     getItemTabIndex(item: ItemValue): number;
     protected supportContainerQueries(): boolean;
@@ -57,7 +56,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     endLoadingFromJson(): void;
     private setDragDropRankingChoices;
     protected createDragDropRankingChoices(): DragDropRankingChoices;
-    private draggedChoise;
+    private draggedChoiceValue;
     private draggedTargetNode;
     handlePointerDown: (event: PointerEvent, choice: ItemValue, node: HTMLElement) => void;
     startDrag: (event: PointerEvent) => void;
@@ -91,11 +90,7 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     */
     get longTap(): boolean;
     set longTap(val: boolean);
-    /**
-     * The name of a component used to render items.
-     */
-    get itemContentComponent(): string;
-    set itemContentComponent(value: string);
+    protected getDefaultItemComponent(): string;
     /**
      * Specifies whether users can select choices they want to rank.
      *

package/typings/question_rating.d.ts

@@ -252,9 +252,14 @@ export declare class QuestionRatingModel extends Question {
     getItemClassByText(item: ItemValue, text: string): string;
     private getRenderedItemColor;
     getItemStyle(item: ItemValue, highlight?: "none" | "highlighted" | "unhighlighted"): {
-        borderColor: string;
-        fill: string;
-        backgroundColor: string;
+        "--sd-rating-item-color"?: undefined;
+        "--sd-rating-item-color-light"?: undefined;
+    } | {
+        "--sd-rating-item-color": string;
+        "--sd-rating-item-color-light": string;
+    } | {
+        "--sd-rating-item-color": string;
+        "--sd-rating-item-color-light"?: undefined;
     };
     getItemClass(item: ItemValue, highlight?: "none" | "highlighted" | "unhighlighted"): string;
     getControlClass(): string;

package/typings/settings.d.ts

@@ -335,11 +335,19 @@ export declare var settings: {
      */
     ratingMaximumRateValueCount: number;
     /**
-     * Specifies whether to close the drop-down menu of a [TagBox](https://surveyjs.io/form-library/examples/how-to-create-multiselect-tag-box/) question after a user selects a value.
+     * Specifies whether to close the drop-down menu of a [Multi-Select Dropdown (Tag Box)](https://surveyjs.io/form-library/examples/how-to-create-multiselect-tag-box/) question after a user selects a value.
      *
-     * This setting applies to all TagBox questions on a page. You can use the [closeOnSelect](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model#closeOnSelect) property to specify the same setting for an individual TagBox question.
+     * This setting applies to all Multi-Select Dropdown questions on a web page. You can use the [`closeOnSelect`](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model#closeOnSelect) property to specify the same setting for an individual Multi-Select Dropdown question.
      */
     tagboxCloseOnSelect: boolean;
+    /**
+     * A time interval in milliseconds between the last entered character and the beginning of search in [Single-](https://surveyjs.io/form-library/examples/create-dropdown-menu-in-javascript/) and [Multi-Select Dropdown](https://surveyjs.io/form-library/examples/how-to-create-multiselect-tag-box/) questions. Applies only to questions with the [`choicesLazyLoadEnabled`](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model#choicesLazyLoadEnabled) property set to `true`.
+     *
+     * Default value: 500
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/lazy-loading-dropdown/ (linkStyle))
+     */
+    dropdownSearchDelay: number;
     /**
      * A function that activates a browser confirm dialog.
      *

package/typings/survey-events-api.d.ts

@@ -946,6 +946,7 @@ export interface DragDropAllowEvent {
      * A Boolean property that you can set to `false` if you want to cancel the drag and drop operation.
      */
     allow: boolean;
+    allowMultipleElementsInRow?: boolean;
     /**
      * Obsolete. Use `options.draggedElement` instead.
      */

package/typings/survey.d.ts

@@ -443,7 +443,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onUpdatePageCssClasses: EventBase<SurveyModel, UpdatePageCssClassesEvent>;
     /**
-     * An event that is raised before rendering a choice item in Radio Button Group, Checkboxes, and Dropdown questions. Use it to override default CSS classes applied to choice items.
+     * An event that is raised before rendering a choice item in Radio Button Group and Checkboxes questions. Use it to override default CSS classes applied to choice items.
      *
      * For information on event handler parameters, refer to descriptions within the interface.
      *
@@ -1050,6 +1050,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"onValueChanged"` - Triggers validation each time a question value is changed.
      * - `"onComplete"` - Triggers validation when a user clicks the Complete button. If previous pages contain errors, the survey switches to the page with the first error.
      *
+     * > The `"onValueChanged"` doesn't work with date input fields because of the way browsers process date values. In most browsers, the value is considered changed as soon as a user starts entering the date in a text input field. This means that a user may only enter the day without having the chance to enter the month and year before validation is triggered. For this reason, date input fields are validated before the survey is switched to the next page or completed.
+     *
      * Refer to the following help topic for more information: [Data Validation](https://surveyjs.io/form-library/documentation/data-validation).
      * @see validationEnabled
      * @see validationAllowSwitchPages
@@ -1065,6 +1067,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * You can override this property for individual Long Text questions: [`autoGrow`](https://surveyjs.io/form-library/documentation/api-reference/comment-field-model#autoGrow).
      * @see allowResizeComment
+     * @see commentAreaRows
      */
     get autoGrowComment(): boolean;
     set autoGrowComment(val: boolean);
@@ -1075,9 +1078,21 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * You can override this property for individual Long Text questions: [`allowResize`](https://surveyjs.io/form-library/documentation/api-reference/comment-field-model#allowResize).
      * @see autoGrowComment
+     * @see commentAreaRows
      */
     get allowResizeComment(): boolean;
     set allowResizeComment(val: boolean);
+    /**
+     * Specifies the visible height of comment areas, measured in lines. Applies to the questions with the [`showCommentArea`](https://surveyjs.io/form-library/documentation/api-reference/question#showCommentArea) or [`showOtherItem`](https://surveyjs.io/form-library/documentation/api-reference/question#showOtherItem) property enabled.
+     *
+     * Default value: 2
+     *
+     * The value of this property is passed on to the `rows` attribute of the underlying `<textarea>` element.
+     * @see autoGrowComment
+     * @see allowResizeComment
+     */
+    get commentAreaRows(): number;
+    set commentAreaRows(val: number);
     /**
      * Specifies when to update the question value in questions with a text input field.
      *
@@ -1138,6 +1153,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     get locale(): string;
     set locale(value: string);
     private onSurveyLocaleChanged;
+    get localeDir(): string;
     /**
      * Returns an array of locales whose translations are used in the survey.
      *

package/typings/surveyStrings.d.ts

@@ -7,6 +7,9 @@ export declare var surveyLocalization: {
     localeNames: {
         [index: string]: any;
     };
+    localeDirections: {
+        [index: string]: any;
+    };
     supportedLocales: any[];
     currentLocale: string;
     defaultLocale: string;

package/typings/utils/devices.d.ts

@@ -6,3 +6,7 @@ export declare var mouseInfo: {
 };
 export declare let IsTouch: boolean;
 export declare function _setIsTouch(val: boolean): void;
+export declare type MatchMediaMethod = ((query: string) => {
+    matches: boolean;
+} | null) | null;
+export declare function detectMouseSupport(matchMedia: MatchMediaMethod): boolean;