survey-core 1.11.4 → 1.11.6

package/typings/question.d.ts

@@ -490,6 +490,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     set hasOther(val: boolean);
     protected hasOtherChanged(): void;
     get requireUpdateCommentValue(): boolean;
+    readOnlyCallback: () => boolean;
     get isReadOnly(): boolean;
     get isInputReadOnly(): boolean;
     get renderedInputReadOnly(): string;
@@ -527,6 +528,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     protected initDataFromSurvey(): void;
     protected initCommentFromSurvey(): void;
     protected runExpression(expression: string): any;
+    get commentAreaRows(): number;
     private get autoGrowComment();
     private get allowResizeComment();
     private get questionValue();
@@ -727,6 +729,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     protected isValueExpression(val: any): boolean;
     protected setValueAndRunExpression(runner: ExpressionRunner, defaultValue: any, setFunc: (val: any) => void, values?: HashTable<any>, properties?: HashTable<any>): void;
     protected convertFuncValuetoQuestionValue(val: any): any;
+    private runExpressionSetValueCore;
     private runExpressionSetValue;
     private runDefaultValueExpression;
     /**
@@ -788,7 +791,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     protected canRunValidators(isOnValueChanged: boolean): boolean;
     private fireSurveyValidation;
     protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
-    protected hasRequiredError(): boolean;
+    hasRequiredError(): boolean;
     private validatorRunner;
     private isRunningValidatorsValue;
     onCompletedAsyncValidators: (hasErrors: boolean) => void;

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_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_paneldynamic.d.ts

@@ -562,7 +562,7 @@ export declare class QuestionPanelDynamicModel extends Question implements IQues
     private removedPanelIndex;
     removePanel(value: any): void;
     private getVisualPanelIndex;
-    private getPanelIndexById;
+    private getPanelVisibleIndexById;
     locStrsChanged(): void;
     clearIncorrectValues(): void;
     clearErrors(): void;

package/typings/question_ranking.d.ts

@@ -56,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;
@@ -90,9 +90,6 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     */
     get longTap(): boolean;
     set longTap(val: boolean);
-    /**
-     * The name of a component used to render items.
-     */
     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,18 @@ 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-element.d.ts

@@ -11,6 +11,26 @@ import { ActionContainer } from "./actions/container";
 export declare abstract class SurveyElementCore extends Base implements ILocalizableOwner {
     constructor();
     protected createLocTitleProperty(): LocalizableString;
+    /**
+     * Returns `true` if the survey element is a page.
+     * @see Base.getType
+     */
+    get isPage(): boolean;
+    /**
+     * Returns `true` if the survey element is a panel.
+     * @see Base.getType
+     */
+    get isPanel(): boolean;
+    /**
+     * Returns `true` if the survey element is a question.
+     * @see Base.getType
+     */
+    get isQuestion(): boolean;
+    /**
+     * Returns `true` if the element is a survey.
+     * @see Base.getType
+     */
+    get isSurvey(): boolean;
     /**
      * A title for the survey element. If `title` is undefined, the `name` property value is displayed instead.
      *
@@ -278,21 +298,6 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
     onFirstRendering(): void;
     endLoadingFromJson(): void;
     setVisibleIndex(index: number): number;
-    /**
-     * Returns `true` if the survey element is a page.
-     * @see Base.getType
-     */
-    get isPage(): boolean;
-    /**
-     * Returns `true` if the survey element is a panel.
-     * @see Base.getType
-     */
-    get isPanel(): boolean;
-    /**
-     * Returns `true` if the survey element is a question.
-     * @see Base.getType
-     */
-    get isQuestion(): boolean;
     delete(doDispose: boolean): void;
     locOwner: ILocalizableOwner;
     /**

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;
+    allowDropNextToAnother?: boolean;
     /**
      * Obsolete. Use `options.draggedElement` instead.
      */

package/typings/survey.d.ts

@@ -1067,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);
@@ -1077,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.
      *
@@ -1140,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.
      *
@@ -1583,6 +1597,24 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     mergeData(data: any): void;
     setDataCore(data: any, clearData?: boolean): void;
+    get isSurvey(): boolean;
+    /**
+     * Returns an object with survey results.
+     *
+     * If you want to get a survey results object that mirrors the survey structure, call the `getData()` method with an object that has the `includePages` and `includePanels` properties enabled. Without this object, the `getData()` method returns the [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data) property value.
+     *
+     * ```js
+     * import { Model } from "survey-core";
+     *
+     * const surveyJson = { ... };
+     * const survey = new Model(surveyJson);
+     * survey.getData({ includePages: true, includePanels: true });
+     * ```
+     */
+    getData(options?: {
+        includePages?: boolean;
+        includePanels?: boolean;
+    }): any;
     getStructuredData(includePages?: boolean, level?: number): any;
     setStructuredData(data: any, doMerge?: boolean): void;
     private collectDataFromPanel;

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;