survey-react 1.9.118 → 1.9.119

package/survey.min.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.118
+ * surveyjs - Survey JavaScript library v1.9.119
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.react.d.ts

@@ -82,6 +82,7 @@ declare module "localization/english" {
         urlRequestError: string;
         urlGetChoicesError: string;
         exceedMaxSize: string;
+        noUploadFilesHandler: string;
         otherRequiredError: string;
         uploadingFile: string;
         loadingFile: string;
@@ -201,6 +202,7 @@ declare module "surveyStrings" {
         urlRequestError: string;
         urlGetChoicesError: string;
         exceedMaxSize: string;
+        noUploadFilesHandler: string;
         otherRequiredError: string;
         uploadingFile: string;
         loadingFile: string;
@@ -702,6 +704,7 @@ declare module "conditionProcessValue" {
         private getValueFromSurvey;
         private getValueFromValues;
         private getNonNestedObject;
+        private getNonNestedObjectCore;
         private getObjInArray;
         private getFirstPropertyName;
         private getObjectValue;
@@ -1760,6 +1763,7 @@ declare module "defaultCss/defaultV2Css" {
             invisible: string;
             navigationButton: string;
             compact: string;
+            errorsContainer: string;
         };
         paneldynamic: {
             mainRoot: string;
@@ -1826,6 +1830,7 @@ declare module "defaultCss/defaultV2Css" {
             emptyHeaderRoot: string;
             title: string;
             description: string;
+            errorsContainer: string;
         };
         pageTitle: string;
         pageDescription: string;
@@ -1880,6 +1885,9 @@ declare module "defaultCss/defaultV2Css" {
             invisible: string;
             composite: string;
             disabled: string;
+            errorsContainer: string;
+            errorsContainerTop: string;
+            errorsContainerBottom: string;
         };
         image: {
             mainRoot: string;
@@ -1899,9 +1907,6 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             icon: string;
             item: string;
-            outsideQuestion: string;
-            aboveQuestion: string;
-            belowQuestion: string;
             locationTop: string;
             locationBottom: string;
         };
@@ -2119,6 +2124,8 @@ declare module "defaultCss/defaultV2Css" {
             rowHasEndActions: string;
             headerCell: string;
             rowTextCell: string;
+            footerCell: string;
+            footerTotalCell: string;
             columnTitleCell: string;
             cellRequiredText: string;
             detailButton: string;
@@ -2154,6 +2161,7 @@ declare module "defaultCss/defaultV2Css" {
             itemCell: string;
             headerCell: string;
             rowTextCell: string;
+            footerCell: string;
             columnTitleCell: string;
             cellRequiredText: string;
             button: string;
@@ -3580,6 +3588,8 @@ declare module "panel" {
         set questionErrorLocation(val: string);
         getQuestionErrorLocation(): string;
         get no(): string;
+        get cssError(): string;
+        protected getCssError(cssClasses: any): string;
         dispose(): void;
     }
     /**
@@ -3660,6 +3670,7 @@ declare module "panel" {
          */
         get no(): string;
         protected setNo(visibleIndex: number): void;
+        protected notifyStateChanged(): void;
         protected createLocTitleProperty(): LocalizableString;
         protected beforeSetVisibleIndex(index: number): number;
         protected getPanelStartIndex(index: number): number;
@@ -3692,7 +3703,6 @@ declare module "panel" {
         get hasEditButton(): boolean;
         cancelPreview(): void;
         get cssTitle(): string;
-        get cssError(): string;
         get showErrorsAbovePanel(): boolean;
         protected getCssError(cssClasses: any): string;
         protected onVisibleChanged(): void;
@@ -3700,6 +3710,7 @@ declare module "panel" {
         focusIn(): void;
         protected getHasFrameV2(): boolean;
         protected getIsNested(): boolean;
+        private get showPanelAsPage();
         protected getCssRoot(cssClasses: {
             [index: string]: string;
         }): string;
@@ -5732,9 +5743,9 @@ declare module "themes" {
          *
          * Possible values:
          *
-         * - `"survey"` (default)\
+         * - `"survey"`\
          * The header width is the same as the survey width.
-         * - `"container"`\
+         * - `"container"` (default)\
          * The header width is the same as the survey container width.
          *
          * @see [SurveyModel.width](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#width)
@@ -6970,9 +6981,9 @@ declare module "survey-events-api" {
     }
     export interface UploadFilesEvent extends LoadFilesEvent {
         /**
-         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the uploaded file's data if file upload was successful or an error message if file upload failed.
+         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass an array of successfully uploaded files as the first argument. As the second argument, you can pass an array of error messages if file upload failed.
          */
-        callback: (status: string, data?: any) => any;
+        callback: (data: any | Array<any>, errors?: any | Array<any>) => any;
         /**
          * An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
          */
@@ -7521,6 +7532,7 @@ declare module "page" {
         protected calcCssClasses(css: any): any;
         get cssTitle(): string;
         get cssRoot(): string;
+        protected getCssError(cssClasses: any): string;
         num: number;
         /**
          * Set this property to "hide" to make "Prev", "Next" and "Complete" buttons are invisible for this page. Set this property to "show" to make these buttons visible, even if survey showNavigationButtons property is false.
@@ -8398,6 +8410,7 @@ declare module "survey" {
     import { QuestionMultipleTextModel } from "question_multipletext";
     import { ITheme, ImageFit, ImageAttachment } from "themes";
     import { PopupModel } from "popup";
+    import { Cover } from "header";
     /**
      * The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
      *
@@ -9127,6 +9140,7 @@ declare module "survey" {
          * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
          */
         headerView: "advanced" | "basic";
+        protected insertAdvancedHeader(advHeader: Cover): void;
         private getNavigationCss;
         private lazyRenderingValue;
         showBrandInfo: boolean;
@@ -9322,7 +9336,8 @@ declare module "survey" {
          * Specifies whether to hide validation errors thrown by the Required validation in the UI.
          *
          * [Built-In Client-Side Validators](https://surveyjs.io/form-library/documentation/data-validation#built-in-client-side-validators (linkStyle))
-         * @see ignoreValidation
+         * @see validationEnabled
+         * @see validationAllowSwitchPages
          */
         hideRequiredErrors: boolean;
         beforeSettingQuestionErrors(question: Question, errors: Array<SurveyError>): void;
@@ -9395,6 +9410,10 @@ declare module "survey" {
          * - `"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.
          *
          * Refer to the following help topic for more information: [Data Validation](https://surveyjs.io/form-library/documentation/data-validation).
+         * @see validationEnabled
+         * @see validationAllowSwitchPages
+         * @see validationAllowComplete
+         * @see validate
          */
         get checkErrorsMode(): string;
         set checkErrorsMode(val: string);
@@ -10129,15 +10148,32 @@ declare module "survey" {
          */
         deleteCookie(): void;
         /**
-         * Specifies whether to skip validation when you switch between pages or complete the survey programmatically or when users do that in the UI.
+         * This property is obsolete. Use the [`validationEnabled`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#validationEnabled) property instead.
+         */
+        get ignoreValidation(): boolean;
+        set ignoreValidation(val: boolean);
+        /**
+         * Specifies whether data validation is enabled.
          *
-         * Default value: `false`
+         * Default value: `true`
+         * @see checkErrorsMode
          * @see hideRequiredErrors
-         * @see nextPage
-         * @see isPrevPage
-         * @see completeLastPage
          */
-        ignoreValidation: boolean;
+        validationEnabled: boolean;
+        /**
+         * Specifies whether respondents can switch the current page even if it contains validation errors.
+         *
+         * Default value: `false`
+         * @see checkErrorsMode
+         */
+        validationAllowSwitchPages: boolean;
+        /**
+         * Specifies whether respondents can end a survey with validation errors.
+         *
+         * Default value: `false`
+         * @see checkErrorsMode
+         */
+        validationAllowComplete: boolean;
         /**
          * Switches the survey to the next page.
          *
@@ -10485,11 +10521,11 @@ declare module "survey" {
          * @param question A [File Upload question instance](https://surveyjs.io/form-library/documentation/api-reference/file-model).
          * @param name The File Upload question's [`name`](https://surveyjs.io/form-library/documentation/api-reference/file-model#name).
          * @param files An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
-         * @param callback A callback function that allows you to get the upload status (`"success"` or `"error"`) and file data.
+         * @param callback A callback function that allows you to access successfully uploaded files as the first argument. If any files fail to upload, the second argument contains an array of error messages.
          * @see onUploadFiles
          * @see downloadFile
          */
-        uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (status: string, data: any) => any): void;
+        uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
         /**
          * Downloads a file from a server.
          *
@@ -10525,7 +10561,7 @@ declare module "survey" {
         updateChoicesFromServer(question: QuestionSelectBase, choices: Array<ItemValue>, serverResult: any): Array<ItemValue>;
         loadedChoicesFromServer(question: IQuestion): void;
         protected createSurveyService(): dxSurveyService;
-        protected uploadFilesCore(name: string, files: File[], uploadingCallback: (status: string, data: any) => any): void;
+        protected uploadFilesCore(name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
         getPage(index: number): PageModel;
         /**
          * Adds an existing page to the survey.
@@ -11028,6 +11064,7 @@ declare module "survey" {
         private isMovingQuestion;
         startMovingQuestion(): void;
         stopMovingQuestion(): void;
+        get isQuestionDragging(): boolean;
         private needRenderIcons;
         private skippedPages;
         /**
@@ -12179,6 +12216,8 @@ declare module "question" {
          * - `{row.other_question_name}` (to access questions inside the same dynamic matrix or multi-column dropdown)
          *
          * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Built-In Functions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#built-in-functions).
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/specify-default-question-value-dynamically (linkStyle))
          * @see defaultValue
          * @see setValueExpression
          */
@@ -13169,7 +13208,7 @@ declare module "base-interfaces" {
         maxTextLength: number;
         maxOthersLength: number;
         clearValueOnDisableItems: boolean;
-        uploadFiles(question: IQuestion, name: string, files: File[], uploadingCallback: (status: string, data: any) => any): any;
+        uploadFiles(question: IQuestion, name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): any;
         downloadFile(question: IQuestion, name: string, content: string, callback: (status: string, data: any) => any): any;
         clearFiles(question: IQuestion, name: string, value: any, fileName: string, clearCallback: (status: string, data: any) => any): any;
         updateChoicesFromServer(question: IQuestion, choices: Array<any>, serverResult: any): Array<any>;
@@ -13363,6 +13402,7 @@ declare module "base-interfaces" {
         component?: string;
         template?: string;
         data?: any;
+        index?: number;
         processResponsiveness?: (width: number) => void;
     }
     export interface IPlainDataOptions {
@@ -15532,7 +15572,13 @@ declare module "question_ranking" {
         set selectToRankAreasLayout(val: string);
         get renderedSelectToRankAreasLayout(): string;
         isMobileMode(): boolean;
+        /**
+         * A placeholder displayed in the area for ranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+         */
         selectToRankEmptyRankedAreaText: string;
+        /**
+         * A placeholder displayed in the area for unranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+         */
         selectToRankEmptyUnrankedAreaText: string;
         get useFullItemSizeForShortcut(): boolean;
         set useFullItemSizeForShortcut(val: boolean);
@@ -15782,6 +15828,7 @@ declare module "question_rating" {
         itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
         private createRenderedRateItems;
         renderedRateItems: Array<RenderedRatingItem>;
+        private createRateValues;
         private correctValue;
         getType(): string;
         protected getFirstInputElementId(): string;
@@ -24383,6 +24430,18 @@ declare module "react/components/rating/rating-item-smiley" {
         render(): JSX.Element | null;
     }
 }
+declare module "react/components/rating/rating-dropdown-item" {
+    import { SurveyElementBase } from "react/reactquestion_element";
+    interface IRatingItemProps {
+        item: any;
+    }
+    export class RatingDropdownItem extends SurveyElementBase<IRatingItemProps, any> {
+        get item(): any;
+        getStateElement(): any;
+        render(): JSX.Element | null;
+        renderDescription(item: any): JSX.Element;
+    }
+}
 declare module "react/tagbox-filter" {
     import { DropdownMultiSelectListModel, QuestionTagboxModel } from "entries/core";
     import { SurveyElementBase } from "react/reactquestion_element";
@@ -24912,6 +24971,7 @@ declare module "react/reactquestion_rating" {
 declare module "react/rating-dropdown" {
     import { QuestionRatingModel } from "entries/core";
     import { SurveyQuestionDropdownBase } from "react/dropdown-base";
+    export * from "react/components/rating/rating-dropdown-item";
     export class SurveyQuestionRatingDropdown extends SurveyQuestionDropdownBase<QuestionRatingModel> {
         constructor(props: any);
         protected renderElement(): JSX.Element;
@@ -25136,6 +25196,7 @@ declare module "entries/react-ui-model" {
     export { RatingItem } from "react/components/rating/rating-item";
     export { RatingItemStar } from "react/components/rating/rating-item-star";
     export { RatingItemSmiley } from "react/components/rating/rating-item-smiley";
+    export { RatingDropdownItem } from "react/components/rating/rating-dropdown-item";
     export { TagboxFilterString } from "react/tagbox-filter";
     export { SurveyQuestionOptionItem } from "react/dropdown-item";
     export { SurveyQuestionDropdownBase } from "react/dropdown-base";