survey-react 1.9.22 → 1.9.25

package/survey.react.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library for React v1.9.22
+* Type definition for Survey JavaScript library for React v1.9.25
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -91,124 +91,99 @@ export interface IExpresionExecutor {
   * This call back runs on executing expression if there is at least one async function
   */
   onComplete: any;
-  /*
-  * The expression as string, property with get/set
-  */
-  expression: string;
-  /*
-  * Returns true if the expression is valid and can be executed
-  */
-  canRun(): boolean;
-  /*
-  * Run the expression. Returns the result of execution.
-  * The result can be undefined if there is an asyn function. In this case result will be returned onComplete callback.
-  */
-  run(values: any, properties: any): any;
-  /*
-  * Returns the list of variables that used in the expression. They defined as: {variableName} in default parser.
-  */
-  getVariables(): Array<any>;
-  /*
-  * Returns true if there is a function in the expression
-  */
-  hasFunction(): boolean;
-  /*
-  * Returns true if there is an async function in the expression
-  */
-  isAsync: boolean;
 }
 /*
-* Defines an individual action. Action items can be displayed in certain survey elements - in Toolbar (or action bar), in titles (of pages, panels, questions), in matrix rows (as 'expand details' or 'remove row' buttons), and etc.
+* An action item.
+* Action items are used in the Toolbar, matrix rows, titles of pages, panels, questions, and other survey elements.
 */
 export interface IAction {
   /*
-  * Unique string id
+  * A unique action item identifier.
   */
   id: string;
   /*
-  * Set this property to false to make the toolbar item invisible.
+  * Specifies the action item's visibility.
   */
   visible?: boolean;
   /*
-  * Toolbar item title
+  * The action item's title.
   */
   title?: string;
   /*
-  * Toolbar item tooltip
+  * The action item's tooltip.
   */
   tooltip?: string;
   /*
-  * Set this property to false to disable the toolbar item.
+  * Specifies whether users can interact with the action item.
   */
   enabled?: boolean;
   /*
-  * Set this property to false to hide the toolbar item title.
+  * Specifies the visibility of the action item's title.
   */
   showTitle?: boolean;
   /*
-  * A callback that calls on toolbar item click.
+  * A function that is executed when users click the action item.
   */
   action?: any;
   /*
-  * Toolbar item css class
+  * One or several CSS classes that you want to apply to the outer `<div>` element.
+  * In the markup, an action item is rendered as an `<input>` wrapped in a `<div>`. The `css` property applies classes to the `<div>`.
+  * To apply several classes, separate them with a space character: "myclass1 myclass2".
   */
   css?: string;
   /*
-  * Toolbar inner element css class
+  * One or several CSS classes that you want to apply to the inner `<input>` element.
+  * In the markup, an action item is rendered as an `<input>` wrapped in a `<div>`. The `innerCss` property applies classes to the `<input>`.
+  * To apply several classes, separate them with a space character: "myclass1 myclass2".
   */
   innerCss?: string;
   /*
-  * Toolbar item data object. Used as data for custom template or component rendering
+  * The action item's data object. Use it to pass required data to a custom template or component.
   */
   data?: any;
   popupModel?: any;
   needSeparator?: boolean;
   /*
-  * Set this property to true to activate the toolbar item (page)
+  * Specifies whether the action item is active.
+  * Use it as a flag to specify different action item appearances in different states.
   */
   active?: boolean;
   pressed?: boolean;
   /*
-  * Toolbar item template name
+  * Specifies the name of a template used to render the action item.
   */
   template?: string;
   /*
-  * Toolbar item component name
+  * Specifies the name of a component used to render the action item.
   */
   component?: string;
   /*
-  * Toolbar item icon name
+  * The action item's icon name.
   */
   iconName?: string;
   /*
-  * Toolbar item icon size
+  * The action item's icon size in pixels.
   */
   iconSize?: number;
   /*
-  * Toolbar item child items. Can be used as contianer for options
-  */
-  items?: any;
-  /*
-  * Gets or sets an action's location in a matrix question's row.
+  * The action item's location in a matrix question's row.
   * 
-  * The following options are available:
+  * The following values are available:
   * 
-  * - `start` - An action is located at the beginning of a row.
-  * - `end` - An action is located at the end of a row.
+  * - `"start"` - The action item is located at the beginning of the row.
+  * - `"end"` - The action is located at the end of the row.
   */
   location?: string;
   /*
-  * Set it to true to make the tabIndex -1 to disable keyboard navigation to this item
+  * Set this property to `true` if you want to disable keyboard navigation for the action item (sets the `tabIndex` attribute to -1).
   */
   disableTabStop?: boolean;
   /*
-  * Set it to false to force action "large" mode even if has icon and does not fit to action bar space
+  * Set this property to `true` if you want the item's `title` to be always visible.
+  * If you set it to `false`, the `title` hides when the screen space is limited, and the item displays only the icon.
   */
   disableShrink?: boolean;
-  /*
-  * Action button display mode
-  */
-  mode?: "popup" | "large" | "small";
+  mode?: any;
   visibleIndex?: number;
   needSpace?: boolean;
 }
@@ -1122,6 +1097,7 @@ export declare class OperandMaker {
   static signs: any;
 }
 export declare class PopupUtils {
+  static bottomIndent: number;
   static calculatePosition(targetRect: any, height: number, width: number, verticalPosition: any, horizontalPosition: any, showPointer: boolean): INumberPosition;
   static updateVerticalDimensions(top: number, height: number, windowHeight: number): any;
   static updateHorizontalDimensions(left: number, width: number, windowWidth: number, horizontalPosition: any): any;
@@ -1295,7 +1271,7 @@ export declare class SurveyElementBase<P, S> extends React.Component<P, S> {
   render(): any;
   protected wrapElement(element: any): any;
   protected get isRendering(): boolean;
-  protected getRenderedElement(): Base;
+  protected getRenderedElements(): Array<Base>;
   protected canRender(): boolean;
   protected renderElement(): any;
   protected get changedStatePropName(): string;
@@ -1492,7 +1468,7 @@ export declare class Action extends Base implements IAction {
   component: string;
   items: any;
   visibleIndex: number;
-  mode: "popup" | "large" | "small";
+  mode: any;
   disableTabStop: boolean;
   disableShrink: boolean;
   needSpace: boolean;
@@ -1524,9 +1500,11 @@ export declare class ActionContainer<T extends Action = Action> extends Base {
   get visibleActions(): any;
   getRootCss(): string;
   get cssClasses(): any;
+  addAction(val: IAction, sortByVisibleIndex?: boolean): Action;
   setItems(items: any, sortByVisibleIndex?: boolean): void;
   initResponsivityManager(container: any): void;
   resetResponsivityManager(): void;
+  getActionById(id: string): T;
 }
 export declare class AnswerRequiredError extends SurveyError {
   constructor(text?: string, errorOwner?: ISurveyErrorOwner);
@@ -1766,6 +1744,7 @@ export declare class ExceedSizeError extends SurveyError {
   getDefaultText(): string;
 }
 export declare class ExpressionExecutor implements IExpresionExecutor {
+  constructor(expression: string);
   static createExpressionExecutor: any;
   onComplete: any;
   expressionValue: string;
@@ -1776,7 +1755,6 @@ export declare class ExpressionExecutor implements IExpresionExecutor {
   hasFunctionValue: boolean;
   asyncFuncList: any;
   get expression(): string;
-  set expression(val: string);
   getVariables(): Array<any>;
   hasFunction(): boolean;
   get isAsync(): boolean;
@@ -2040,6 +2018,7 @@ export declare class LocalizableString implements ILocalizableString {
   localizationName: string;
   onGetTextCallback: any;
   onGetDefaultTextCallback: any;
+  onGetLocalizationTextCallback: any;
   onStrChanged: any;
   onSearchChanged: any;
   sharedData: LocalizableString;
@@ -2188,7 +2167,7 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
   updateCellQuestion(cellQuestion: Question, data: any, onUpdateJson?: any): void;
   defaultCellTypeChanged(): void;
   protected calcCellQuestionType(row: MatrixDropdownRowModelBase): string;
-  protected updateTemplateQuestion(): void;
+  protected updateTemplateQuestion(newCellType?: string): void;
   protected createNewQuestion(cellType: string): Question;
   previousChoicesId: string;
   protected setQuestionProperties(question: Question, onUpdateJson?: any): void;
@@ -2751,18 +2730,6 @@ export declare class SurveyElementCore extends Base implements ILocalizableOwner
   getRendererContext(locStr: LocalizableString): any;
   getProcessedText(text: string): string;
 }
-export declare class SurveyNavigation extends SurveyNavigationBase {
-  constructor(props: any);
-  handlePrevClick(event: any): void;
-  handleNextClick(event: any): void;
-  handleNextMouseDown(event: any): any;
-  handleMouseDown(event: any): any;
-  handleCompleteClick(event: any): void;
-  handlePreviewClick(event: any): void;
-  handleStartClick(event: any): void;
-  render(): any;
-  protected renderButton(click: any, mouseDown: any, text: string, btnClassName: string): any;
-}
 export declare class SurveyPanelBase extends SurveyElementBase<any, any> {
   constructor(props: any);
   protected rootRef: any;
@@ -2835,7 +2802,7 @@ export declare class SurveyQuestionElementBase extends SurveyElementBase<any, an
   componentWillUnmount(): void;
   protected updateDomElement(): void;
   protected get questionBase(): any;
-  protected getRenderedElement(): Base;
+  protected getRenderedElements(): Array<Base>;
   protected get creator(): ISurveyCreator;
   protected canRender(): boolean;
   shouldComponentUpdate(nextProps: any, nextState: any): boolean;
@@ -3027,13 +2994,16 @@ export declare class AdaptiveActionContainer<T extends Action = Action> extends
   protected dotsItemPopupModel: any;
   responsivityManager: ResponsivityManager;
   minVisibleItemsCount: number;
+  isResponsivenessDisabled: boolean;
   protected invisibleItemsListModel: ListModel;
   protected onSet(): void;
   protected onPush(item: T): void;
   protected getRenderedActions(): Array<T>;
+  protected raiseUpdate(isResetInitialized: boolean): void;
   fit(dimension: number, dotsItemSize: number): void;
   initResponsivityManager(container: any): void;
   resetResponsivityManager(): void;
+  setActionsMode(mode: any): void;
   dispose(): void;
 }
 export declare class AnswerCountValidator extends SurveyValidator {
@@ -3184,6 +3154,7 @@ export declare class ImageItemValue extends ItemValue implements ILocalizableOwn
   */
   get imageLink(): string;
   set imageLink(val: string);
+  aspectRatio: number;
   get locImageLink(): LocalizableString;
   getLocale(): string;
   getMarkdownHtml(text: string, name: string): string;
@@ -3555,6 +3526,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   localeValue: string;
   textPreProcessor: TextPreProcessor;
   timerModelValue: SurveyTimerModel;
+  navigationBarValue: any;
   /*
   * The event is fired before the survey is completed and the `onComplete` event is fired. You can prevent the survey from completing by setting `options.allowComplete` to `false`
   * <br/> `sender` - the survey object that fires the event.
@@ -4216,7 +4188,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   get cssNavigationStart(): string;
   get cssNavigationNext(): string;
   get bodyCss(): string;
-  get completedCss(): string;
+  completedCss: string;
+  containerCss: string;
   get completedStateCss(): string;
   getCompletedStateCss(): string;
   lazyRenderingValue: boolean;
@@ -4528,6 +4501,16 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   set loadingHtml(val: string);
   get locLoadingHtml(): LocalizableString;
   /*
+  * Default value for loadingHtml property
+  */
+  get defaultLoadingHtml(): string;
+  get navigationBar(): any;
+  /*
+  * Adds a custom navigation item similar to the Previous Page, Next Page, and Complete buttons.
+  * Accepts an object described in the [IAction](https://surveyjs.io/Documentation/Library?id=IAction) help section.
+  */
+  addNavigationItem(val: IAction): Action;
+  /*
   * Gets or sets the 'Start' button caption.
   * The 'Start' button is shown on the started page. Set the `firstPageIsStarted` property to `true`, to display the started page.
   */
@@ -5018,6 +5001,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   isCalculatingProgressText: boolean;
   updateProgressText(onValueChanged?: boolean): void;
   getProgressText(): string;
+  rootCss: string;
   getRootCss(): string;
   resizeObserver: any;
   afterRenderSurvey(htmlElement: any): void;
@@ -5172,6 +5156,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   setJsonObject(jsonObj: any): void;
   isEndLoadingFromJson: string;
   endLoadingFromJson(): void;
+  updateNavigationItemTitlesCallback: any;
+  updateNavigationItemCssCallback: any;
+  protected createNavigationBar(): ActionContainer;
+  protected createNavigationActions(): Array<IAction>;
   protected onBeforeCreating(): void;
   protected onCreating(): void;
   getBuiltInVariableValue(name: string): number;
@@ -5359,6 +5347,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   dispose(): void;
   disposeCallback: any;
 }
+export declare class SurveyNavigationButton extends ReactSurveyElement {
+  constructor(props: any);
+  protected get item(): Action;
+  protected canRender(): boolean;
+  protected renderElement(): any;
+}
 export declare class SurveyPage extends SurveyPanelBase {
   constructor(props: any);
   protected getPanelBase(): PanelModelBase;
@@ -5488,12 +5482,24 @@ export declare class SurveyQuestionImage extends SurveyQuestionElementBase {
 export declare class SurveyQuestionImagePicker extends SurveyQuestionElementBase {
   constructor(props: any);
   protected get question(): any;
-  handleOnChange(event: any): void;
   protected renderElement(): any;
+  protected getColumns(cssClasses: any): any;
   protected getItems(cssClasses: any): Array<any>;
   protected get textStyle(): any;
   protected renderItem(key: string, item: any, cssClasses: any): any;
 }
+export declare class SurveyQuestionImagePickerItem extends ReactSurveyElement {
+  constructor(props: any);
+  protected getStateElement(): any;
+  componentDidMount(): void;
+  componentWillUnmount(): void;
+  componentDidUpdate(prevProps: any, prevState: any): void;
+  protected get cssClasses(): any;
+  protected get item(): any;
+  protected get question(): any;
+  handleOnChange(event: any): void;
+  protected renderElement(): any;
+}
 export declare class SurveyQuestionMatrix extends SurveyQuestionElementBase {
   constructor(props: any);
   protected get question(): any;
@@ -6437,9 +6443,10 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   getQuestionFromArray(name: string, index: number): IQuestion;
   getDefaultValue(): any;
   protected isDefaultValueEmpty(): boolean;
+  protected getDefaultRunner(runner: ExpressionRunner, expression: string): ExpressionRunner;
   protected setDefaultValue(): void;
   protected isValueExpression(val: any): boolean;
-  protected setValueAndRunExpression(expression: string, defaultValue: any, setFunc: any, values?: any, properties?: any): void;
+  protected setValueAndRunExpression(runner: ExpressionRunner, defaultValue: any, setFunc: any, values?: any, properties?: any): void;
   /*
   * The question comment value.
   */
@@ -6544,7 +6551,10 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   transformToDesktopView(): void;
   needResponsiveWidth(): boolean;
   protected supportResponsiveness(): boolean;
+  protected needResponsiveness(): boolean;
+  protected checkForResponsiveness(el: any): void;
   resizeObserver: any;
+  protected getObservedElementSelector(): string;
   protected getCompactRenderAs(): string;
   protected getDesktopRenderAs(): string;
   protected processResponsiveness(requiredWidth: number, availableWidth: number): void;
@@ -7962,6 +7972,8 @@ export declare class QuestionSelectBase extends Question {
   protected get activeChoices(): any;
   protected getChoicesFromQuestion(question: QuestionSelectBase): Array<ItemValue>;
   protected get hasActiveChoices(): boolean;
+  protected isHeadChoice(item: ItemValue, question: QuestionSelectBase): boolean;
+  protected isFootChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   protected isBuiltInChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   protected getChoices(): Array<ItemValue>;
   supportComment(): boolean;
@@ -7999,6 +8011,7 @@ export declare class QuestionSelectBase extends Question {
   getColumnClass(): string;
   getItemIndex(item: any): number;
   getItemClass(item: any): string;
+  protected getCurrentColCount(): number;
   protected getItemClassCore(item: any, options: any): string;
   getLabelClass(item: ItemValue): string;
   getControlLabelClass(item: ItemValue): string;
@@ -8019,7 +8032,7 @@ export declare class QuestionSelectBase extends Question {
   getItemId(item: ItemValue): string;
   get questionName(): string;
   getItemEnabled(item: ItemValue): any;
-  rootElement: any;
+  protected rootElement: any;
   afterRender(el: any): void;
   prevIsOtherSelected: boolean;
   protected onValueChanged(): void;
@@ -8681,6 +8694,8 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
 export declare class QuestionTextModel extends QuestionTextBase {
   constructor(name: string);
   locDataListValue: LocalizableStrings;
+  minValueRunner: ExpressionRunner;
+  maxValueRunner: ExpressionRunner;
   protected isTextValue(): boolean;
   getType(): string;
   onSurveyLoad(): void;
@@ -8843,7 +8858,7 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   protected canUseFilteredChoices(): boolean;
   protected supportSelectAll(): boolean;
   protected addToVisibleChoices(items: any, isAddAll: boolean): void;
-  protected isBuiltInChoice(item: ItemValue, question: QuestionSelectBase): boolean;
+  protected isHeadChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   /*
   * For internal use in SurveyJS Creator V2.
   */
@@ -8896,14 +8911,16 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   /*
   * The image height.
   */
-  get imageHeight(): string;
-  set imageHeight(val: string);
+  get imageHeight(): number;
+  set imageHeight(val: number);
+  responsiveImageHeight: number;
   get renderedImageHeight(): string;
   /*
   * The image width.
   */
-  get imageWidth(): string;
-  set imageWidth(val: string);
+  get imageWidth(): number;
+  set imageWidth(val: number);
+  responsiveImageWidth: number;
   get renderedImageWidth(): string;
   /*
   * The image fit mode.
@@ -8916,8 +8933,24 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   get contentMode(): string;
   set contentMode(val: string);
   protected convertDefaultValue(val: any): any;
-  get hasColumns(): boolean;
   get inputType(): "checkbox" | "radio";
+  protected isFootChoice(_item: ItemValue, _question: QuestionSelectBase): boolean;
+  getSelectBaseRootCss(): string;
+  isResponsiveValue: boolean;
+  maxImageWidth: number;
+  minImageWidth: number;
+  maxImageHeight: number;
+  minImageHeight: number;
+  protected getObservedElementSelector(): string;
+  protected supportResponsiveness(): boolean;
+  protected needResponsiveness(): boolean;
+  _width: number;
+  onContentLoaded: any;
+  responsiveColCount: number;
+  protected getCurrentColCount(): number;
+  protected processResponsiveness(_: number, availableWidth: number): void;
+  gapBetweenItems: number;
+  afterRender(el: any): void;
 }
 /*
 * A Model for a matrix dropdown question. You may use a dropdown, checkbox, radiogroup, text and comment questions as a cell editors.
@@ -9002,6 +9035,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   */
   get allowRowsDragAndDrop(): boolean;
   set allowRowsDragAndDrop(val: boolean);
+  get iconDragElement(): string;
   protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
   /*
   * The minimum row count. A user could not delete a row if the rowCount equals to minRowCount
@@ -9677,6 +9711,7 @@ export declare var defaultStandardCss: {
     itemInline: string,
     itemText: string,
     clearButton: string,
+    column: string,
   },
   rating: {
     root: string,
@@ -9726,6 +9761,9 @@ export declare var defaultStandardCss: {
       buttonCollapsed: string,
     },
   },
+  variables: {
+    themeMark: string,
+  },
 };
 export declare var surveyTimerFunctions: {
   setTimeout: any,
@@ -10660,6 +10698,7 @@ export declare var defaultV2Css: {
   imagepicker: {
     mainRoot: string,
     root: string,
+    rootColumn: string,
     item: string,
     itemOnError: string,
     itemInline: string,
@@ -10674,6 +10713,10 @@ export declare var defaultV2Css: {
     itemText: string,
     clearButton: string,
     other: string,
+    itemNoImage: string,
+    itemNoImageSvgIcon: string,
+    itemNoImageSvgIconId: string,
+    column: string,
   },
   matrix: {
     mainRoot: string,
@@ -10734,6 +10777,8 @@ export declare var defaultV2Css: {
     buttonRemove: string,
     iconAdd: string,
     iconRemove: string,
+    dragElementDecorator: string,
+    iconDragElement: string,
     footer: string,
     emptyRowsSection: string,
     iconDrag: string,
@@ -10848,6 +10893,17 @@ export declare var defaultV2Css: {
     itemDragMod: string,
     itemOnError: string,
   },
+  buttongroup: {
+    root: string,
+    item: string,
+    itemIcon: string,
+    itemDecorator: string,
+    itemCaption: string,
+    itemHover: string,
+    itemSelected: string,
+    itemDisabled: string,
+    itemControl: string,
+  },
   actionBar: {
     root: string,
     item: string,
@@ -10858,6 +10914,8 @@ export declare var defaultV2Css: {
   },
   variables: {
     mobileWidth: string,
+    imagepickerGapBetweenItems: string,
+    themeMark: string,
   },
 };
 export declare var modernCss: {
@@ -11098,6 +11156,7 @@ export declare var modernCss: {
   },
   imagepicker: {
     root: string,
+    column: string,
     item: string,
     itemInline: string,
     itemChecked: string,
@@ -11228,6 +11287,9 @@ export declare var modernCss: {
       buttonCollapsed: string,
     },
   },
+  variables: {
+    themeMark: string,
+  },
 };
 export declare var SvgRegistry: SvgIconRegistry;
 export declare var SvgBundleViewModel: any;