survey-react-ui 1.8.76 → 1.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react-ui",
-  "version": "1.8.76",
+  "version": "1.9.0",
   "description": "survey.js is a JavaScript Survey Library. It is a modern way to add a survey to your website. It uses JSON for survey metadata and results.",
   "keywords": [
     "Survey",

package/survey-react-ui.d.ts

@@ -1,4 +1,4 @@
-/*Type definitions for Survey JavaScript library v1.8.76
+/*Type definitions for Survey JavaScript library v1.9.0
 Copyright (c) 2015-2021 Devsoft Baltic OÜ  - http://surveyjs.io/
 Definitions by: Devsoft Baltic OÜ <https://github.com/surveyjs/>
 */
@@ -219,26 +219,35 @@ export declare class SurveyElementErrors extends ReactSurveyElement {
     protected get element(): SurveyElement;
     protected get location(): string;
     protected canRender(): boolean;
+    componentDidUpdate(prevProps: any, prevState: any): void;
+    componentWillUnmount(): void;
     protected renderElement(): JSX.Element;
 }
-export declare class SurveyQuestionAndErrorsCell extends ReactSurveyElement {
+export declare abstract class SurveyQuestionAndErrorsWrapped extends ReactSurveyElement {
     [index: string]: any;
-    protected cellRef: React.RefObject<HTMLTableCellElement>;
     constructor(props: any);
     protected getStateElement(): Base;
-    protected get itemCss(): string;
     protected get question(): Question;
     protected get creator(): ISurveyCreator;
     protected getQuestion(): Question;
+    protected get itemCss(): string;
     componentDidMount(): void;
-    componentWillUnmount(): void;
     componentDidUpdate(prevProps: any, prevState: any): void;
     protected doAfterRender(): void;
     protected canRender(): boolean;
-    protected renderElement(): JSX.Element;
+    protected renderErrors(errorsLocation: string): JSX.Element;
+    protected renderContent(): JSX.Element;
+    protected abstract renderElement(): JSX.Element;
     protected getShowErrors(): boolean;
-    protected getCellStyle(): any;
     protected renderQuestion(): JSX.Element;
+}
+export declare class SurveyQuestionAndErrorsCell extends SurveyQuestionAndErrorsWrapped {
+    [index: string]: any;
+    protected cellRef: React.RefObject<HTMLTableCellElement>;
+    constructor(props: any);
+    componentWillUnmount(): void;
+    protected renderElement(): JSX.Element;
+    protected getCellStyle(): any;
     protected getHeaderText(): string;
     protected wrapCell(cell: QuestionMatrixDropdownRenderedCell, element: JSX.Element): JSX.Element;
 }
@@ -396,8 +405,12 @@ export declare class SurveyQuestionMultipleText extends SurveyQuestionElementBas
     constructor(props: any);
     protected get question(): QuestionMultipleTextModel;
     protected renderElement(): JSX.Element;
+    protected renderItemTooltipError(item: MultipleTextItemModel, cssClasses: any): JSX.Element;
     protected renderRow(rowIndex: number, items: Array<MultipleTextItemModel>, cssClasses: any): JSX.Element;
 }
+export declare class SurveyMultipleTextItemEditor extends SurveyQuestionAndErrorsWrapped {
+    protected renderElement(): JSX.Element;
+}
 
 export declare class SurveyQuestionRadiogroup extends SurveyQuestionElementBase {
     constructor(props: any);
@@ -424,6 +437,7 @@ export declare class SurveyQuestionRadioItem extends ReactSurveyElement {
 
 export declare class SurveyQuestionText extends SurveyQuestionUncontrolledElement<QuestionTextModel> {
     constructor(props: any);
+    protected renderInput(): JSX.Element;
     protected renderElement(): JSX.Element;
 }
 
@@ -666,10 +680,12 @@ export declare class PopupContainer extends SurveyElementBase<any, any> {
     renderPointer(): JSX.Element;
     renderHeader(): JSX.Element;
     renderContent(): JSX.Element;
+    renderCancelButton(): JSX.Element;
+    renderApplyButton(): JSX.Element;
     renderFooter(): JSX.Element;
     render(): JSX.Element;
 }
-export declare function showModal(componentName: string, data: any, onApply: () => boolean, onCancel?: () => void, cssClass?: string, title?: string): void;
+export declare function showModal(componentName: string, data: any, onApply: () => boolean, onCancel?: () => void, cssClass?: string, title?: string, displayMode?: "popup" | "overlay"): void;
 export {};
 
 interface IListProps {
@@ -796,6 +812,7 @@ interface IDimensions {
 export declare class ResponsivityManager {
     protected container: HTMLDivElement;
     protected minDimensionConst: number;
+    protected recalcMinDimensionConst: boolean;
     getComputedStyle: (elt: Element) => CSSStyleDeclaration;
     constructor(container: HTMLDivElement, model: AdaptiveActionContainer, itemsSelector: string, dotsItemSize?: number);
     protected getDimensions(element: HTMLElement): IDimensions;
@@ -913,6 +930,7 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
         protected onEnableItemCallBack(item: ItemValue): boolean;
         protected onAfterRunItemsEnableCondition(): void;
         protected getItemClassCore(item: any, options: any): string;
+        updateValueFromSurvey(newValue: any): void;
         protected setNewValue(newValue: any): void;
         protected getIsMultipleValue(): boolean;
         protected getCommentFromValue(newValue: any): string;
@@ -936,7 +954,6 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
         protected renderedValueFromDataCore(val: any): any;
         protected rendredValueToDataCore(val: any): any;
         get checkBoxSvgPath(): string;
-        getItemId(item: ItemValue): string;
 }
 
 export declare class Bindings {
@@ -1091,6 +1108,7 @@ export declare class Base {
             * @param val new property value
             */
         setPropertyValue(name: string, val: any): void;
+        protected setArrayPropertyDirectly(name: string, val: any, sendNotification?: boolean): void;
         protected setPropertyValueDirectly(name: string, val: any): void;
         protected clearPropertyValue(name: string): void;
         onPropertyValueChangedCallback(name: string, oldValue: any, newValue: any, sender: Base, arrayChanges: ArrayChanges): void;
@@ -1125,7 +1143,7 @@ export declare class Base {
             */
         unRegisterFunctionOnPropertiesValueChanged(names: Array<string>, key?: string): void;
         createCustomLocalizableObj(name: string): void;
-        protected createLocalizableString(name: string, owner: ILocalizableOwner, useMarkDown?: boolean, hasDefaultValue?: boolean): LocalizableString;
+        protected createLocalizableString(name: string, owner: ILocalizableOwner, useMarkDown?: boolean, defaultStr?: boolean | string): LocalizableString;
         getLocalizableString(name: string): LocalizableString;
         getLocalizableStringText(name: string, defaultStr?: string): string;
         setLocalizableStringText(name: string, value: string): void;
@@ -1168,7 +1186,7 @@ export declare class EventBase<T> extends Event<(sender: T, options: any) => any
   * It has two main properties: value and text. If text is empty, value is used for displaying.
   * The text property is localizable and support markdown.
   */
-export declare class ItemValue extends Base {
+export declare class ItemValue extends Base implements IShortcutText {
     protected typeName: string;
     [index: string]: any;
     static get Separator(): string;
@@ -1200,6 +1218,7 @@ export declare class ItemValue extends Base {
     get text(): string;
     set text(newText: string);
     get calculatedText(): string;
+    get shortcutText(): string;
     getData(): any;
     toJSON(): any;
     setData(value: any): void;
@@ -1231,6 +1250,7 @@ export declare class AdaptiveActionContainer<T extends Action = Action> extends
     protected dotsItem: Action;
     protected dotsItemPopupModel: PopupModel;
     minVisibleItemsCount: number;
+    protected invisibleItemsListModel: ListModel;
     constructor();
     protected onSet(): void;
     protected onPush(item: T): void;
@@ -1387,9 +1407,7 @@ export declare class QuestionSelectBase extends Question {
         /**
             *  Use this property to set the place holder text for other or comment field  .
             */
-        get otherPlaceHolder(): string;
-        set otherPlaceHolder(val: string);
-        get locOtherPlaceHolder(): LocalizableString;
+        otherPlaceHolder: string;
         /**
             * The text that shows when the other item is choosed by the other input is empty.
             */
@@ -1478,6 +1496,13 @@ export declare class QuestionSelectBase extends Question {
         choicesLoaded(): void;
         getItemValueWrapperComponentName(item: ItemValue): string;
         getItemValueWrapperComponentData(item: ItemValue): any;
+        ariaItemChecked(item: ItemValue): "true" | "false";
+        isOtherItem(item: ItemValue): boolean;
+        get itemSvgIcon(): string;
+        ariaItemLabel(item: ItemValue): string;
+        getItemId(item: ItemValue): string;
+        get questionName(): string;
+        getItemEnabled(item: ItemValue): any;
 }
 /**
     * A base class for checkbox and radiogroup questions. It introduced a colCount property.
@@ -1493,8 +1518,6 @@ export declare class QuestionCheckboxBase extends QuestionSelectBase {
         protected onParentChanged(): void;
         protected onParentQuestionChanged(): void;
         protected getSearchableItemValueKeys(keys: Array<string>): void;
-        getItemEnabled(item: ItemValue): any;
-        isOtherItem(item: ItemValue): boolean;
 }
 
 export interface ILocalizableOwner {
@@ -1844,6 +1867,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     requiredText: string;
     beforeSettingQuestionErrors(question: IQuestion, errors: Array<SurveyError>): void;
     beforeSettingPanelErrors(question: IPanel, errors: Array<SurveyError>): void;
+    getSurveyErrorCustomText(obj: Base, text: string, error: SurveyError): string;
     getElementTitleTagName(element: Base, tagName: string): string;
     questionTitlePattern: string;
     getUpdatedQuestionTitle(question: IQuestion, title: string): string;
@@ -1903,7 +1927,10 @@ export interface ISurveyImpl {
 export interface IConditionRunner {
     runCondition(values: HashTable<any>, properties: HashTable<any>): any;
 }
-export interface ISurveyElement {
+export interface IShortcutText {
+    shortcutText: string;
+}
+export interface ISurveyElement extends IShortcutText {
     name: string;
     isVisible: boolean;
     isReadOnly: boolean;
@@ -2046,6 +2073,28 @@ export declare class SurveyActionBarItem extends SurveyElementBase<IActionBarIte
 }
 export {};
 
+export declare class ListModel extends ActionContainer {
+    onItemSelect: (item: Action) => void;
+    allowSelection: boolean;
+    needFilter: boolean;
+    isExpanded: boolean;
+    selectedItem: IAction;
+    filteredText: string;
+    static INDENT: number;
+    static MINELEMENTCOUNT: number;
+    constructor(items: Array<IAction>, onItemSelect: (item: Action) => void, allowSelection: boolean, selectedItem?: IAction, onFilteredTextChange?: (text: string) => void);
+    protected onSet(): void;
+    selectItem: (itemValue: Action) => void;
+    isItemDisabled: (itemValue: Action) => boolean;
+    isItemSelected: (itemValue: Action) => boolean;
+    getItemClass: (itemValue: Action) => string;
+    getItemIndent: (itemValue: any) => string;
+    get filteredTextPlaceholder(): any;
+    onKeyDown(event: KeyboardEvent): void;
+    onPointerDown(event: PointerEvent, item: any): void;
+    refresh(): void;
+}
+
 export declare class PopupModel<T = any> extends Base {
     contentComponentName: string;
     contentComponentData: T;
@@ -2059,13 +2108,14 @@ export declare class PopupModel<T = any> extends Base {
     onShow: () => void;
     cssClass: string;
     title: string;
+    displayMode: "popup" | "overlay";
     constructor(contentComponentName: string, contentComponentData: T, verticalPosition?: VerticalPosition, horizontalPosition?: HorizontalPosition, showPointer?: boolean, isModal?: boolean, onCancel?: () => void, onApply?: () => boolean, onHide?: () => void, onShow?: () => void, cssClass?: string, title?: string);
     get isVisible(): boolean;
     set isVisible(value: boolean);
     toggleVisibility(): void;
     onVisibilityChanged: (isVisible: boolean) => void;
 }
-export declare function createPopupModalViewModel(componentName: string, data: any, onApply: () => boolean, onCancel?: () => void, onHide?: () => void, onShow?: () => void, cssClass?: string, title?: string): PopupBaseViewModel;
+export declare function createPopupModalViewModel(componentName: string, data: any, onApply: () => boolean, onCancel?: () => void, onHide?: () => void, onShow?: () => void, cssClass?: string, title?: string, displayMode?: "popup" | "overlay"): PopupBaseViewModel;
 export declare class PopupBaseViewModel extends Base {
     targetElement?: HTMLElement;
     top: string;
@@ -2083,6 +2133,8 @@ export declare class PopupBaseViewModel extends Base {
     get contentComponentData(): any;
     get showPointer(): boolean;
     get isModal(): boolean;
+    get showFooter(): boolean;
+    get isOverlay(): boolean;
     get styleClass(): string;
     onKeyDown(event: any): void;
     updateOnShowing(): void;
@@ -2182,6 +2234,10 @@ export interface IAction {
             * Set it to true to make the tabIndex -1 to disable keyboard navigation to this item
             */
         disableTabStop?: boolean;
+        /**
+            * Set it to false to force action "large" mode even if has icon and does not fit to action bar space
+            */
+        disableShrink?: boolean;
         /**
             * Action button display mode
             */
@@ -2214,6 +2270,7 @@ export declare class Action extends Base implements IAction {
         visibleIndex: number;
         mode: "large" | "small" | "popup";
         disableTabStop: boolean;
+        disableShrink: boolean;
         get disabled(): boolean;
         get hasTitle(): boolean;
         get isVisible(): boolean;
@@ -2287,6 +2344,8 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
             */
         onReadyChanged: EventBase<Question>;
         isReadOnlyRenderDiv(): boolean;
+        get isErrorsModeTooltip(): boolean;
+        get hasParent(): boolean;
         constructor(name: string);
         protected createLocTitleProperty(): LocalizableString;
         getSurvey(live?: boolean): ISurvey;
@@ -2307,9 +2366,9 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
         /**
             * A11Y properties
             */
-        get ariaRequired(): boolean;
+        get ariaRequired(): "true" | "false";
         get ariaLabel(): string;
-        get ariaInvalid(): boolean;
+        get ariaInvalid(): "true" | "false";
         get ariaDescribedBy(): string;
         /**
             * Get is question ready to use
@@ -2536,6 +2595,7 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
             */
         get renderWidth(): string;
         set renderWidth(val: string);
+        get renderCssRoot(): string;
         /**
             * Set it different from 0 to increase the left padding.
             */
@@ -2602,6 +2662,8 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
             */
         get isReadOnly(): boolean;
         get isInputReadOnly(): boolean;
+        get renderedInputReadOnly(): string;
+        get renderedInputDisabled(): string;
         protected onReadOnlyChanged(): void;
         /**
             * An expression that returns true or false. If it returns false the Question becomes read only and an end-user will not able to answer on the qustion. The library runs the expression on survey start and on changing a question value. If the property is empty then readOnly property is used.
@@ -2648,6 +2710,10 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
         createValueCopy(): any;
         protected getUnbindValue(value: any): any;
         protected isValueSurveyElement(val: any): boolean;
+        /**
+            * Return true if there is a parent (page or panel) and it is visible
+            */
+        get isParentVisible(): boolean;
         clearValueIfInvisible(): void;
         get displayValue(): any;
         /**
@@ -2666,6 +2732,7 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
         set defaultValue(val: any);
         get defaultValueExpression(): any;
         set defaultValueExpression(val: any);
+        get resizeStyle(): "none" | "both";
         /**
             * Returns question answer data as a plain object: with question title, name, value and displayValue.
             * For complex questions (like matrix, etc.) isNode flag is set to true and data contains array of nested objects (rows)
@@ -3306,6 +3373,10 @@ export declare class PopupUtils {
         height: number;
         top: number;
     };
+    static updateHorizontalDimensions(left: number, width: number, windowWidth: number, horizontalPosition: HorizontalPosition): {
+        width: number;
+        left: number;
+    };
     static updateVerticalPosition(targetRect: ClientRect, height: number, verticalPosition: VerticalPosition, showPointer: boolean, windowHeight: number): VerticalPosition;
     static calculatePopupDirection(verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition): string;
     static calculatePointerTarget(targetRect: ClientRect, top: number, left: number, verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition): INumberPosition;
@@ -3366,6 +3437,7 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
         stateChangedCallback: () => void;
         static getProgressInfoByElements(children: Array<SurveyElement>, isRequired: boolean): IProgressInfo;
         dragTypeOverMe: DragTypeOverMeEnum;
+        isDragMe: boolean;
         readOnlyChangedCallback: () => void;
         static ScrollElementToTop(elementId: string): boolean;
         static GetFirstNonTextElement(elements: any, removeSpaces?: boolean): any;
@@ -3411,6 +3483,7 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
             */
         toggleState(): boolean;
         get hasStateButton(): boolean;
+        get shortcutText(): string;
         getTitleToolbar(): AdaptiveActionContainer;
         get titleActions(): Array<any>;
         getTitleActions(): Array<any>;
@@ -3593,7 +3666,7 @@ export declare class NumericValidator extends SurveyValidator {
     * Validate text values.
     */
 export declare class TextValidator extends SurveyValidator {
-        constructor(minLength?: number, maxLength?: number, allowDigits?: boolean);
+        constructor();
         getType(): string;
         validate(value: any, name?: string, values?: any, properties?: any): ValidatorResult;
         protected getDefaultErrorText(name: string): any;
@@ -3685,7 +3758,6 @@ export declare class TextPreProcessorValue {
 }
 export declare class TextPreProcessor {
     onProcess: (textValue: TextPreProcessorValue) => void;
-    constructor();
     process(text: string, returnDisplayValue?: boolean, doEncoding?: boolean): string;
     processValue(name: string, returnDisplayValue: boolean): TextPreProcessorValue;
     get hasAllValuesOnLastRun(): boolean;
@@ -4022,6 +4094,7 @@ export declare class PanelModelBase extends SurveyElement implements IPanel, ICo
         protected createRow(): QuestionRowModel;
         onSurveyLoad(): void;
         onFirstRendering(): void;
+        updateRows(): void;
         get rows(): Array<QuestionRowModel>;
         ensureRowsVisibility(): void;
         protected onRowsChanged(): void;
@@ -4134,8 +4207,6 @@ export declare class PanelModelBase extends SurveyElement implements IPanel, ICo
     * It may contain questions and other panels.
     */
 export declare class PanelModel extends PanelModelBase implements IElement {
-        minWidth?: string;
-        maxWidth?: string;
         constructor(name?: string);
         getType(): string;
         get contentId(): string;
@@ -4207,6 +4278,16 @@ export declare class PanelModel extends PanelModelBase implements IElement {
             */
         get width(): string;
         set width(val: string);
+        /**
+            * Use it to set the specific minWidth constraint to the panel like css style (%, px, em etc).
+            */
+        get minWidth(): string;
+        set minWidth(val: string);
+        /**
+            * Use it to set the specific maxWidth constraint to the panel like css style (%, px, em etc).
+            */
+        get maxWidth(): string;
+        set maxWidth(val: string);
         /**
             * The left indent. Set this property to increase the panel left indent.
             */