survey-react 1.9.128 → 1.9.129

package/survey.react.d.ts

@@ -816,7 +816,7 @@ declare module "popup-view-model" {
 declare module "utils/utils" {
     function compareVersions(a: any, b: any): number;
     function confirmAction(message: string): boolean;
-    function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void, locale?: string): void;
+    function confirmActionAsync(message: string, funcOnYes: () => void, funcOnNo?: () => void, locale?: string, rootElement?: HTMLElement): void;
     function detectIEBrowser(): boolean;
     function detectIEOrEdge(): boolean;
     function loadFileFromBase64(b64Data: string, fileName: string): void;
@@ -856,8 +856,9 @@ declare module "utils/utils" {
         log(action: string): void;
         get result(): string;
     }
-    export 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 function showConfirmDialog(message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string, rootElement?: HTMLElement): boolean;
+    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 };
 }
 declare module "actions/container" {
     import { Base } from "base";
@@ -2042,6 +2043,7 @@ declare module "defaultCss/defaultV2Css" {
         window: {
             root: string;
             rootCollapsedMod: string;
+            rootFullScreenMode: string;
             rootContent: string;
             body: string;
             header: {
@@ -2053,6 +2055,7 @@ declare module "defaultCss/defaultV2Css" {
                 buttonCollapsed: string;
                 collapseButton: string;
                 closeButton: string;
+                fullScreenButton: string;
             };
         };
         ranking: {
@@ -2746,6 +2749,7 @@ declare module "question_custom" {
         getDynamicType(): string;
         getOriginalObj(): Base;
         protected createWrapper(): void;
+        private getDynamicProperty;
         protected getElement(): SurveyElement;
         onAnyValueChanged(name: string, questionName: string): void;
         protected getQuestionByName(name: string): IQuestion;
@@ -2804,6 +2808,7 @@ declare module "question_custom" {
         protected getQuestionByName(name: string): IQuestion;
         private settingNewValue;
         setValue(name: string, newValue: any, locNotification: any, allowNotifyValueChanged?: boolean): any;
+        getFilteredValues(): any;
         private updateValueCoreWithPanelValue;
         private getContentPanelValue;
         private getValueForContentPanel;
@@ -3681,6 +3686,7 @@ declare module "question_file" {
          */
         get maxSize(): number;
         set maxSize(val: number);
+        chooseFile(): void;
         /**
          * Specifies whether users should confirm file deletion.
          *
@@ -5072,6 +5078,24 @@ declare module "question_matrixdropdowncolumn" {
          */
         get totalDisplayStyle(): string;
         set totalDisplayStyle(val: string);
+        /**
+         * An alignment for calculated total values.
+         *
+         * Possible values:
+         *
+         * - `"left"`
+         * - `"center"`
+         * - `"right"`
+         * - `"auto"` (default) - Applies one of the values above based on the column's [cell type](#cellType).
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/aggregate-data-within-form/ (linkStyle))
+         * @see totalType
+         * @see totalFormat
+         * @see totalCurrency
+         * @see totalDisplayStyle
+         */
+        get totalAlignment(): string;
+        set totalAlignment(val: string);
         /**
          * Specifies a currency used to display calculated total values. Applies only if [`totalDisplayStyle`](#totalDisplayStyle) is set to `"currency"`.
          * @see totalType
@@ -5309,6 +5333,7 @@ declare module "question_matrixdropdownrendered" {
         get isFirstChoice(): boolean;
         set className(val: string);
         get className(): string;
+        get cellQuestionWrapperClassName(): string;
         get headers(): string;
         getTitle(): string;
         calculateFinalClassName(matrixCssClasses: any): string;
@@ -7217,6 +7242,25 @@ declare module "survey-events-api" {
          */
         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.
@@ -8586,6 +8630,7 @@ declare module "header" {
         private updateContentClasses;
         private updateBackgroundImageClasses;
         fromTheme(theme: ITheme): void;
+        private init;
         constructor();
         getType(): string;
         cells: CoverCell[];
@@ -8596,6 +8641,8 @@ declare module "header" {
         textGlowEnabled: boolean;
         overlapEnabled: boolean;
         backgroundColor: string;
+        titleColor: string;
+        descriptionColor: string;
         backgroundImage: string;
         renderBackgroundImage: string;
         backgroundImageFit: "cover" | "fill" | "contain" | "tile";
@@ -8740,7 +8787,7 @@ declare module "survey" {
     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, ChoicesSearchEvent } 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";
@@ -9083,6 +9130,12 @@ declare module "survey" {
          * @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.
          *
@@ -10876,6 +10929,17 @@ declare module "survey" {
         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.
          *
@@ -13136,6 +13200,7 @@ declare module "question_matrixdropdownbase" {
         get question(): Question;
         get value(): any;
         set value(value: any);
+        getQuestionWrapperClassName(className: string): string;
         runCondition(values: HashTable<any>, properties: HashTable<any>): void;
     }
     export class MatrixDropdownTotalCell extends MatrixDropdownCell {
@@ -13146,6 +13211,7 @@ declare module "question_matrixdropdownbase" {
         protected createQuestion(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, data: IMatrixDropdownData): Question;
         locStrsChanged(): void;
         updateCellQuestion(): void;
+        getQuestionWrapperClassName(className: string): string;
         getTotalExpression(): string;
     }
     export class MatrixDropdownRowModelBase implements ISurveyData, ISurveyImpl, ILocalizableOwner {
@@ -13763,6 +13829,10 @@ declare module "base-interfaces" {
         elementContentVisibilityChanged(element: ISurveyElement): void;
         onCorrectQuestionAnswer(question: IQuestion, options: any): void;
         processPopupVisiblityChanged(question: IQuestion, popupModel: PopupModel, visible: boolean): void;
+        chooseFiles(input: HTMLInputElement, callback: (files: File[]) => void, context?: {
+            element: ISurveyElement;
+            item?: any;
+        }): void;
     }
     export interface ISurveyImpl {
         getSurveyData(): ISurveyData;
@@ -13999,6 +14069,7 @@ declare module "jsonobject" {
         onSettingValue: (obj: any, value: any) => any;
         onSetValue: (obj: any, value: any, jsonConv: JsonObject) => any;
         visibleIf: (obj: any) => boolean;
+        enableIf: (obj: any) => boolean;
         onExecuteExpression: (obj: any, res: any) => any;
         onPropertyEditorUpdate: (obj: any, propEditor: any) => any;
         constructor(classInfo: JsonMetadataClass, name: string, isRequired?: boolean);
@@ -14038,7 +14109,9 @@ declare module "jsonobject" {
         setBaseValue(val: any): void;
         get readOnly(): boolean;
         set readOnly(val: boolean);
+        isEnable(obj: any): boolean;
         isVisible(layout: string, obj?: any): boolean;
+        private getOriginalObj;
         get visible(): boolean;
         set visible(val: boolean);
         isAvailableInVersion(ver: string): boolean;
@@ -15013,7 +15086,7 @@ declare module "settings" {
          * @param message A message to be displayed in the confirm dialog window.
          * @param callback A callback function that should be called with `true` if a user confirms an action or `false` otherwise.
          */
-        confirmActionAsync: (message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string) => boolean;
+        confirmActionAsync: (message: string, callback: (res: boolean) => void, applyTitle?: string, locale?: string, rootElement?: HTMLElement) => boolean;
         /**
          * A minimum width value for all survey elements.
          *
@@ -15248,6 +15321,7 @@ declare module "dropdownListModel" {
         protected onSelectionChanged?: (item: IAction, ...params: any[]) => void;
         readonly minPageSize = 25;
         readonly loadingItemHeight = 40;
+        private htmlCleanerElement;
         private _markdownMode;
         private _popupModel;
         private filteredItems;
@@ -15284,6 +15358,7 @@ declare module "dropdownListModel" {
         showInputFieldComponent: boolean;
         ariaActivedescendant: string;
         private applyInputString;
+        private cleanHtml;
         protected fixInputCase(): void;
         protected applyHintString(item: ItemValue): void;
         get inputStringRendered(): string;
@@ -16965,6 +17040,8 @@ declare module "popup-survey" {
          */
         get isShowing(): boolean;
         set isShowing(val: boolean);
+        get isFullScreen(): boolean;
+        set isFullScreen(val: boolean);
         /**
          * Shows the pop-up survey. The survey may appear [expanded or collapsed](#isExpanded).
          *
@@ -16981,6 +17058,7 @@ declare module "popup-survey" {
          * @see collapse
          */
         hide(): void;
+        toggleFullScreen(): void;
         /**
          * Indicates whether the pop-up window is expanded or collapsed.
          *
@@ -17024,6 +17102,14 @@ declare module "popup-survey" {
          */
         get allowClose(): boolean;
         set allowClose(val: boolean);
+        /**
+         * Specifies whether to display a button that allow showing pop-up in full-screen mode.
+         *
+         * Default value: `false`
+         *
+         */
+        get allowFullScreen(): boolean;
+        set allowFullScreen(val: boolean);
         get css(): any;
         get cssButton(): string;
         get cssRoot(): string;
@@ -17035,9 +17121,11 @@ declare module "popup-survey" {
         get cssHeaderButtonsContainer(): string;
         get cssHeaderCollapseButton(): string;
         get cssHeaderCloseButton(): string;
+        get cssHeaderFullScreenButton(): string;
         get renderedWidth(): string;
         width: string;
         private updateCss;
+        private setCssRoot;
         private updateCssButton;
         private setCssButton;
         protected createSurvey(jsonObj: any): SurveyModel;
@@ -17253,7 +17341,7 @@ declare module "entries/chunks/model" {
     export { DropdownMultiSelectListModel } from "dropdownMultiSelectListModel";
     export { QuestionButtonGroupModel, ButtonGroupItemModel, ButtonGroupItemValue } from "question_buttongroup";
     export { IsMobile, IsTouch, _setIsTouch } from "utils/devices";
-    export { confirmAction, confirmActionAsync, detectIEOrEdge, doKey2ClickUp, doKey2ClickDown, doKey2ClickBlur, loadFileFromBase64, increaseHeightByContent, createSvg, sanitizeEditableContent, IAttachKey2clickOptions } from "utils/utils";
+    export { confirmAction, confirmActionAsync, detectIEOrEdge, doKey2ClickUp, doKey2ClickDown, doKey2ClickBlur, loadFileFromBase64, increaseHeightByContent, createSvg, chooseFiles, sanitizeEditableContent, IAttachKey2clickOptions } from "utils/utils";
     export * from "utils/cssClassBuilder";
     export { surveyCss, defaultV2Css, defaultV2ThemeName } from "defaultCss/defaultV2Css";
     export { DragDropCore } from "dragdrop/core";
@@ -17623,6 +17711,7 @@ declare module "defaultCss/cssstandard" {
         window: {
             root: string;
             rootCollapsedMod: string;
+            rootFullScreenMode: string;
             rootContent: string;
             body: string;
             header: {
@@ -17634,6 +17723,7 @@ declare module "defaultCss/cssstandard" {
                 buttonCollapsed: string;
                 collapseButton: string;
                 closeButton: string;
+                fullScreenButton: string;
             };
         };
         variables: {
@@ -18093,6 +18183,7 @@ declare module "defaultCss/cssmodern" {
         window: {
             root: string;
             rootCollapsedMod: string;
+            rootFullScreenMode: string;
             rootContent: string;
             body: string;
             header: {
@@ -18104,6 +18195,7 @@ declare module "defaultCss/cssmodern" {
                 buttonCollapsed: string;
                 collapseButton: string;
                 closeButton: string;
+                fullScreenButton: string;
             };
         };
         variables: {
@@ -26005,6 +26097,7 @@ declare module "react/react-popup-survey" {
         protected renderExpandIcon(): JSX.Element;
         protected renderCollapseIcon(): JSX.Element;
         protected renderCloseButton(popup: PopupSurveyModel): JSX.Element;
+        protected renderAllowFullScreenButon(popup: PopupSurveyModel): JSX.Element;
         protected renderBody(): JSX.Element;
         protected createSurvey(newProps: any): void;
     }