survey-react 1.9.94 → 1.9.96

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/survey.react.d.ts CHANGED
@@ -3379,6 +3379,7 @@ declare module "panel" {
3379
3379
  * @see [Data Validation](https://surveyjs.io/form-library/documentation/data-validation)
3380
3380
  */
3381
3381
  validate(fireCallback?: boolean, focusOnFirstError?: boolean, rec?: any): boolean;
3382
+ validateContainerOnly(): void;
3382
3383
  private hasErrorsInPanels;
3383
3384
  getErrorCustomText(text: string, error: SurveyError): string;
3384
3385
  private hasRequiredError;
@@ -4041,6 +4042,8 @@ declare module "question_baseselect" {
4041
4042
  private newItemValue;
4042
4043
  private canShowOptionItemCallback;
4043
4044
  private waitingGetChoiceDisplayValueResponse;
4045
+ private get waitingChoicesByURL();
4046
+ private get waitingAcyncOperations();
4044
4047
  protected selectedItemValues: any;
4045
4048
  constructor(name: string);
4046
4049
  getType(): string;
@@ -4570,25 +4573,7 @@ declare module "question_matrixdropdowncolumn" {
4570
4573
  getCustomCellType(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, cellType: string): string;
4571
4574
  onColumnCellTypeChanged(column: MatrixDropdownColumn): void;
4572
4575
  }
4573
- export var matrixDropdownColumnTypes: {
4574
- dropdown: {
4575
- onCellQuestionUpdate: (cellQuestion: any, column: any, question: any, data: any) => void;
4576
- };
4577
- checkbox: {
4578
- onCellQuestionUpdate: (cellQuestion: any, column: any, question: any, data: any) => void;
4579
- };
4580
- radiogroup: {
4581
- onCellQuestionUpdate: (cellQuestion: any, column: any, question: any, data: any) => void;
4582
- };
4583
- tagbox: {};
4584
- text: {};
4585
- comment: {};
4586
- boolean: {
4587
- onCellQuestionUpdate: (cellQuestion: any, column: any, question: any, data: any) => void;
4588
- };
4589
- expression: {};
4590
- rating: {};
4591
- };
4576
+ export var matrixDropdownColumnTypes: any;
4592
4577
  export class MatrixDropdownColumn extends Base implements ILocalizableOwner, IWrapperObject {
4593
4578
  static getColumnTypes(): Array<string>;
4594
4579
  private templateQuestionValue;
@@ -5906,6 +5891,7 @@ declare module "survey-events-api" {
5906
5891
  import { ItemValue } from "itemvalue";
5907
5892
  import { PageModel } from "page";
5908
5893
  import { PanelModel, PanelModelBase } from "panel";
5894
+ import { PopupModel } from "popup";
5909
5895
  import { Question } from "question";
5910
5896
  import { QuestionFileModel } from "question_file";
5911
5897
  import { MatrixDropdownCell, MatrixDropdownRowModelBase, QuestionMatrixDropdownModelBase } from "question_matrixdropdownbase";
@@ -6345,32 +6331,46 @@ declare module "survey-events-api" {
6345
6331
  }
6346
6332
  export interface SendResultEvent {
6347
6333
  /**
6348
- * a response from the service
6334
+ * A server [response](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/response).
6349
6335
  */
6350
6336
  response: any;
6351
6337
  request: any;
6352
6338
  /**
6353
- * it is `true` if the results has been sent to the service successfully
6339
+ * A Boolean value that indicates whether survey results have been saved successfully.
6354
6340
  */
6355
6341
  success: boolean;
6356
6342
  }
6357
6343
  export interface GetResultEvent {
6358
6344
  /**
6359
- * the server response
6345
+ * A server [response](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/response).
6360
6346
  */
6361
6347
  response: any;
6362
6348
  /**
6363
- * an array of objects `{name, value}`, where `name` is a unique value/answer to the question and `value` is a number/count of such answers
6349
+ * A Boolean value that indicates whether survey results have been retrieved successfully.
6364
6350
  */
6365
- dataList: Array<any>;
6351
+ success: boolean;
6366
6352
  /**
6367
- * the object `{AnswersCount, QuestionResult : {} }`. `AnswersCount` is the number of posted survey results. `QuestionResult` is an object with all possible unique answers to the question and number of these answers
6353
+ * An object with the following structure:
6354
+ *
6355
+ * ```js
6356
+ * {
6357
+ * AnswersCount: Number, // A total number of posted answers to the question
6358
+ * QuestionResult: Object // All unique answers to the question and their number
6359
+ * }
6360
+ * ```
6368
6361
  */
6369
6362
  data: any;
6370
6363
  /**
6371
- * it is `true` if the results were got from the service successfully
6364
+ * An array of objects with the following structure:
6365
+ *
6366
+ * ```js
6367
+ * {
6368
+ * name: String, // A unique answer to the question
6369
+ * value: Number // The number of user responses with this answer
6370
+ * }
6371
+ * ```
6372
6372
  */
6373
- success: boolean;
6373
+ dataList: Array<any>;
6374
6374
  }
6375
6375
  export interface LoadFilesEvent extends FileQuestionEventMixin {
6376
6376
  /**
@@ -6817,6 +6817,16 @@ declare module "survey-events-api" {
6817
6817
  */
6818
6818
  column: any;
6819
6819
  }
6820
+ export interface PopupVisibleChangedEvent extends QuestionEventMixin {
6821
+ /**
6822
+ * An object that describes the popup.
6823
+ */
6824
+ popup: PopupModel;
6825
+ /**
6826
+ * Indicates whether the popup is visible now.
6827
+ */
6828
+ visible: boolean;
6829
+ }
6820
6830
  }
6821
6831
  declare module "drag-drop-page-helper-v1" {
6822
6832
  import { IElement, ISurveyElement } from "base-interfaces";
@@ -7596,6 +7606,7 @@ declare module "question_multipletext" {
7596
7606
  get elements(): Array<IElement>;
7597
7607
  indexOf(el: IElement): number;
7598
7608
  ensureRowsVisibility(): void;
7609
+ validateContainerOnly(): void;
7599
7610
  getItemLabelCss(item: MultipleTextItemModel): string;
7600
7611
  getItemCss(): string;
7601
7612
  getItemTitleCss(): string;
@@ -7635,12 +7646,13 @@ declare module "survey" {
7635
7646
  import { ActionContainer } from "actions/container";
7636
7647
  import { QuestionPanelDynamicModel } from "question_paneldynamic";
7637
7648
  import { Notifier } from "notifier";
7638
- 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, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent } from "survey-events-api";
7649
+ 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, IsAnswerCorrectEvent, DragDropAllowEvent, ScrollingElementToTopEvent, GetQuestionTitleActionsEvent, GetPanelTitleActionsEvent, GetPageTitleActionsEvent, GetPanelFooterActionsEvent, GetMatrixRowActionsEvent, ElementContentVisibilityChangedEvent, GetExpressionDisplayValueEvent, ServerValidateQuestionsEvent, MultipleTextItemAddedEvent, MatrixColumnAddedEvent, GetQuestionDisplayValueEvent, PopupVisibleChangedEvent } from "survey-events-api";
7639
7650
  import { QuestionMatrixDropdownModelBase } from "question_matrixdropdownbase";
7640
7651
  import { QuestionMatrixDynamicModel } from "question_matrixdynamic";
7641
7652
  import { QuestionFileModel } from "question_file";
7642
7653
  import { QuestionMultipleTextModel } from "question_multipletext";
7643
7654
  import { ITheme } from "themes";
7655
+ import { PopupModel } from "popup";
7644
7656
  /**
7645
7657
  * The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
7646
7658
  *
@@ -7677,11 +7689,11 @@ declare module "survey" {
7677
7689
  private timerModelValue;
7678
7690
  private navigationBarValue;
7679
7691
  /**
7680
- * An event that is raised after a trigger is executed.
7692
+ * An event that is raised after a [trigger](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#triggers) is executed.
7681
7693
  *
7682
7694
  * For information on event handler parameters, refer to descriptions within the interface.
7683
7695
  *
7684
- * For more information about triggers, refer to the following help topic: [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers).
7696
+ * [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers (linkStyle)).
7685
7697
  * @see triggers
7686
7698
  * @see runTriggers
7687
7699
  */
@@ -7725,11 +7737,11 @@ declare module "survey" {
7725
7737
  */
7726
7738
  onStarted: EventBase<SurveyModel, {}>;
7727
7739
  /**
7728
- * Use this event to save incomplete survey results. Enable the [`sendResultOnPageNext`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#sendResultOnPageNext) property for this event to occur.
7740
+ * An event that is raised to save incomplete survey results. Enable the [`sendResultOnPageNext`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#sendResultOnPageNext) property for this event to occur.
7729
7741
  *
7730
7742
  * For information on event handler parameters, refer to descriptions within the interface.
7731
7743
  *
7732
- * Refer to the following help topic for more information on the use case: [Continue an Incomplete Survey](https://surveyjs.io/form-library/documentation/handle-survey-results-continue-incomplete).
7744
+ * [Continue an Incomplete Survey](https://surveyjs.io/form-library/documentation/handle-survey-results-continue-incomplete (linkStyle)).
7733
7745
  */
7734
7746
  onPartialSend: EventBase<SurveyModel, {}>;
7735
7747
  /**
@@ -7955,11 +7967,11 @@ declare module "survey" {
7955
7967
  */
7956
7968
  onTextRenderAs: EventBase<SurveyModel, TextRenderAsEvent>;
7957
7969
  /**
7958
- * The event fires when it gets response from the [api.surveyjs.io](https://api.surveyjs.io) service on saving survey results. Use it to find out if the results have been saved successfully.
7970
+ * An event that is raised after a request to save survey results on [SurveyJS Service](https://api.surveyjs.io/) has been completed. Use this event to find out if the results have been saved successfully.
7959
7971
  */
7960
7972
  onSendResult: EventBase<SurveyModel, SendResultEvent>;
7961
7973
  /**
7962
- * Use it to get results after calling the `getResult` method. It returns a simple analytics from [api.surveyjs.io](https://api.surveyjs.io) service.
7974
+ * An event that is raised when the [`getResult(resultId, questionName)`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#getResult) method is called. Use this event to obtain answers to an individual question from [SurveyJS Service](https://api.surveyjs.io/).
7963
7975
  * @see getResult
7964
7976
  */
7965
7977
  onGetResult: EventBase<SurveyModel, GetResultEvent>;
@@ -8248,25 +8260,23 @@ declare module "survey" {
8248
8260
  onScrollingElementToTop: EventBase<SurveyModel, ScrollingElementToTopEvent>;
8249
8261
  onLocaleChangedEvent: EventBase<SurveyModel, {}>;
8250
8262
  /**
8251
- * Use this event to create/customize actions to be displayed in a question's title.
8263
+ * An event that allows you to add, delete, or modify actions in a question title.
8252
8264
  *
8253
8265
  * For information on event handler parameters, refer to descriptions within the interface.
8254
8266
  *
8255
8267
  * [View Demo](https://surveyjs.io/form-library/examples/survey-titleactions/ (linkStyle))
8256
- * @see IAction
8257
- * @see Question
8258
8268
  */
8259
8269
  onGetQuestionTitleActions: EventBase<SurveyModel, GetQuestionTitleActionsEvent>;
8260
8270
  /**
8261
- * Use this event to create/customize actions to be displayed in a panel's title.
8262
- * @see IAction
8263
- * @see PanelModel
8271
+ * An event that allows you to add, delete, or modify actions in a panel title.
8264
8272
  */
8265
8273
  onGetPanelTitleActions: EventBase<SurveyModel, GetPanelTitleActionsEvent>;
8266
8274
  /**
8267
- * Use this event to create/customize actions to be displayed in a page's title.
8268
- * @see IAction
8269
- * @see PageModel
8275
+ * An event that allows you to add, delete, or modify actions in a page title.
8276
+ *
8277
+ * For information on event handler parameters, refer to descriptions within the interface.
8278
+ *
8279
+ * [View Demo](https://surveyjs.io/form-library/examples/modify-titles-of-survey-elements/ (linkStyle))
8270
8280
  */
8271
8281
  onGetPageTitleActions: EventBase<SurveyModel, GetPageTitleActionsEvent>;
8272
8282
  /**
@@ -8291,7 +8301,12 @@ declare module "survey" {
8291
8301
  * An event that is raised before expression question convert it's value into display value for rendering.
8292
8302
  */
8293
8303
  onGetExpressionDisplayValue: EventBase<SurveyModel, GetExpressionDisplayValueEvent>;
8304
+ /**
8305
+ * An event that is raised after the visibility of a popup is changed. This event can be raised for [Single-](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model) and [Multi-Select Dropdown](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model) questions and [Rating](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model) questions [rendered as drop-down menus](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#displayMode).
8306
+ */
8307
+ onPopupVisibleChanged: EventBase<SurveyModel, PopupVisibleChangedEvent>;
8294
8308
  constructor(jsonObj?: any, renderedElement?: any);
8309
+ processClosedPopup(question: IQuestion, popupModel: PopupModel<any>): void;
8295
8310
  protected createTryAgainAction(): IAction;
8296
8311
  private createHtmlLocString;
8297
8312
  /**
@@ -8350,8 +8365,11 @@ declare module "survey" {
8350
8365
  get isLazyRendering(): boolean;
8351
8366
  private updateLazyRenderingRowsOnRemovingElements;
8352
8367
  /**
8353
- * Gets or sets a list of triggers in the survey.
8354
- * @see SurveyTrigger
8368
+ * A list of triggers in the survey.
8369
+ *
8370
+ * [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers (linkStyle))
8371
+ * @see runTriggers
8372
+ * @see onTriggerExecuted
8355
8373
  */
8356
8374
  get triggers(): Array<SurveyTrigger>;
8357
8375
  set triggers(val: Array<SurveyTrigger>);
@@ -8361,7 +8379,7 @@ declare module "survey" {
8361
8379
  get calculatedValues(): Array<CalculatedValue>;
8362
8380
  set calculatedValues(val: Array<CalculatedValue>);
8363
8381
  /**
8364
- * The identifier of a survey JSON schema to load from the [SurveyJS Service](https://api.surveyjs.io).
8382
+ * The identifier of a survey JSON schema to load from [SurveyJS Service](https://api.surveyjs.io).
8365
8383
  *
8366
8384
  * Refer to the following help topic for more information: [Store Survey Results in the SurveyJS Service](https://surveyjs.io/form-library/documentation/handle-survey-results-store#store-survey-results-in-the-surveyjs-service).
8367
8385
  * @see loadSurveyFromService
@@ -8370,7 +8388,7 @@ declare module "survey" {
8370
8388
  get surveyId(): string;
8371
8389
  set surveyId(val: string);
8372
8390
  /**
8373
- * An identifier used to save survey results to the [SurveyJS Service](https://api.surveyjs.io).
8391
+ * An identifier used to save survey results to [SurveyJS Service](https://api.surveyjs.io).
8374
8392
  *
8375
8393
  * Refer to the following help topic for more information: [Store Survey Results in the SurveyJS Service](https://surveyjs.io/form-library/documentation/handle-survey-results-store#store-survey-results-in-the-surveyjs-service).
8376
8394
  * @see onComplete
@@ -8381,7 +8399,7 @@ declare module "survey" {
8381
8399
  /**
8382
8400
  * A user identifier (e-mail or other unique ID).
8383
8401
  *
8384
- * If your application works with the [SurveyJS Service](https://api.surveyjs.io), the ID ensures that users do not pass the same survey twice. On the second run, they will see the [Completed Before page](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completedBeforeHtml).
8402
+ * If your application works with [SurveyJS Service](https://api.surveyjs.io), the ID ensures that users do not pass the same survey twice. On the second run, they will see the [Completed Before page](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completedBeforeHtml).
8385
8403
  * @see cookieName
8386
8404
  */
8387
8405
  get clientId(): string;
@@ -8395,9 +8413,9 @@ declare module "survey" {
8395
8413
  get cookieName(): string;
8396
8414
  set cookieName(val: string);
8397
8415
  /**
8398
- * Specifies whether to save survey results when respondents swtich between pages. Handle the [`onPartialSend`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onPartialSend) event to implement the save operation.
8416
+ * Specifies whether to save survey results when respondents switch between pages. Handle the [`onPartialSend`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onPartialSend) event to implement the save operation.
8399
8417
  *
8400
- * Refer to the following help topic for more information on the use case: [Continue an Incomplete Survey](https://surveyjs.io/form-library/documentation/handle-survey-results-continue-incomplete).
8418
+ * [Continue an Incomplete Survey](https://surveyjs.io/form-library/documentation/handle-survey-results-continue-incomplete (linkStyle)).
8401
8419
  */
8402
8420
  get sendResultOnPageNext(): boolean;
8403
8421
  set sendResultOnPageNext(val: boolean);
@@ -8660,14 +8678,23 @@ declare module "survey" {
8660
8678
  get keepIncorrectValues(): boolean;
8661
8679
  set keepIncorrectValues(val: boolean);
8662
8680
  /**
8663
- * Gets or sets the survey locale. The default value it is empty, this means the 'en' locale is used.
8664
- * You can set it to 'de' - German, 'fr' - French and so on. The library has built-in localization for several languages. The library has a multi-language support as well.
8681
+ * Specifies the survey's locale.
8682
+ *
8683
+ * Default value: `""` (a default locale is used)
8684
+ *
8685
+ * [Localization & Globalization help topic](https://surveyjs.io/form-library/documentation/survey-localization (linkStyle))
8686
+ *
8687
+ * [Survey Localization demo](https://surveyjs.io/form-library/examples/survey-localization/ (linkStyle))
8665
8688
  */
8666
8689
  get locale(): string;
8667
8690
  set locale(value: string);
8668
8691
  private onSurveyLocaleChanged;
8669
8692
  /**
8670
- * Returns an array of locales that are used in the survey's translation.
8693
+ * Returns an array of locales whose translations are used in the survey.
8694
+ *
8695
+ * [Localization & Globalization help topic](https://surveyjs.io/form-library/documentation/survey-localization (linkStyle))
8696
+ *
8697
+ * [Survey Localization demo](https://surveyjs.io/form-library/examples/survey-localization/ (linkStyle))
8671
8698
  */
8672
8699
  getUsedLocales(): Array<string>;
8673
8700
  localeChanged(): void;
@@ -8792,8 +8819,7 @@ declare module "survey" {
8792
8819
  private updateRenderBackgroundImage;
8793
8820
  backgroundImageFit: string;
8794
8821
  /**
8795
- * A value from 0 to 1 that specifies how transparent the survey background should be: 0 makes the background completely transparent, and 1 makes it opaque.
8796
- * @see backgroundImage
8822
+ * A value from 0 to 1 that specifies how transparent the [background image](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#backgroundImage) should be: 0 makes the image completely transparent, and 1 makes it opaque.
8797
8823
  */
8798
8824
  get backgroundOpacity(): number;
8799
8825
  set backgroundOpacity(val: number);
@@ -8828,7 +8854,10 @@ declare module "survey" {
8828
8854
  */
8829
8855
  runCondition(expression: string): boolean;
8830
8856
  /**
8831
- * Run all triggers that performs on value changed and not on moving to the next page.
8857
+ * Executes [all triggers](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#triggers), except ["complete"](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#complete).
8858
+ *
8859
+ * [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers (linkStyle))
8860
+ * @see onTriggerExecuted
8832
8861
  */
8833
8862
  runTriggers(): void;
8834
8863
  get renderedCompletedHtml(): string;
@@ -8843,7 +8872,7 @@ declare module "survey" {
8843
8872
  set completedBeforeHtml(value: string);
8844
8873
  get locCompletedBeforeHtml(): LocalizableString;
8845
8874
  /**
8846
- * HTML content displayed while a survey JSON schema is being loaded from the [SurveyJS Service](https://api.surveyjs.io).
8875
+ * HTML content displayed while a survey JSON schema is being loaded from [SurveyJS Service](https://api.surveyjs.io).
8847
8876
  * @see surveyId
8848
8877
  * @see processedLoadingHtml
8849
8878
  */
@@ -9527,7 +9556,7 @@ declare module "survey" {
9527
9556
  * 1. Switches the survey [`state`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#state) to `"completed"`.
9528
9557
  * 1. Raises the [`onComplete`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onComplete) event.
9529
9558
  * 1. Navigates the user to a URL specified by the [`navigateToUrl`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#navigateToUrl) or [`navigateToUrlOnCondition`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#navigateToUrlOnCondition) property.
9530
- * 1. Calls the [`sendResult()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#sendResult) method if Form Library works with the [SurveyJS Service](https://api.surveyjs.io/).
9559
+ * 1. Calls the [`sendResult()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#sendResult) method if Form Library works with [SurveyJS Service](https://api.surveyjs.io/).
9531
9560
  *
9532
9561
  * The `doComplete()` method completes the survey regardless of validation errors and the current page. If you need to ensure that survey results are valid and full, call the [`completeLastPage()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#completeLastPage) method instead.
9533
9562
  *
@@ -9804,21 +9833,18 @@ declare module "survey" {
9804
9833
  private runConditionsCore;
9805
9834
  private checkIfNewPagesBecomeVisible;
9806
9835
  /**
9807
- * Sends a survey result to the [api.surveyjs.io](https://api.surveyjs.io) service.
9808
- * @param postId [api.surveyjs.io](https://api.surveyjs.io) service postId
9809
- * @param clientId Typically a customer e-mail or an identifier
9810
- * @param isPartialCompleted Set it to `true` if the survey is not completed yet and the results are intermediate
9811
- * @see surveyPostId
9812
- * @see clientId
9836
+ * Posts a survey result to [SurveyJS Service](https://api.surveyjs.io/).
9837
+ * @param postId An identifier used to save survey results. You can find it on the [My Surveys](https://surveyjs.io/service/mysurveys) page. If you do not specify this parameter, the survey uses the [`surveyPostId`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#surveyPostId) property value.
9838
+ * @param clientId A respondent identifier (e-mail or other unique ID). This ID ensures that the respondent does not pass the same survey twice.
9839
+ * @param isPartial Pass `true` to save partial survey results (see [Continue an Incomplete Survey](https://surveyjs.io/form-library/documentation/handle-survey-results-continue-incomplete)).
9813
9840
  */
9814
- sendResult(postId?: string, clientId?: string, isPartialCompleted?: boolean): void;
9841
+ sendResult(postId?: string, clientId?: string, isPartial?: boolean): void;
9815
9842
  /**
9816
- * Calls the [api.surveyjs.io](https://api.surveyjs.io) service and, on callback, fires the `onGetResult` event with all answers that your users made for a question.
9817
- * @param resultId [api.surveyjs.io](https://api.surveyjs.io) service resultId
9818
- * @param name The question name
9819
- * @see onGetResult
9843
+ * Requests [SurveyJS Service](https://api.surveyjs.io/) to retrieve all answers to a specified question. Handle the [`onGetResult`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onGetResult) event to access the answers.
9844
+ * @param resultId A result ID that identifies the required survey. You can find it on the [My Surveys](https://surveyjs.io/service/mysurveys) page.
9845
+ * @param questionName A question name.
9820
9846
  */
9821
- getResult(resultId: string, name: string): void;
9847
+ getResult(resultId: string, questionName: string): void;
9822
9848
  /**
9823
9849
  * Loads the survey JSON from the [api.surveyjs.io](https://api.surveyjs.io) service.
9824
9850
  * If `clientId` is not `null` and a user had completed a survey before, the survey switches to `completedbefore` state.
@@ -10165,6 +10191,7 @@ declare module "survey" {
10165
10191
  addLayoutElement(layoutElement: ISurveyLayoutElement): ISurveyLayoutElement;
10166
10192
  removeLayoutElement(layoutElementId: string): ISurveyLayoutElement;
10167
10193
  getContainerContent(container: LayoutElementContainer): any[];
10194
+ processPopupVisiblityChanged(question: Question, popup: PopupModel<any>, visible: boolean): void;
10168
10195
  applyTheme(theme: ITheme): void;
10169
10196
  /**
10170
10197
  * Use this method to dispose survey model properly.
@@ -10633,6 +10660,7 @@ declare module "question" {
10633
10660
  import { ExpressionRunner } from "conditions";
10634
10661
  import { QuestionCustomWidget } from "questionCustomWidgets";
10635
10662
  import { SurveyError } from "survey-error";
10663
+ import { PopupModel } from "popup";
10636
10664
  export interface IConditionObject {
10637
10665
  name: string;
10638
10666
  text: string;
@@ -10713,6 +10741,7 @@ declare module "question" {
10713
10741
  set valueName(val: string);
10714
10742
  protected onValueNameChanged(oldValue: string): void;
10715
10743
  protected onNameChanged(oldValue: string): void;
10744
+ set isReady(val: boolean);
10716
10745
  get isReady(): boolean;
10717
10746
  get ariaRequired(): "true" | "false";
10718
10747
  get ariaInvalid(): "true" | "false";
@@ -11354,6 +11383,7 @@ declare module "question" {
11354
11383
  get validatedValue(): any;
11355
11384
  set validatedValue(val: any);
11356
11385
  getAllValues(): any;
11386
+ processPopupVisiblilityChanged(popupModel: PopupModel, visible: boolean): void;
11357
11387
  transformToMobileView(): void;
11358
11388
  transformToDesktopView(): void;
11359
11389
  needResponsiveWidth(): boolean;
@@ -11614,6 +11644,7 @@ declare module "question_matrixdropdownbase" {
11614
11644
  updateCellQuestionOnColumnChanged(column: MatrixDropdownColumn, name: string, newValue: any): void;
11615
11645
  updateCellQuestionOnColumnItemValueChanged(column: MatrixDropdownColumn, propertyName: string, obj: ItemValue, name: string, newValue: any, oldValue: any): void;
11616
11646
  onQuestionReadOnlyChanged(parentIsReadOnly: boolean): void;
11647
+ private validationValues;
11617
11648
  hasErrors(fireCallback: boolean, rec: any, raiseOnCompletedAsyncValidators: () => void): boolean;
11618
11649
  protected updateCellOnColumnChanged(cell: MatrixDropdownCell, name: string, newValue: any): void;
11619
11650
  updateCellOnColumnItemValueChanged(cell: MatrixDropdownCell, propertyName: string, obj: ItemValue, name: string, newValue: any, oldValue: any): void;
@@ -11977,6 +12008,7 @@ declare module "base-interfaces" {
11977
12008
  import { PanelModel } from "panel";
11978
12009
  import { QuestionPanelDynamicModel } from "question_paneldynamic";
11979
12010
  import { DragDropAllowEvent } from "survey-events-api";
12011
+ import { PopupModel } from "popup";
11980
12012
  export interface ISurveyData {
11981
12013
  getValue(name: string): any;
11982
12014
  setValue(name: string, newValue: any, locNotification: any, allowNotifyValueChanged?: boolean): any;
@@ -12114,6 +12146,7 @@ declare module "base-interfaces" {
12114
12146
  runExpression(expression: string): any;
12115
12147
  elementContentVisibilityChanged(element: ISurveyElement): void;
12116
12148
  onCorrectQuestionAnswer(question: IQuestion, options: any): void;
12149
+ processPopupVisiblityChanged(question: IQuestion, popupModel: PopupModel, visible: boolean): void;
12117
12150
  }
12118
12151
  export interface ISurveyImpl {
12119
12152
  getSurveyData(): ISurveyData;
@@ -12206,6 +12239,7 @@ declare module "base-interfaces" {
12206
12239
  indexOf(el: IElement): number;
12207
12240
  elements: Array<IElement>;
12208
12241
  ensureRowsVisibility(): void;
12242
+ validateContainerOnly(): void;
12209
12243
  }
12210
12244
  export interface IPage extends IPanel, IConditionRunner {
12211
12245
  isStartPage: boolean;
@@ -13787,7 +13821,8 @@ declare module "question_ranking" {
13787
13821
  protected supportSelectAll(): boolean;
13788
13822
  supportOther(): boolean;
13789
13823
  supportNone(): boolean;
13790
- private handleArrowKeys;
13824
+ private handleArrowUp;
13825
+ private handleArrowDown;
13791
13826
  handleKeydownSelectToRank(event: KeyboardEvent, movedElement: ItemValue): void;
13792
13827
  private setValueAfterKeydown;
13793
13828
  private focusItem;
@@ -14396,6 +14431,7 @@ declare module "question_signaturepad" {
14396
14431
  */
14397
14432
  export class QuestionSignaturePadModel extends Question {
14398
14433
  isDrawingValue: boolean;
14434
+ private getPenColorFromTheme;
14399
14435
  protected getCssRoot(cssClasses: any): string;
14400
14436
  protected updateValue(): void;
14401
14437
  constructor(name: string);
@@ -14409,11 +14445,12 @@ declare module "question_signaturepad" {
14409
14445
  *
14410
14446
  * Possible values:
14411
14447
  *
14412
- * - `""` (default) - PNG
14413
- * - `"image/jpeg"` - JPEG
14414
- * - `"image/svg+xml"` - SVG
14448
+ * - `"png"` (default)
14449
+ * - `"jpeg"`
14450
+ * - `"svg"`
14415
14451
  */
14416
- dataFormat: string;
14452
+ get dataFormat(): string;
14453
+ set dataFormat(val: string);
14417
14454
  /**
14418
14455
  * Specifies the width of the signature area. Accepts positive integer numbers.
14419
14456
  */
@@ -14456,10 +14493,21 @@ declare module "surveyToc" {
14456
14493
  import { Action } from "actions/action";
14457
14494
  import { ListModel } from "list";
14458
14495
  import { PageModel } from "page";
14496
+ import { PopupModel } from "popup";
14459
14497
  import { SurveyModel } from "survey";
14460
14498
  export function tryNavigateToPage(survey: SurveyModel, page: PageModel): boolean;
14461
- export function createTOCListModel(survey: SurveyModel): ListModel<Action>;
14462
- export function getTocRootCss(survey: SurveyModel): string;
14499
+ export function createTOCListModel(survey: SurveyModel, onAction?: () => void): ListModel<Action>;
14500
+ export function getTocRootCss(survey: SurveyModel, isMobile?: boolean): string;
14501
+ export class TOCModel {
14502
+ survey: SurveyModel;
14503
+ constructor(survey: SurveyModel);
14504
+ isMobile: boolean;
14505
+ get containerCss(): string;
14506
+ listModel: ListModel<Action>;
14507
+ popupModel: PopupModel;
14508
+ icon: string;
14509
+ togglePopup: () => void;
14510
+ }
14463
14511
  }
14464
14512
  declare module "surveyProgress" {
14465
14513
  export class SurveyProgressModel {
@@ -14560,6 +14608,8 @@ declare module "popup-survey" {
14560
14608
  private setCssButton;
14561
14609
  protected createSurvey(jsonObj: any): SurveyModel;
14562
14610
  protected onSurveyComplete(): void;
14611
+ private onScrollCallback;
14612
+ onScroll(): void;
14563
14613
  }
14564
14614
  /**
14565
14615
  * Obsolete. Please use PopupSurvey
@@ -14832,6 +14882,7 @@ declare module "question_custom" {
14832
14882
  get elements(): Array<IElement>;
14833
14883
  indexOf(el: IElement): number;
14834
14884
  ensureRowsVisibility(): void;
14885
+ validateContainerOnly(): void;
14835
14886
  protected getContentDisplayValueCore(keyAsText: boolean, value: any, question: Question): any;
14836
14887
  }
14837
14888
  export class QuestionCustomModel extends QuestionCustomModelBase {
@@ -14957,6 +15008,7 @@ declare module "popup-view-model" {
14957
15008
  dispose(): void;
14958
15009
  initializePopupContainer(): void;
14959
15010
  setComponentElement(componentRoot: HTMLElement, targetElement?: HTMLElement | null): void;
15011
+ protected preventScrollOuside(event: any, deltaY: number): void;
14960
15012
  }
14961
15013
  }
14962
15014
  declare module "popup-dropdown-view-model" {