survey-core 1.9.121 → 1.9.122

package/typings/question_rating.d.ts

@@ -128,18 +128,20 @@ export declare class QuestionRatingModel extends Question {
     protected getPlainDataCalculatedValue(propName: string): any;
     /**
      * Specifies a description for the minimum (first) rate value.
+     * @see rateDescriptionLocation
+     * @see displayRateDescriptionsAsExtremeItems
      * @see rateValues
      * @see rateMin
-     * @see displayRateDescriptionsAsExtremeItems
      */
     get minRateDescription(): string;
     set minRateDescription(val: string);
     get locMinRateDescription(): LocalizableString;
     /**
      * Specifies a description for the maximum (last) rate value.
+     * @see rateDescriptionLocation
+     * @see displayRateDescriptionsAsExtremeItems
      * @see rateValues
      * @see rateMax
-     * @see displayRateDescriptionsAsExtremeItems
      */
     get maxRateDescription(): string;
     set maxRateDescription(val: string);
@@ -149,15 +151,14 @@ export declare class QuestionRatingModel extends Question {
     get hasMinLabel(): boolean;
     get hasMaxLabel(): boolean;
     /**
-    * Specifies whether to display `minRateDescription` and `maxRateDescription` values as captions for buttons that correspond to the extreme (first and last) rate values.
+    * Specifies whether to display [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) values as captions for buttons that correspond to the extreme (first and last) rate values.
     *
     * Default value: `false`
     *
     * If this property is disabled, the `minRateDescription` and `maxRateDescription` values are displayed as plain non-clickable texts.
     *
     * If any of the `minRateDescription` and `maxRateDescription` properties is empty, the corresponding rate value's `value` or `text` is displayed as a button caption.
-    * @see minRateDescription
-    * @see maxRateDescription
+    * @see rateDescriptionLocation
     * @see rateMin
     * @see rateMax
     * @see rateValues
@@ -176,6 +177,18 @@ export declare class QuestionRatingModel extends Question {
     * @see rateType
     */
     displayMode: "dropdown" | "buttons" | "auto";
+    /**
+    * Specifies the alignment of [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) texts.
+    *
+    * Possible values:
+    *
+    * - `"leftRight"` (default) - Aligns `minRateDescription` to the left of rate values and `maxRateDescription` to their right.
+    * - `"top"` - Displays the descriptions above the minimum and maximum rate values.
+    * - `"bottom"` - Displays both descriptions below the minimum and maximum rate values.
+    * - `"topBottom"` - Displays `minRateDescription` above the minimum rate value and `maxRateDescription` below the maximum rate value.
+    * @see displayRateDescriptionsAsExtremeItems
+    */
+    rateDescriptionLocation: "leftRight" | "top" | "bottom" | "topBottom";
     /**
      * Specifies the visual representation of rate values.
      *

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

@@ -827,15 +827,17 @@ export interface DynamicPanelItemValueChangedEvent extends PanelDynamicQuestionE
      */
     panel: PanelModel;
 }
-export interface DynamicPanelGetTabTitleEvent extends PanelDynamicQuestionEventMixin {
+export interface DynamicPanelCurrentIndexChangedEvent extends PanelDynamicQuestionEventMixin {
     /**
-     * A panel whose tab title is being rendered.
+     * A panel for which the event is raised.
      */
     panel: PanelModel;
     /**
      * The panel's index in the [`visiblePanels`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#visiblePanels) array of the Dynamic Panel.
      */
     visiblePanelIndex: number;
+}
+export interface DynamicPanelGetTabTitleEvent extends DynamicPanelCurrentIndexChangedEvent {
     /**
      * A tab title. You can change this parameter's value.
      */

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, 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 } from "./survey-events-api";
 import { QuestionMatrixDropdownModelBase } from "./question_matrixdropdownbase";
 import { QuestionMatrixDynamicModel } from "./question_matrixdynamic";
 import { QuestionFileModel } from "./question_file";
@@ -633,6 +633,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * [View Demo](https://surveyjs.io/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
      */
     onGetDynamicPanelTabTitle: EventBase<SurveyModel, DynamicPanelGetTabTitleEvent>;
+    /**
+     * An event that is raised after the current panel is changed in a [Dynamic Panel](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/) question.
+     */
+    onDynamicPanelCurrentIndexChanged: EventBase<SurveyModel, DynamicPanelCurrentIndexChangedEvent>;
     /**
      * An event that is raised to define whether a question answer is correct. Applies only to [quiz surveys](https://surveyjs.io/form-library/documentation/design-survey/create-a-quiz).
      */
@@ -1512,7 +1516,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Merges a specified data object with the object from the [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data) property.
      *
-     * Refer to the following help topic for more information: [Merge Question Values](https://surveyjs.io/form-library/documentation/design-survey/merge-question-values).
+     * Refer to the following help topic for more information: [Populate Form Fields | Multiple Question Values](https://surveyjs.io/form-library/documentation/design-survey/pre-populate-form-fields#multiple-question-values).
      *
      * @param data A data object to merge. It should have the following structure: `{ questionName: questionValue, ... }`
      * @see setValue
@@ -1949,6 +1953,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     protected onQuestionsOnPageModeChanged(oldValue: string): void;
     private restoreOriginalPages;
     private getPageStartIndex;
+    private isCreatingPagesForPreview;
     private setupPagesForPageModes;
     private createPagesForQuestionOnPageMode;
     private createSinglePage;
@@ -2107,6 +2112,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     dynamicPanelRemoving(question: QuestionPanelDynamicModel, panelIndex: number, panel: PanelModel): boolean;
     dynamicPanelItemValueChanged(question: IQuestion, options: any): void;
     dynamicPanelGetTabTitle(question: IQuestion, options: any): void;
+    dynamicPanelCurrentIndexChanged(question: IQuestion, options: any): void;
     dragAndDropAllow(options: DragDropAllowEvent): boolean;
     elementContentVisibilityChanged(element: ISurveyElement): void;
     getUpdatedPanelFooterActions(panel: PanelModel, actions: Array<IAction>, question?: QuestionPanelDynamicModel): Array<IAction>;
@@ -2127,13 +2133,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *   question,
      *   question.name,
      *   question.value,
-     *   (status, data) => {
-     *     if (status === "success") {
-     *       // Handle success
-     *     }
-     *     if (status === "error") {
-     *       // Handle error
-     *     }
+     *   (data, errors) => {
+     *     // ...
      *   }
      * );
      * ```
@@ -2218,7 +2219,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns a question with a specified [`name`](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      * @param name A question name
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A question with a specified name.
      * @see getAllQuestions
      * @see getQuestionByValueName
@@ -2230,7 +2231,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * > Since `valueName` does not have to be unique, multiple questions can have the same `valueName` value. In this case, the `getQuestionByValueName()` method returns the first such question. If you need to get all questions with the same `valueName`, call the `getQuestionsByValueName()` method.
      * @param valueName A question's `valueName` property value.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the question. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A question with a specified `valueName`.
      * @see getAllQuestions
      * @see getQuestionByName
@@ -2239,7 +2240,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns all questions with a specified [`valueName`](https://surveyjs.io/form-library/documentation/api-reference/question#valueName). If a question's `valueName` is undefined, its [`name`](https://surveyjs.io/form-library/documentation/api-reference/question#name) property is used.
      * @param valueName A question's `valueName` property value.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns An array of questions with a specified `valueName`.
      * @see getAllQuestions
      * @see getQuestionByName
@@ -2249,7 +2250,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns an array of questions with specified [names](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      * @param names An array of question names.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the questions. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns An array of questions with specified names
      * @see getAllQuestions
      */
@@ -2294,7 +2295,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     /**
      * Returns a [panel](https://surveyjs.io/form-library/documentation/api-reference/panel-model) with a specified [`name`](https://surveyjs.io/form-library/documentation/api-reference/panel-model#name).
      * @param name A panel name.
-     * @param caseInsensitive (Optional) A Boolean value that specifies case sensitivity when searching for the panel. Default value: `false` (uppercase and lowercase letters are treated as distinct).
+     * @param caseInsensitive *(Optional)* A Boolean value that specifies case sensitivity when searching for the panel. Default value: `false` (uppercase and lowercase letters are treated as distinct).
      * @returns A panel with a specified name.
      * @see getAllPanels
      */