survey-react 1.9.115 → 1.9.116

package/survey.react.d.ts

@@ -1343,13 +1343,13 @@ declare module "actions/action" {
      *
      * Action items are used in the Toolbar, matrix rows, titles of pages, panels, questions, and other survey elements.
      *
-     * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+     * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
      */
     export interface IAction {
         /**
          * A unique action item identifier.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          */
         id?: string;
         /**
@@ -1361,7 +1361,7 @@ declare module "actions/action" {
         /**
          * The action item's title.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          * @see showTitle
          * @see disableShrink
          */
@@ -1389,7 +1389,7 @@ declare module "actions/action" {
         /**
          * A function that is executed when users click the action item.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          */
         action?: (context?: any) => void;
         /**
@@ -1399,7 +1399,7 @@ declare module "actions/action" {
          *
          * To apply several classes, separate them with a space character: `"myclass1 myclass2"`.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          * @see innerCss
          */
         css?: string;
@@ -1410,7 +1410,7 @@ declare module "actions/action" {
          *
          * To apply several classes, separate them with a space character: `"myclass1 myclass2"`.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          * @see css
          */
         innerCss?: string;
@@ -1473,7 +1473,7 @@ declare module "actions/action" {
         /**
          * A number that specifies the action's position relative to other actions.
          *
-         * [View Demo](/form-library/examples/add-custom-navigation-button/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/add-custom-navigation-button/ (linkStyle))
          */
         visibleIndex?: number;
         needSpace?: boolean;
@@ -5593,7 +5593,7 @@ declare module "question_paneldynamic" {
          *
          * If you want to customize individual tab titles, handle `SurveyModel`'s [`onGetDynamicPanelTabTitle`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onGetDynamicPanelTabTitle) event.
          *
-         * [View Demo](/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
          * @see templateTitle
          * @see renderMode
          */
@@ -5882,7 +5882,7 @@ declare module "question_paneldynamic" {
          * - `"progressTop"` - Renders each panel as a card and displays a progress bar at the top. [View Demo](https://surveyjs.io/form-library/examples/questiontype-paneldynamic/)
          * - `"progressBottom"` - Renders each panel panel as a card and displays a progress bar at the bottom.
          * - `"progressTopBottom"` - Renders each panel as a card and displays a progress bar at the top and bottom.
-         * - `"tab"` - Renders each panel within a tab. Use the [`templateTabTitle`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#templateTabTitle) to specify a template for tab titles. [View Demo](/form-library/examples/tabbed-interface-for-duplicate-group-option/)
+         * - `"tab"` - Renders each panel within a tab. Use the [`templateTabTitle`](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model#templateTabTitle) to specify a template for tab titles. [View Demo](https://surveyjs.io/form-library/examples/tabbed-interface-for-duplicate-group-option/)
          */
         get renderMode(): string;
         set renderMode(val: string);
@@ -6590,7 +6590,7 @@ declare module "survey-events-api" {
     }
     export interface UploadFilesEvent extends LoadFilesEvent {
         /**
-         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass `"success"` or `"error"` to indicate the operation status and, optionally, the downloaded file's data.
+         * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the uploaded file's data if file upload was successful or an error message if file upload failed.
          */
         callback: (status: string, data?: any) => any;
         /**
@@ -6600,7 +6600,7 @@ declare module "survey-events-api" {
     }
     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"` to indicate the operation status and, optionally, the downloaded file's data as a Base64 string.
+         * 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 upload was successful or an error message if file upload failed.
          */
         callback: (status: string, data?: any) => any;
         /**
@@ -6614,7 +6614,7 @@ declare module "survey-events-api" {
     }
     export interface ClearFilesEvent extends LoadFilesEvent {
         /**
-         * A callback function that you should call when files are deleted successfully or when deletion fails. Pass `"success"` or `"error"` to indicate the operation status and, optionally, deleted files' data (`options.value`).
+         * A callback function that you should call when files are deleted 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 deleted files' data (`options.value`) if file upload was successful or an error message if file upload failed.
          */
         callback: (status: string, data?: any) => any;
         /**
@@ -7641,7 +7641,7 @@ declare module "question_multipletext" {
     /**
      * A class that describes an item in a [Multiple Textboxes](https://surveyjs.io/form-library/documentation/api-reference/multiple-text-entry-question-model) question.
      *
-     * [View Demo](/form-library/examples/multiple-text-box-question/)
+     * [View Demo](https://surveyjs.io/form-library/examples/multiple-text-box-question/)
      */
     export class MultipleTextItemModel extends Base implements IValidatorOwner, ISurveyData, ISurveyImpl {
         private editorValue;
@@ -8390,16 +8390,16 @@ declare module "survey" {
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
         onUpdateQuestionCssClasses: EventBase<SurveyModel, UpdateQuestionCssClassesEvent>;
         /**
-         * An event that is raised before rendering a standalone panel and panels within [Dynamic Panel](/form-library/examples/duplicate-group-of-fields-in-form/). Use it to override default panel CSS classes.
+         * An event that is raised before rendering a standalone panel and panels within [Dynamic Panel](https://surveyjs.io/form-library/examples/duplicate-group-of-fields-in-form/). Use it to override default panel CSS classes.
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
         onUpdatePanelCssClasses: EventBase<SurveyModel, UpdatePanelCssClassesEvent>;
@@ -8408,7 +8408,7 @@ declare module "survey" {
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
         onUpdatePageCssClasses: EventBase<SurveyModel, UpdatePageCssClassesEvent>;
@@ -8417,7 +8417,7 @@ declare module "survey" {
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
         onUpdateChoiceItemCss: EventBase<SurveyModel, UpdateChoiceItemCssEvent>;
@@ -8509,7 +8509,7 @@ declare module "survey" {
          */
         onMatrixRowAdding: EventBase<SurveyModel, MatrixBeforeRowAddedEvent>;
         /**
-         * This event is obsolete. Use the [`onMatrixRowAdding`](/form-library/documentation/api-reference/survey-data-model#onMatrixRowAdding) event instead.
+         * This event is obsolete. Use the [`onMatrixRowAdding`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onMatrixRowAdding) event instead.
          */
         onMatrixBeforeRowAdded: EventBase<SurveyModel, MatrixBeforeRowAddedEvent>;
         /**
@@ -8529,7 +8529,7 @@ declare module "survey" {
          */
         onMatrixRenderRemoveButton: EventBase<SurveyModel, MatrixAllowRemoveRowEvent>;
         /**
-         * This event is obsolete. Use the [`onMatrixRenderRemoveButton`](/form-library/documentation/api-reference/survey-data-model#onMatrixRenderRemoveButton) event instead.
+         * This event is obsolete. Use the [`onMatrixRenderRemoveButton`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onMatrixRenderRemoveButton) event instead.
          */
         onMatrixAllowRemoveRow: EventBase<SurveyModel, MatrixAllowRemoveRowEvent>;
         /**
@@ -8548,7 +8548,7 @@ declare module "survey" {
          */
         onAfterRenderMatrixCell: EventBase<SurveyModel, MatrixAfterCellRenderEvent>;
         /**
-         * This event is obsolete. Use the [`onAfterRenderMatrixCell`](/form-library/documentation/api-reference/survey-data-model#onAfterRenderMatrixCell) event instead.
+         * This event is obsolete. Use the [`onAfterRenderMatrixCell`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onAfterRenderMatrixCell) event instead.
          */
         onMatrixAfterCellRender: EventBase<SurveyModel, MatrixAfterCellRenderEvent>;
         /**
@@ -8606,7 +8606,7 @@ declare module "survey" {
          *
          * For information on event handler parameters, refer to descriptions within the interface.
          *
-         * [View Demo](/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/tabbed-interface-for-duplicate-group-option/ (linkStyle))
          */
         onGetDynamicPanelTabTitle: EventBase<SurveyModel, DynamicPanelGetTabTitleEvent>;
         /**
@@ -8700,7 +8700,7 @@ declare module "survey" {
         /**
          * Gets or sets an object in which keys are UI elements and values are CSS classes applied to them.
          *
-         * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/customize-survey-with-css/ (linkStyle))
          */
         get css(): any;
         set css(value: any);
@@ -10676,8 +10676,8 @@ declare module "survey" {
         /**
          * Applies a specified theme to the survey.
          *
-         * [Themes & Styles](/form-library/documentation/manage-default-themes-and-styles (linkStyle))
-         * @param theme An [`ITheme`](/form-library/documentation/api-reference/itheme) object with theme settings.
+         * [Themes & Styles](https://surveyjs.io/form-library/documentation/manage-default-themes-and-styles (linkStyle))
+         * @param theme An [`ITheme`](https://surveyjs.io/form-library/documentation/api-reference/itheme) object with theme settings.
          */
         applyTheme(theme: ITheme): void;
         themeChanged(theme: ITheme): void;
@@ -11958,6 +11958,7 @@ declare module "question" {
         protected onChangeQuestionValue(newValue: any): void;
         protected setValueChangedDirectly(val: boolean): void;
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
+        private get isParentChangingViaDefaultValue();
         onSurveyValueChanged(newValue: any): void;
         setVisibleIndex(val: number): number;
         removeElement(element: IElement): boolean;
@@ -15146,6 +15147,7 @@ declare module "question_comment" {
         beforeDestroyQuestionElement(el: HTMLElement): void;
         onInput(event: any): void;
         onKeyDown(event: any): void;
+        protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
         onValueChanged(): void;
         protected setNewValue(newValue: string): any;
         protected getValueSeparator(): string;
@@ -15275,7 +15277,7 @@ declare module "question_rating" {
          *
          * If you do not specify the `rateValues` property, rate values are generated automatically based upon the [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin), [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax), [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep), and [`rateCount`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateCount) property values.
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          */
         get rateValues(): Array<any>;
         set rateValues(val: Array<any>);
@@ -15284,7 +15286,7 @@ declare module "question_rating" {
          *
          * Default value: 1
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          * @see rateMax
          * @see rateStep
          * @see rateCount
@@ -15296,7 +15298,7 @@ declare module "question_rating" {
          *
          * Default value: 5
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          * @see rateMin
          * @see rateStep
          * @see rateCount
@@ -15308,7 +15310,7 @@ declare module "question_rating" {
          *
          * Default value: 1
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          * @see rateMin
          * @see rateMax
          * @see rateCount
@@ -15320,7 +15322,7 @@ declare module "question_rating" {
          *
          * Set the [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin) or [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax) property to specify the first or the last rate value. Use the [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep) property to specify a step with which to generate rate values.
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          */
         rateCount: number;
         private static colorsCalculated;
@@ -15389,7 +15391,7 @@ declare module "question_rating" {
         * - `"dropdown"` - Displays rate values as items in a drop-down list.
         * - `"auto"` (default) - Selects between the `"buttons"` and `"dropdown"` modes based on the available width. When the width is insufficient to display buttons, the question displays a dropdown.
         *
-        * [View Demo](/form-library/examples/ui-adaptation-modes-for-rating-scale/ (linkStyle))
+        * [View Demo](https://surveyjs.io/form-library/examples/ui-adaptation-modes-for-rating-scale/ (linkStyle))
         * @see rateType
         */
         displayMode: "dropdown" | "buttons" | "auto";
@@ -15402,7 +15404,7 @@ declare module "question_rating" {
          * - `"stars"` - Displays rate values as stars.
          * - `"smileys"` - Displays rate values as smiley faces.
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          * @see scaleColorMode
          * @see rateColorMode
          * @see displayMode
@@ -15418,7 +15420,7 @@ declare module "question_rating" {
          * - `"monochrome"` (default) - Displays emojis in monochrome.
          * - `"colored"` - Displays emojis in color.
          *
-         * [View Demo](/form-library/examples/rating-scale/ (linkStyle))
+         * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
          * @see rateColorMode
          */
         scaleColorMode: "monochrome" | "colored";
@@ -15673,7 +15675,6 @@ declare module "question_image" {
 declare module "question_signaturepad" {
     import { Question } from "question";
     import { ITheme } from "themes";
-    export function getCanvasRatio(canvas: HTMLCanvasElement): number;
     /**
      * A class that describes the Signature question type.
      *
@@ -15690,6 +15691,13 @@ declare module "question_signaturepad" {
         afterRenderQuestionElement(el: HTMLElement): void;
         beforeDestroyQuestionElement(el: HTMLElement): void;
         themeChanged(theme: ITheme): void;
+        private canvas;
+        private scale;
+        private valueIsUpdatingInternally;
+        private resizeCanvas;
+        private scaleCanvas;
+        private refreshCanvas;
+        private updateValueHandler;
         initSignaturePad(el: HTMLElement): void;
         destroySignaturePad(el: HTMLElement): void;
         /**
@@ -15713,6 +15721,29 @@ declare module "question_signaturepad" {
          */
         get signatureHeight(): number;
         set signatureHeight(val: number);
+        /**
+         * Specifies whether the signature area should be scaled to fit into the question width.
+         *
+         * Default value: `false`
+         *
+         * > The signature area is scaled only for display. The resulting image will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
+         */
+        signatureAutoScaleEnabled: boolean;
+        /**
+         * Speicifies the minimum width of pen strokes, measured in pixels.
+         *
+         * Default value: 0.5
+         */
+        penMinWidth: number;
+        /**
+         * Speicifies the maximum width of pen strokes, measured in pixels.
+         *
+         * Default value: 2.5
+         */
+        penMaxWidth: number;
+        private get containerHeight();
+        private get containerWidth();
+        get renderedCanvasWidth(): string;
         get height(): number;
         set height(val: number);
         /**