survey-core 1.9.118 → 1.9.120

package/typings/survey.d.ts

@@ -25,6 +25,8 @@ import { QuestionFileModel } from "./question_file";
 import { QuestionMultipleTextModel } from "./question_multipletext";
 import { ITheme, ImageFit, ImageAttachment } from "./themes";
 import { PopupModel } from "./popup";
+import { Cover } from "./header";
+import { QuestionSignaturePadModel } from "./question_signaturepad";
 /**
  * The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
  *
@@ -319,6 +321,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * For information on event handler parameters, refer to descriptions within the interface.
      *
      * If you want to specify heading levels for all titles, use the [`titleTags`](https://surveyjs.io/form-library/documentation/api-reference/settings#titleTags) object in [global settings](https://surveyjs.io/form-library/documentation/api-reference/settings).
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/survey-titletagnames/ (linkStyle))
      * @see onGetQuestionTitle
      * @see onGetQuestionNo
      */
@@ -358,7 +362,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onGetResult: EventBase<SurveyModel, GetResultEvent>;
     /**
-     * An event that is raised when a File Upload question starts to upload a file. Applies only if [`storeDataAsText`](https://surveyjs.io/form-library/documentation/api-reference/file-model#storeDataAsText) is `false`. Use this event to upload files to your server.
+     * An event that is raised when a File Upload or Signature Pad question starts to upload a file. Applies only if [`storeDataAsText`](https://surveyjs.io/form-library/documentation/api-reference/file-model#storeDataAsText) is `false`. Use this event to upload files to your server.
      *
      * For information on event handler parameters, refer to descriptions within the interface.
      *
@@ -380,7 +384,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     onDownloadFile: EventBase<SurveyModel, DownloadFileEvent>;
     /**
-     * An event that is raised when users clear files in a [File Upload](https://surveyjs.io/form-library/documentation/api-reference/file-model) question. Use this event to delete files from your server.
+     * An event that is raised when users clear files in a [File Upload](https://surveyjs.io/form-library/documentation/api-reference/file-model) question or clear signature in a [Signature Pad](https://surveyjs.io/form-library/documentation/api-reference/signature-pad-model) question. Use this event to delete files from your server.
      *
      * For information on event handler parameters, refer to descriptions within the interface.
      *
@@ -754,6 +758,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * [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;
@@ -949,7 +954,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * 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;
@@ -1022,6 +1028,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"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);
@@ -1129,10 +1139,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     getSurveyErrorCustomText(obj: PanelModel | Question | SurveyModel, text: string, error: SurveyError): string;
     getQuestionDisplayValue(question: Question, displayValue: any): any;
     /**
-     * Returns a message that is displayed when a survey does not contain visible pages or questions.
+     * A message that is displayed when a survey does not contain visible pages or questions.
      * @see [Localization & Globalization](https://surveyjs.io/form-library/documentation/survey-localization)
      */
     get emptySurveyText(): string;
+    set emptySurveyText(val: string);
     /**
      * An image URL or a Base64-encoded image to use as a survey logo.
      *
@@ -1507,7 +1518,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @see setValue
      */
     mergeData(data: any): void;
-    setDataCore(data: any): void;
+    setDataCore(data: any, clearData?: boolean): void;
     getStructuredData(includePages?: boolean, level?: number): any;
     setStructuredData(data: any, doMerge?: boolean): void;
     private collectDataFromPanel;
@@ -1756,15 +1767,32 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     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.
      *
@@ -2109,14 +2137,14 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *   }
      * );
      * ```
-     * @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 question A [File Upload question instance](https://surveyjs.io/form-library/documentation/api-reference/file-model) or [Signature Pad question instance](https://surveyjs.io/form-library/documentation/api-reference/signature-pad-model).
+     * @param name The File Upload question's [`name`](https://surveyjs.io/form-library/documentation/api-reference/file-model#name) or Signature Pad question's [`name`](https://surveyjs.io/form-library/documentation/api-reference/signature-pad-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 | QuestionSignaturePadModel, name: string, files: File[], callback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
     /**
      * Downloads a file from a server.
      *
@@ -2148,11 +2176,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @see uploadFiles
      */
     downloadFile(question: QuestionFileModel, questionName: string, fileValue: any, callback: (status: string, data: any) => any): void;
-    clearFiles(question: QuestionFileModel, name: string, value: any, fileName: string, callback: (status: string, data: any) => any): void;
+    clearFiles(question: QuestionFileModel | QuestionSignaturePadModel, name: string, value: any, fileName: string, callback: (status: string, data: any) => any): void;
     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.
@@ -2655,6 +2683,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private isMovingQuestion;
     startMovingQuestion(): void;
     stopMovingQuestion(): void;
+    get isQuestionDragging(): boolean;
     private needRenderIcons;
     private skippedPages;
     /**
@@ -2713,6 +2742,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     applyTheme(theme: ITheme): void;
     themeChanged(theme: ITheme): void;
+    private taskManager;
     /**
      * Disposes of the survey model.
      *

package/typings/surveyStrings.d.ts

@@ -57,6 +57,7 @@ export declare var surveyStrings: {
     urlRequestError: string;
     urlGetChoicesError: string;
     exceedMaxSize: string;
+    noUploadFilesHandler: string;
     otherRequiredError: string;
     uploadingFile: string;
     loadingFile: string;

package/typings/surveyTaskManager.d.ts

@@ -0,0 +1,16 @@
+import { Base } from "./base";
+declare class SurveyTaskModel {
+    type: string;
+    private timestamp;
+    constructor(type: string);
+}
+export declare class SurveyTaskManagerModel extends Base {
+    private taskList;
+    constructor();
+    private onAllTasksCompleted;
+    hasActiveTasks: boolean;
+    runTask(type: string, func: (done: any) => void): SurveyTaskModel;
+    waitAndExecute(action: any): void;
+    private taskFinished;
+}
+export {};

package/typings/themes.d.ts

@@ -83,9 +83,9 @@ export interface IHeader {
      *
      * 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)