survey-core 1.9.127 → 1.9.129

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

@@ -508,6 +508,25 @@ export interface UploadFilesEvent extends LoadFilesEvent {
      */
     files: Array<File>;
 }
+export interface OpenFileChooserEvent {
+    /**
+     * A file input HTML element.
+     */
+    input: HTMLInputElement;
+    /**
+     * A question, panel, page, or survey for which this event is raised.
+     */
+    element: Base;
+    /**
+     * A choice item for which the event is raised. This parameter has a value only when the dialog window is opened to select images for an [Image Picker](https://surveyjs.io/form-library/documentation/api-reference/image-picker-question-model) question.
+     */
+    item: ItemValue;
+    /**
+     * A callback function to which you should pass selected files.
+     * @param files An array of selected files.
+     */
+    callback: (files: Array<File>) => void;
+}
 export interface DownloadFileEvent extends LoadFilesEvent {
     /**
      * A callback function that you should call when a file is downloaded successfully or when deletion fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the downloaded file's data as a Base64 string if file download was successful or an error message if file download failed.
@@ -628,6 +647,20 @@ export interface ChoicesLazyLoadEvent extends QuestionEventMixin {
      */
     skip: number;
 }
+export interface ChoicesSearchEvent extends QuestionEventMixin {
+    /**
+     * A search string used to filter choice options.
+     */
+    filter: string;
+    /**
+     * An array of all choice options.
+     */
+    choices: Array<ItemValue>;
+    /**
+     * A filtered array of choice options. Apply `options.filter` to the `options.choices` array and assign the result to this parameter.
+     */
+    filteredChoices: Array<ItemValue>;
+}
 export interface GetChoiceDisplayValueEvent extends QuestionEventMixin {
     /**
      * A method that you should call to assign display texts to the question.

package/typings/survey.d.ts

@@ -18,7 +18,7 @@ import { IAction, Action } from "./actions/action";
 import { ActionContainer } from "./actions/container";
 import { QuestionPanelDynamicModel } from "./question_paneldynamic";
 import { Notifier } from "./notifier";
-import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNoEvent, ProgressTextEvent, TextMarkdownEvent, TextRenderAsEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderHeaderEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent } from "./survey-events-api";
+import { TriggerExecutedEvent, CompletingEvent, CompleteEvent, ShowingPreviewEvent, NavigateToUrlEvent, CurrentPageChangingEvent, CurrentPageChangedEvent, ValueChangingEvent, ValueChangedEvent, VariableChangedEvent, QuestionVisibleChangedEvent, PageVisibleChangedEvent, PanelVisibleChangedEvent, QuestionCreatedEvent, QuestionAddedEvent, QuestionRemovedEvent, PanelAddedEvent, PanelRemovedEvent, PageAddedEvent, ValidateQuestionEvent, SettingQuestionErrorsEvent, ValidatePanelEvent, ErrorCustomTextEvent, ValidatedErrorsOnCurrentPageEvent, ProcessHtmlEvent, GetQuestionTitleEvent, GetTitleTagNameEvent, GetQuestionNoEvent, ProgressTextEvent, TextMarkdownEvent, TextRenderAsEvent, SendResultEvent, GetResultEvent, UploadFilesEvent, DownloadFileEvent, ClearFilesEvent, LoadChoicesFromServerEvent, ProcessTextValueEvent, UpdateQuestionCssClassesEvent, UpdatePanelCssClassesEvent, UpdatePageCssClassesEvent, UpdateChoiceItemCssEvent, AfterRenderSurveyEvent, AfterRenderHeaderEvent, AfterRenderPageEvent, AfterRenderQuestionEvent, AfterRenderQuestionInputEvent, AfterRenderPanelEvent, FocusInQuestionEvent, FocusInPanelEvent, ShowingChoiceItemEvent, ChoicesLazyLoadEvent, GetChoiceDisplayValueEvent, MatrixRowAddedEvent, MatrixBeforeRowAddedEvent, MatrixRowRemovingEvent, MatrixRowRemovedEvent, MatrixAllowRemoveRowEvent, MatrixCellCreatingEvent, MatrixCellCreatedEvent, MatrixAfterCellRenderEvent, MatrixCellValueChangedEvent, MatrixCellValueChangingEvent, MatrixCellValidateEvent, DynamicPanelModifiedEvent, DynamicPanelRemovingEvent, TimerPanelInfoTextEvent, DynamicPanelItemValueChangedEvent, DynamicPanelGetTabTitleEvent, DynamicPanelCurrentIndexChangedEvent, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent, ChoicesSearchEvent, OpenFileChooserEvent } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -361,6 +361,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @see getResult
      */
     onGetResult: EventBase<SurveyModel, GetResultEvent>;
+    /**
+     * An event that is raised when Survey Creator opens a dialog window for users to select files.
+     * @see onUploadFile
+     * @see uploadFiles
+     */
+    onOpenFileChooser: EventBase<SurveyModel, OpenFileChooserEvent>;
     /**
      * 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.
      *
@@ -514,6 +520,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * [View Demo](https://surveyjs.io/form-library/examples/lazy-loading-dropdown/ (linkStyle))
      */
     onChoicesLazyLoad: EventBase<SurveyModel, ChoicesLazyLoadEvent>;
+    /**
+     * An event that is raised each time a search string in a [Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) or [Tag Box](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) question changes. Use this event to implement custom filtering of choice options.
+     * @see [QuestionDropdownModel.searchEnabled](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model#searchEnabled)
+     * @see [QuestionDropdownModel.searchMode](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model#searchMode)
+     */
+    onChoicesSearch: EventBase<SurveyModel, ChoicesSearchEvent>;
     /**
      * Use this event to load a display text for the [default choice item](https://surveyjs.io/form-library/documentation/questiondropdownmodel#defaultValue) in [Dropdown](https://surveyjs.io/form-library/documentation/questiondropdownmodel) and [Tag Box](https://surveyjs.io/form-library/documentation/questiontagboxmodel) questions.
      *
@@ -749,17 +761,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     containerCss: string;
     fitToContainer: boolean;
     /**
-     * Specifies whether the survey header uses only basic appearance settings or applies advanced settings from the survey theme.
-     *
-     * Possible values:
-     *
-     * - `"basic"` (default)\
-     * A basic header view applies only the [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title), [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description), and logo-related properties ([`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo), [`logoPosition`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logoPosition), etc.).
-     *
-     * - `"advanced"`\
-     * An advanced header view applies the same properties as the basic view, plus [header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader) from the [survey theme](https://surveyjs.io/form-library/documentation/api-reference/itheme#header). The advanced view features a more flexible header layout, a capability to specify a background image, and other settings that give a more professional look to the survey header.
-     *
-     * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
+     * This property is obsolete. Use the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property within a theme instead.
      */
     headerView: "advanced" | "basic";
     protected insertAdvancedHeader(advHeader: Cover): void;
@@ -1420,15 +1422,21 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     get showQuestionNumbers(): string | boolean;
     set showQuestionNumbers(value: string | boolean);
+    private progressBarValue;
+    get progressBar(): any;
     /**
      * Controls the visibility of the progress bar and specifies its position.
      *
      * Possible values:
      *
      * - `"off"` (default) - Hides the progress bar.
-     * - `"top"` - Displays the progress bar above survey content.
+     * - `"aboveHeader"` - Displays the progress bar above the survey header.
+     * - `"belowHeader"` - Displays the progress bar below the survey header.
      * - `"bottom"` - Displays the progress bar below survey content.
-     * - `"both"` - Displays the progress bar above and below survey content.
+     * - `"topBottom"` - Displays the progress bar above and below survey content.
+     * - `"auto"` - Automatically selects between `"aboveHeader"` and `"belowHeader"`.
+     * - `"top"` - *(Obsolete)* Use the `"aboveHeader"` or `"belowHeader"` property value instead.
+     * - `"both"` - *(Obsolete)* Use the `"topBottom"` property value instead.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/navigation-default/ (linkStyle))
      * @see progressBarType
@@ -1445,13 +1453,30 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"questions"` - The number of answered questions.
      * - `"requiredQuestions"` - The number of answered [required questions](https://surveyjs.io/form-library/documentation/api-reference/question#isRequired).
      * - `"correctQuestions"` - The number of correct questions in a [quiz](https://surveyjs.io/form-library/documentation/design-survey/create-a-quiz).
-     * - `"buttons"` - Adds jump links to the progress bar.
+     * - `"buttons"` - *(Obsolete)* Use the `"pages"` property value with the [`progressBarShowPageTitles`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageTitles) property set to `true` instead.
+     *
+     * > When `progressBarType` is set to `"pages"`, you can also enable the [`progressBarShowPageNumbers`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageNumbers) and [`progressBarShowPageTitles`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarShowPageTitles) properties if you want to display page numbers and titles in the progress bar.
      *
      * [View Demo](https://surveyjs.io/form-library/examples/navigation-buttons/ (linkStyle))
      * @see progressValue
      */
     get progressBarType(): string;
     set progressBarType(newValue: string);
+    private get progressBarComponentName();
+    /**
+     * Specifies whether the progress bar displays page titles. Applies only when the [progress bar is visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showProgressBar) and [`progressBarType`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarType) is `"pages"`.
+     *
+     * Default value: `false`
+     * @see progressBarShowPageNumbers
+     */
+    progressBarShowPageTitles: boolean;
+    /**
+     * Specifies whether the progress bar displays page numbers. Applies only when the [progress bar is visible](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#showProgressBar) and [`progressBarType`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#progressBarType) is `"pages"`.
+     *
+     * Default value: `false`
+     * @see progressBarShowPageTitles
+     */
+    progressBarShowPageNumbers: boolean;
     get isShowProgressBarOnTop(): boolean;
     get isShowProgressBarOnBottom(): boolean;
     getProgressTypeComponent(): string;
@@ -2135,6 +2160,17 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private getUpdatedPageTitleActions;
     getUpdatedMatrixRowActions(question: QuestionMatrixDropdownModelBase, row: any, actions: Array<IAction>): IAction[];
     scrollElementToTop(element: ISurveyElement, question: Question, page: PageModel, id: string, scrollIfVisible?: boolean): any;
+    /**
+     * Opens a dialog window for users to select files.
+     * @param input A [file input HTML element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement).
+     * @param callback A callback function that you can use to process selected files. Accepts an array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects.
+     * @see onOpenFileChooser
+     * @see onUploadFile
+     */
+    chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void, context?: {
+        element: ISurveyElement;
+        item?: any;
+    }): void;
     /**
      * Uploads files to a server.
      *
@@ -2355,6 +2391,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private conditionRunnerCounter;
     private conditionUpdateVisibleIndexes;
     private conditionNotifyElementsOnAnyValueOrVariableChanged;
+    /**
+     * Recalculates all [expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions) in the survey.
+     */
+    runExpressions(): void;
     private runConditions;
     private runConditionOnValueChanged;
     private runConditionsCore;
@@ -2386,6 +2426,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private updateVisibleIndexes;
     private updatePageVisibleIndexes;
     fromJSON(json: any, options?: ILoadFromJSONOptions): void;
+    startLoadingFromJson(json?: any): void;
     setJsonObject(jsonObj: any): void;
     private isEndLoadingFromJson;
     endLoadingFromJson(): void;
@@ -2730,7 +2771,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * This method accepts an object with the following layout element properties:
      *
-     * - `id`: `string` | `"timerpanel"` | `"progress-buttons"` | `"progress-questions"` | `"progress-pages"` | `"progress-correctquestions"` | `"progress-requiredquestions"` | `"toc-navigation"` | `"navigationbuttons"`\
+     * - `id`: `string` | `"timerpanel"` | `"progress-buttons"` | `"progress-questions"` | `"progress-pages"` | `"progress-correctquestions"` | `"progress-requiredquestions"` | `"toc-navigation"` | `"buttons-navigation"`\
      * A layout element identifier. You can use possible values to access and relocate or customize predefined layout elements.
      *
      * - `container`: `"header"` | `"footer"` | `"left"` | `"right"` | `"contentTop"` | `"contentBottom"`\

package/typings/surveyProgressButtons.d.ts

@@ -1,9 +1,9 @@
-import { SurveyModel } from "./survey";
-export declare class SurveyProgressButtonsModel {
-    private survey;
-    constructor(survey: SurveyModel);
-    isListElementClickable(index: number): boolean;
-    getListElementCss(index: number): string;
-    getScrollButtonCss(hasScroller: boolean, isLeftScroll: boolean): string;
-    clickListElement(index: number): void;
-}
+import { SurveyModel } from "./survey";
+export declare class SurveyProgressButtonsModel {
+    private survey;
+    constructor(survey: SurveyModel);
+    isListElementClickable(index: number): boolean;
+    getListElementCss(index: number): string;
+    getScrollButtonCss(hasScroller: boolean, isLeftScroll: boolean): string;
+    clickListElement(index: number): void;
+}

package/typings/surveyStrings.d.ts

@@ -24,6 +24,8 @@ export declare var surveyStrings: {
     startSurveyText: string;
     otherItemText: string;
     noneItemText: string;
+    refuseItemText: string;
+    dontKnowItemText: string;
     selectAllItemText: string;
     progressText: string;
     indexText: string;

package/typings/themes.d.ts

@@ -56,7 +56,7 @@ export interface ITheme {
      */
     backgroundOpacity?: number;
     /**
-     * An object with [advanced survey header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader). Applies when `SurveyModel`'s [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#headerView) property is set to `"advanced"`.
+     * An object with [advanced survey header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader). Applies when the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property is set to `"advanced"`.
      */
     header?: IHeader;
     /**
@@ -83,7 +83,7 @@ export interface ITheme {
 /**
  * A survey header configuration interface.
  *
- * An `IHeader` object configures advanced survey header appearance settings. To apply them, you need to assign the object to the [`header`](https://surveyjs.io/form-library/documentation/api-reference/itheme#header) property of your theme configuration and set `SurveyModel`'s [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#headerView) property to `"advanced"`.
+ * An `IHeader` object configures advanced survey header appearance settings. To apply them, you need to assign the object to the [`header`](https://surveyjs.io/form-library/documentation/api-reference/itheme#header) property of your theme configuration and set the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property to `"advanced"`.
  */
 export interface IHeader {
     /**

package/typings/utils/utils.d.ts

@@ -1,6 +1,6 @@
 declare function compareVersions(a: any, b: any): number;
 declare function confirmAction(message: string): boolean;
-declare function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void, locale?: string): void;
+declare function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void, locale?: string, rootElement?: HTMLElement): void;
 declare function detectIEBrowser(): boolean;
 declare function detectIEOrEdge(): boolean;
 declare function loadFileFromBase64(b64Data: string, fileName: string): void;
@@ -40,5 +40,6 @@ export declare class Logger {
     log(action: string): void;
     get result(): string;
 }
-export declare function showConfirmDialog(message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string): boolean;
-export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, };
+export declare function showConfirmDialog(message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string, rootElement?: HTMLElement): boolean;
+declare function chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void): void;
+export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, chooseFiles };