survey-creator-core 1.9.111 → 1.9.112

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.
Files changed (119) hide show
  1. package/fonts.fontless.css +1 -1
  2. package/fonts.fontless.min.css +1 -1
  3. package/i18n/arabic.js +1717 -0
  4. package/i18n/arabic.js.map +1 -0
  5. package/i18n/arabic.min.js +7 -0
  6. package/i18n/bulgarian.js +1354 -0
  7. package/i18n/bulgarian.js.map +1 -0
  8. package/i18n/bulgarian.min.js +7 -0
  9. package/i18n/croatian.js +1801 -0
  10. package/i18n/croatian.js.map +1 -0
  11. package/i18n/croatian.min.js +7 -0
  12. package/i18n/czech.js +1356 -0
  13. package/i18n/czech.js.map +1 -0
  14. package/i18n/czech.min.js +7 -0
  15. package/i18n/danish.js +1992 -0
  16. package/i18n/danish.js.map +1 -0
  17. package/i18n/danish.min.js +7 -0
  18. package/i18n/dutch.js +1787 -0
  19. package/i18n/dutch.js.map +1 -0
  20. package/i18n/dutch.min.js +7 -0
  21. package/i18n/english.js +1244 -0
  22. package/i18n/english.js.map +1 -0
  23. package/i18n/english.min.js +7 -0
  24. package/i18n/finnish.js +1807 -0
  25. package/i18n/finnish.js.map +1 -0
  26. package/i18n/finnish.min.js +7 -0
  27. package/i18n/french.js +1864 -0
  28. package/i18n/french.js.map +1 -0
  29. package/i18n/french.min.js +7 -0
  30. package/i18n/german.js +1527 -0
  31. package/i18n/german.js.map +1 -0
  32. package/i18n/german.min.js +7 -0
  33. package/i18n/hungarian.js +1961 -0
  34. package/i18n/hungarian.js.map +1 -0
  35. package/i18n/hungarian.min.js +7 -0
  36. package/i18n/index.js +45735 -0
  37. package/i18n/index.js.map +1 -0
  38. package/i18n/index.min.js +7 -0
  39. package/i18n/indonesian.js +1961 -0
  40. package/i18n/indonesian.js.map +1 -0
  41. package/i18n/indonesian.min.js +7 -0
  42. package/i18n/italian.js +1549 -0
  43. package/i18n/italian.js.map +1 -0
  44. package/i18n/italian.min.js +7 -0
  45. package/i18n/japanese.js +1806 -0
  46. package/i18n/japanese.js.map +1 -0
  47. package/i18n/japanese.min.js +7 -0
  48. package/i18n/korean.js +2011 -0
  49. package/i18n/korean.js.map +1 -0
  50. package/i18n/korean.min.js +7 -0
  51. package/i18n/malay.js +1760 -0
  52. package/i18n/malay.js.map +1 -0
  53. package/i18n/malay.min.js +7 -0
  54. package/i18n/mongolian.js +1448 -0
  55. package/i18n/mongolian.js.map +1 -0
  56. package/i18n/mongolian.min.js +7 -0
  57. package/i18n/norwegian.js +1811 -0
  58. package/i18n/norwegian.js.map +1 -0
  59. package/i18n/norwegian.min.js +7 -0
  60. package/i18n/persian.js +1746 -0
  61. package/i18n/persian.js.map +1 -0
  62. package/i18n/persian.min.js +7 -0
  63. package/i18n/polish.js +2079 -0
  64. package/i18n/polish.js.map +1 -0
  65. package/i18n/polish.min.js +7 -0
  66. package/i18n/portuguese.js +1457 -0
  67. package/i18n/portuguese.js.map +1 -0
  68. package/i18n/portuguese.min.js +7 -0
  69. package/i18n/russian.js +1868 -0
  70. package/i18n/russian.js.map +1 -0
  71. package/i18n/russian.min.js +7 -0
  72. package/i18n/simplified-chinese.js +1948 -0
  73. package/i18n/simplified-chinese.js.map +1 -0
  74. package/i18n/simplified-chinese.min.js +7 -0
  75. package/i18n/slovak.js +1760 -0
  76. package/i18n/slovak.js.map +1 -0
  77. package/i18n/slovak.min.js +7 -0
  78. package/i18n/spanish.js +1573 -0
  79. package/i18n/spanish.js.map +1 -0
  80. package/i18n/spanish.min.js +7 -0
  81. package/i18n/swedish.js +1985 -0
  82. package/i18n/swedish.js.map +1 -0
  83. package/i18n/swedish.min.js +7 -0
  84. package/i18n/tajik.js +1037 -0
  85. package/i18n/tajik.js.map +1 -0
  86. package/i18n/tajik.min.js +7 -0
  87. package/i18n/traditional-chinese.js +2084 -0
  88. package/i18n/traditional-chinese.js.map +1 -0
  89. package/i18n/traditional-chinese.min.js +7 -0
  90. package/i18n/turkish.js +1802 -0
  91. package/i18n/turkish.js.map +1 -0
  92. package/i18n/turkish.min.js +7 -0
  93. package/package.json +2 -2
  94. package/survey-creator-core.css +10 -3
  95. package/survey-creator-core.fontless.css +9 -2
  96. package/survey-creator-core.fontless.css.map +1 -1
  97. package/survey-creator-core.fontless.min.css +2 -2
  98. package/survey-creator-core.i18n.js +2171 -99
  99. package/survey-creator-core.i18n.js.map +1 -1
  100. package/survey-creator-core.i18n.min.js +2 -2
  101. package/survey-creator-core.js +866 -485
  102. package/survey-creator-core.js.map +1 -1
  103. package/survey-creator-core.min.css +3 -3
  104. package/survey-creator-core.min.js +5 -5
  105. package/typings/components/tabs/designer-plugin.d.ts +1 -0
  106. package/typings/components/tabs/logic-actions-model.d.ts +9 -1
  107. package/typings/components/tabs/test-plugin.d.ts +2 -0
  108. package/typings/components/tabs/theme-builder.d.ts +7 -0
  109. package/typings/components/tabs/theme-plugin.d.ts +7 -0
  110. package/typings/components/tabs/themes.d.ts +1 -0
  111. package/typings/creator-base.d.ts +134 -109
  112. package/typings/creator-settings.d.ts +2 -0
  113. package/typings/custom-questions/question-file.d.ts +5 -0
  114. package/typings/editorLocalization.d.ts +20 -9
  115. package/typings/localization/english.d.ts +20 -9
  116. package/typings/plugins/undo-redo/undo-redo-manager.d.ts +3 -0
  117. package/typings/property-grid/index.d.ts +1 -5
  118. package/typings/property-grid/matrices.d.ts +4 -3
  119. package/typings/questionconverter.d.ts +4 -3
@@ -11,6 +11,7 @@ export declare class TabDesignerPlugin implements ICreatorPlugin {
11
11
  private surveySettingsAction;
12
12
  private saveSurveyAction;
13
13
  previewAction: Action;
14
+ private designerAction;
14
15
  private get isSurveySelected();
15
16
  private get isSettingsActive();
16
17
  private createVisibleUpdater;
@@ -20,13 +20,21 @@ export declare class LogicActionModelBase {
20
20
  export declare class LogicActionModel extends LogicActionModelBase {
21
21
  private selectorElementsHash;
22
22
  private getSelectorOptionsText;
23
- private getElementBySelectorName;
23
+ protected getElementBySelectorName(panel: PanelModel): Base;
24
24
  constructor(panel: PanelModel, logicAction: SurveyLogicAction, logicType: SurveyLogicType, selectorElementsHash: any);
25
25
  updateCurrentLogicAction(survey: SurveyModel): boolean;
26
26
  resetElements(): void;
27
27
  updatePanelElements(selectedElement: string, choices: Array<ItemValue>): void;
28
28
  getSelectedElement(): string;
29
29
  }
30
+ export declare class LogicActionSetValueModel extends LogicActionModel {
31
+ updatePanelElements(selectedElement: string, choices: Array<ItemValue>): void;
32
+ afterUpdateInitialLogicAction(): void;
33
+ private setValueExpressionValue;
34
+ private getValueIfPanel;
35
+ private getValueIfQuestion;
36
+ resetElements(): void;
37
+ }
30
38
  export declare class LogicActionTriggerModel extends LogicActionModelBase {
31
39
  private panelObj;
32
40
  isTrigger: boolean;
@@ -12,6 +12,7 @@ export declare class TabTestPlugin implements ICreatorPlugin {
12
12
  private invisibleToggleAction;
13
13
  private testAgainAction;
14
14
  private designerAction;
15
+ private previewAction;
15
16
  private prevPageAction;
16
17
  private nextPageAction;
17
18
  private simulatorTheme;
@@ -21,6 +22,7 @@ export declare class TabTestPlugin implements ICreatorPlugin {
21
22
  private getLanguages;
22
23
  private updateActions;
23
24
  private setPreviewTheme;
25
+ private createVisibleUpdater;
24
26
  constructor(creator: CreatorBase);
25
27
  activate(): void;
26
28
  update(): void;
@@ -7,6 +7,7 @@ export declare class ThemeBuilder extends Base {
7
7
  private startThemeClasses;
8
8
  private json;
9
9
  pages: ActionContainer;
10
+ prevPageAction: Action;
10
11
  testAgainAction: Action;
11
12
  nextPageAction: Action;
12
13
  undoRedoManager: UndoRedoManager;
@@ -62,6 +63,7 @@ export declare class ThemeBuilder extends Base {
62
63
  selectTheme(themeName: string, themePalette?: string, themeMode?: string): void;
63
64
  updateSimulatorSurvey(json: any, theme: any): void;
64
65
  setJSON(json: any, currTheme: any): void;
66
+ private creatorPropertyChanged;
65
67
  private blockThemeChangedNotifications;
66
68
  initialize(json: any, options: any): void;
67
69
  private updatePageItem;
@@ -71,6 +73,8 @@ export declare class ThemeBuilder extends Base {
71
73
  private updatePageList;
72
74
  show(): void;
73
75
  testAgain(): void;
76
+ buildActions(): void;
77
+ private updatePrevNextPageActionState;
74
78
  get availableThemes(): string[];
75
79
  set availableThemes(availebleThemes: string[]);
76
80
  private setActivePageItem;
@@ -88,6 +92,9 @@ export declare class ThemeBuilder extends Base {
88
92
  private setCoverCssVariables;
89
93
  private loadThemeIntoPropertyGrid;
90
94
  private getBackgroundColorSwitchByValue;
95
+ private updateVisibilityOfPropertyGridGroups;
96
+ private setCoverPropertiesFromSurvey;
97
+ private setCoverColorsFromThemeVariables;
91
98
  private updateHeaderViewContainerEditors;
92
99
  private updatePropertyGridEditorsAvailability;
93
100
  private updatePropertyGridEditors;
@@ -3,7 +3,12 @@ import { CreatorBase, ICreatorPlugin } from "../../creator-base";
3
3
  import { ThemeBuilder } from "./theme-builder";
4
4
  export declare class ThemeTabPlugin implements ICreatorPlugin {
5
5
  private creator;
6
+ private previewAction;
7
+ private invisibleToggleAction;
6
8
  private testAgainAction;
9
+ private designerAction;
10
+ private prevPageAction;
11
+ private nextPageAction;
7
12
  private themeSettingsAction;
8
13
  private resetTheme;
9
14
  private importAction;
@@ -15,6 +20,7 @@ export declare class ThemeTabPlugin implements ICreatorPlugin {
15
20
  private sidebarTab;
16
21
  private _availableThemes;
17
22
  model: ThemeBuilder;
23
+ private createVisibleUpdater;
18
24
  constructor(creator: CreatorBase);
19
25
  activate(): void;
20
26
  update(): void;
@@ -31,6 +37,7 @@ export declare class ThemeTabPlugin implements ICreatorPlugin {
31
37
  set availableThemes(availebleThemes: string[]);
32
38
  addTheme(theme: ITheme): string;
33
39
  removeTheme(fullThemeName: string): void;
40
+ getThemeChanges(): ITheme;
34
41
  onThemeSelected: EventBase<ThemeTabPlugin, {
35
42
  theme: ITheme;
36
43
  }>;
@@ -24,3 +24,4 @@ export declare const PredefinedColors: {
24
24
  green: string;
25
25
  };
26
26
  };
27
+ export declare function findSuitableTheme(themeName: string, probeThemeFullName: string): ITheme;
@@ -72,23 +72,24 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
72
72
  * Specifies whether to display the Designer tab.
73
73
  *
74
74
  * Default value: `true`
75
+ * @see activeTab
76
+ * @see onDesignerSurveyCreated
75
77
  */
76
78
  showDesignerTab: boolean;
77
79
  /**
78
80
  * Specifies whether to display the JSON Editor tab.
79
81
  *
80
82
  * Default value: `true`
83
+ * @see activeTab
81
84
  */
82
85
  showJSONEditorTab: boolean;
83
- /**
84
- * Obsolete. Please use showPreviewTab property
85
- * @see showPreviewTab
86
- */
87
86
  showTestSurveyTab: boolean;
88
87
  /**
89
88
  * Specifies whether to display the Preview tab.
90
89
  *
91
90
  * Default value: `true`
91
+ * @see activeTab
92
+ * @see onPreviewSurveyCreated
92
93
  */
93
94
  get showPreviewTab(): boolean;
94
95
  set showPreviewTab(val: boolean);
@@ -96,36 +97,39 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
96
97
  * Specifies whether to display the Themes tab.
97
98
  *
98
99
  * Default value: `false`
100
+ * @see activeTab
101
+ * @see saveThemeFunc
99
102
  */
100
103
  showThemeTab: boolean;
101
104
  /**
102
105
  * Specifies whether to display the Translation tab.
103
106
  *
104
107
  * Default value: `false`
108
+ * @see activeTab
105
109
  */
106
110
  showTranslationTab: boolean;
107
111
  /**
108
112
  * Specifies whether to display the Logic tab.
109
113
  *
110
114
  * Default value: `false`
115
+ * @see activeTab
111
116
  */
112
117
  showLogicTab: boolean;
113
118
  useTableViewInLogicTab: boolean;
114
- /**
115
- * Set delay for page hover
116
- */
117
119
  pageHoverDelay: number;
118
120
  /**
119
- * You need to set this property to true if you want to inplace edit item values instead of texts.
121
+ * Allows users to edit choice values instead of choice texts on the design surface.
122
+ *
123
+ * Default value: `false` (users edit choice texts)
124
+ *
125
+ * If you enable this property, users cannot edit choice texts because the Property Grid hides the Text column for choices, rate values, columns and rows in [Single-Select Matrix](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-question-model), and rows in [Multi-Select Matrix](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list) questions.
126
+ * @see showObjectTitles
120
127
  */
121
128
  inplaceEditForValues: boolean;
122
- /**
123
- * Obsolete. Use the [`showSurveyTitle`](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#showSurveyTitle) property instead.
124
- */
125
129
  get allowEditSurveyTitle(): boolean;
126
130
  set allowEditSurveyTitle(val: boolean);
127
131
  /**
128
- * Specifies whether users can see and edit the survey title and related survey properties.
132
+ * Specifies whether users can see and edit the survey header and related survey properties.
129
133
  *
130
134
  * Default value: `true`
131
135
  */
@@ -135,9 +139,11 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
135
139
  set haveCommercialLicense(val: boolean);
136
140
  get licenseText(): string;
137
141
  /**
138
- * Specifies whether to call the [saveSurveyFunc](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#saveSurveyFunc) each time survey settings are changed.
142
+ * Specifies whether to automatically save a survey or theme JSON schema each time survey or theme settings are changed.
139
143
  *
140
144
  * Default value: `false`
145
+ *
146
+ * If you enable this property, Survey Creator calls the [`saveSurveyFunc`](#saveSurveyFunc) or [`saveThemeFunc`](#saveThemeFunc) function to save the survey or theme JSON schema. The schemas are saved with a 500-millisecond delay after users change settings. You can specify the [`autoSaveDelay`](#autoSaveDelay) property to increase or descrease the delay.
141
147
  */
142
148
  isAutoSave: boolean;
143
149
  showOptions: boolean;
@@ -163,7 +169,19 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
163
169
  private changePageModifications;
164
170
  private pageEditModeValue;
165
171
  /**
166
- * Contains the value of the [`pageEditMode`](https://surveyjs.io/Documentation/Survey-Creator?id=ICreatorOptions#pageEditMode) property specified in the constructor.
172
+ * Specifies how Survey Creator users edit survey pages.
173
+ *
174
+ * Accepted values:
175
+ *
176
+ * - `"standard"` (default)
177
+ * Questions and panels are divided between pages. Users can scroll the design surface to reach a required page.
178
+ *
179
+ * - `"single"`
180
+ * All questions and panels belong to a single page. Users cannot add or remove pages.
181
+ *
182
+ * - `"bypage"`
183
+ * Questions and panels are divided between pages. Users can use the page navigator to switch to a required page.
184
+ * @see allowModifyPages
167
185
  */
168
186
  get pageEditMode(): "standard" | "single" | "bypage";
169
187
  set pageEditMode(val: "standard" | "single" | "bypage");
@@ -180,16 +198,6 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
180
198
  private saveSurveyFuncValue;
181
199
  private saveThemeFuncValue;
182
200
  viewType: string;
183
- /**
184
- * Returns the current show view name. The possible returns values are:
185
- * "designer", "editor", "test", "embed", "logic" and "translation".
186
- * @see showDesigner
187
- * @see showPreview
188
- * @see showJsonEditor
189
- * @see showLogicEditor
190
- * @see showTranslationEditor
191
- * @see showEmbedEditor
192
- */
193
201
  get showingViewName(): string;
194
202
  get isDesignerShowing(): boolean;
195
203
  showDesigner(): void;
@@ -505,7 +513,6 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
505
513
  * - `options.questionName`: `String`\
506
514
  * The name of a question for which conditions are displayed.
507
515
  * - `options.questionName`: `String`\
508
- * The type of a question for which conditions are displayed.
509
516
  * The name of a question for which conditions are displayed.
510
517
  * - `options.operator`: `"empty"` | `"notempty"` | `"equal"` | `"notequal"` | `"contains"` | `"notcontains"` | `"anyof"` | `"allof"` | `"greater"` | `"less"` | `"greaterorequal"` | `"lessorequal"`\
511
518
  * A condition opeator for which the event is raised.
@@ -585,24 +592,50 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
585
592
  */
586
593
  onModified: CreatorEvent;
587
594
  /**
588
- * The event is called on adding a new question into the survey. Typically, when a user dropped a Question from the Question Toolbox into designer Survey area.
589
- *- sender the survey creator object that fires the event
590
- *- options.question a new added survey question. Survey.Question object
591
- *- options.page the survey Page object where question has been added.
592
- *- options.reason how question has been added via UI: ADDED_FROM_TOOLBOX, ADDED_FROM_PAGEBUTTON, ELEMENT_COPIED.
595
+ * An event that is raised when users add a question to the survey. Use this event to customize the question.
596
+ *
597
+ * Parameters:
598
+ *
599
+ * - `sender`: `CreatorBase`\
600
+ * A Survey Creator instance that raised the event.
601
+ * - `options.question`: [`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\
602
+ * The question users added.
603
+ * - `options.page`: [`PageModel`](https://surveyjs.io/form-library/documentation/api-reference/page-model)\
604
+ * A page to which the question was added.
605
+ * - `options.reason`: `"DROPPED_FROM_TOOLBOX"` | `"ADDED_FROM_PAGEBUTTON"` | `"ELEMENT_COPIED"`\
606
+ * A value that indicates how the question was added: dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox-customization), created using the Add Question button, or duplicated.
607
+ *
608
+ * [Customize Survey Elements on Creation](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#customize-survey-elements-on-creation (linkStyle))
593
609
  */
594
610
  onQuestionAdded: CreatorEvent;
595
611
  /**
596
- * The event is called on adding a new panel into the survey. Typically, when a user dropped a Panel from the Question Toolbox into designer Survey area.
597
- *- sender the survey creator object that fires the event
598
- *- options.panel a new added survey panel. Survey.Panel object
599
- *- options.page the survey Page object where question has been added.
612
+ * An event that is raised when users add a [Panel](https://surveyjs.io/form-library/documentation/api-reference/panel-model) element to the survey. Use this event to customize the panel.
613
+ *
614
+ * Parameters:
615
+ *
616
+ * - `sender`: `CreatorBase`\
617
+ * A Survey Creator instance that raised the event.
618
+ * - `options.panel`: [`PanelModel`](https://surveyjs.io/form-library/documentation/api-reference/panel-model)\
619
+ * The panel users added.
620
+ * - `options.page`: [`PageModel`](https://surveyjs.io/form-library/documentation/api-reference/page-model)\
621
+ * A page to which the panel was added.
622
+ * - `options.reason`: `"DROPPED_FROM_TOOLBOX"` | `"ADDED_FROM_PAGEBUTTON"` | `"ELEMENT_COPIED"`\
623
+ * A value that indicates how the panel was added: dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox-customization), created using the Add Question button, or duplicated.
624
+ *
625
+ * [Customize Survey Elements on Creation](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#customize-survey-elements-on-creation (linkStyle))
600
626
  */
601
627
  onPanelAdded: CreatorEvent;
602
628
  /**
603
- * The event is called on adding a new page into the survey.
604
- *- sender the survey creator object that fires the event
605
- *- options.page the new survey Page object.
629
+ * An event that is raised when a new page is added to the survey. Use this event to customize the page.
630
+ *
631
+ * Parameters:
632
+ *
633
+ * - `sender`: `CreatorBase`\
634
+ * A Survey Creator instance that raised the event.
635
+ * - `options.page`: [`PageModel`](https://surveyjs.io/form-library/documentation/api-reference/page-model)\
636
+ * The page users added.
637
+ *
638
+ * [Customize Survey Elements on Creation](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#customize-survey-elements-on-creation (linkStyle))
606
639
  */
607
640
  onPageAdded: CreatorEvent;
608
641
  /**
@@ -621,21 +654,35 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
621
654
  */
622
655
  onGetPageActions: CreatorEvent;
623
656
  /**
624
- * The event is fired when the survey creator is initialized and a survey object (Survey.Survey) is created.
625
- *- sender the survey creator object that fires the event
626
- *- options.survey the survey object showing in the creator.
657
+ * An event that is raised when Survey Creator instantiates a survey for the [Designer](https://surveyjs.io/survey-creator/documentation/end-user-guide#designer-tab) tab. Use this event to customize the survey.
658
+ *
659
+ * Parameters:
660
+ *
661
+ * - `sender`: `CreatorBase`\
662
+ * A Survey Creator instance that raised the event.
663
+ * - `options.survey`: [`SurveyModel`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model)\
664
+ * A survey to be displayed in the Designer tab.
665
+ *
666
+ * [Design Mode Survey Instance](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#design-mode-survey-instance (linkStyle))
667
+ *
668
+ * > If you want this event raised at startup, assign a survey JSON schema to the [`JSON`](#JSON) property *after* you add a handler to the event. If the JSON schema should be empty, specify the `JSON` property with an empty object.
627
669
  */
628
670
  onDesignerSurveyCreated: CreatorEvent;
629
671
  /**
630
- * The event is fired when the survey creator creates survey in Preview tab for testing.
631
- *- sender the survey creator object that fires the event
632
- *- options.survey the survey object showing in the "Preview" tab.
672
+ * An event that is raised when Survey Creator instantiates a survey for the [Preview](https://surveyjs.io/survey-creator/documentation/end-user-guide#preview-tab) tab. Use this event to customize the survey.
673
+ *
674
+ * Parameters:
675
+ *
676
+ * - `sender`: `CreatorBase`\
677
+ * A Survey Creator instance that raised the event.
678
+ * - `options.survey`: [`SurveyModel`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model)\
679
+ * A survey to be displayed in the Preview tab.
680
+ *
681
+ * [Preview Mode Survey Instance](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#preview-mode-survey-instance (linkStyle))
682
+ *
683
+ * > If you want this event raised at startup, assign a survey JSON schema to the [`JSON`](#JSON) property *after* you add a handler to the event. If the JSON schema should be empty, specify the `JSON` property with an empty object.
633
684
  */
634
685
  onPreviewSurveyCreated: CreatorEvent;
635
- /**
636
- * Obsolete. Please use onPreviewSurveyCreated event.
637
- * @see onPreviewSurveyCreated
638
- */
639
686
  onTestSurveyCreated: CreatorEvent;
640
687
  /**
641
688
  * The event is called in case of UI notifications. By default all notifications are done via built-in alert () function.
@@ -864,23 +911,17 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
864
911
  * Default value: -1 (unlimited)
865
912
  */
866
913
  maxNestedPanels: number;
867
- /**
868
- * Obsolete. Use the [`showPagesInPreviewTab`](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#showPagesInPreviewTab) property instead.
869
- */
870
914
  showPagesInTestSurveyTab: boolean;
871
915
  /**
872
- * Specifies whether to show the page selector at the bottom of the Preview tab.
916
+ * Specifies whether to show a page selector at the bottom of the Preview tab.
873
917
  *
874
918
  * Default value: `true`
875
919
  */
876
920
  get showPagesInPreviewTab(): boolean;
877
921
  set showPagesInPreviewTab(val: boolean);
878
- /**
879
- * Obsolete. Use the [`showSimulatorInPreviewTab`](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#showSimulatorInPreviewTab) property instead.
880
- */
881
922
  showSimulatorInTestSurveyTab: boolean;
882
923
  /**
883
- * Specifies whether the Preview tab displays the Device button that allows users to preview the survey on different device types.
924
+ * Specifies whether the Preview tab displays a Device button that allows users to preview the survey on different device types.
884
925
  *
885
926
  * Default value: `true`
886
927
  */
@@ -892,6 +933,7 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
892
933
  * Accepted values: `"modern"`, `"default"`, `"defaultV2"`
893
934
  *
894
935
  * Default value: `"defaultV2"`
936
+ * @see allowChangeThemeInPreview
895
937
  */
896
938
  themeForPreview: string;
897
939
  hasPendingThemeChanges: boolean;
@@ -899,21 +941,20 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
899
941
  private _theme;
900
942
  get theme(): ITheme;
901
943
  set theme(newTheme: ITheme);
944
+ getCurrentTheme(content?: "full" | "changes"): ITheme;
902
945
  raiseThemeChanged(): void;
903
946
  private _allowModifyPages;
904
947
  /**
905
948
  * Specifies whether users can add, edit, and delete survey pages.
906
949
  *
907
950
  * Default value: `true`
951
+ * @see pageEditMode
908
952
  */
909
953
  get allowModifyPages(): boolean;
910
954
  set allowModifyPages(val: boolean);
911
- /**
912
- * Obsolete. Use the [`showDefaultLanguageInPreviewTab`](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#showDefaultLanguageInPreviewTab) property instead.
913
- */
914
955
  showDefaultLanguageInTestSurveyTab: boolean | string;
915
956
  /**
916
- * Specifies whether the Preview tab displays the language selector.
957
+ * Specifies whether the Preview tab displays a language selector.
917
958
  *
918
959
  * Accepted values:
919
960
  *
@@ -921,7 +962,7 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
921
962
  * Display the language selector only if the survey is translated into more than one language.
922
963
  *
923
964
  * - `true`
924
- * Always display the language selector regardless of how many languages are used in the survey.
965
+ * Always display the language selector regardless of how many languages the survey uses.
925
966
  *
926
967
  * - `false`
927
968
  * Never display the language selector.
@@ -929,16 +970,13 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
929
970
  * - `"all"`
930
971
  * Always display the language selector with [all supported languages](https://github.com/surveyjs/survey-creator/tree/master/packages/survey-creator-core/src/localization).
931
972
  *
932
- * **See also**: [Localization & Globalization](https://surveyjs.io/Documentation/Survey-Creator?id=localization)
973
+ * [Localization & Globalization](https://surveyjs.io/survey-creator/documentation/survey-localization-translate-surveys-to-different-languages (linkStyle))
933
974
  */
934
975
  get showDefaultLanguageInPreviewTab(): boolean | string;
935
976
  set showDefaultLanguageInPreviewTab(val: boolean | string);
936
- /**
937
- * Obsolete. Use the [`showInvisibleElementsInPreviewTab`](https://surveyjs.io/Documentation/Survey-Creator?id=surveycreator#showInvisibleElementsInPreviewTab) property instead.
938
- */
939
977
  showInvisibleElementsInTestSurveyTab: boolean;
940
978
  /**
941
- * Specifies whether the Preview tab displays a checkbox that allows users to show or hide invisible survey elements.
979
+ * Specifies whether the Preview tab displays a toggle that allows users to show or hide invisible survey elements.
942
980
  *
943
981
  * Default value: `true`
944
982
  */
@@ -954,6 +992,7 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
954
992
  * Default value: `true`
955
993
  *
956
994
  * [View Demo](https://surveyjs.io/Examples/Creator?id=theme-switcher (linkStyle))
995
+ * @see themeForPreview
957
996
  */
958
997
  allowChangeThemeInPreview: boolean;
959
998
  tabbedMenu: AdaptiveActionContainer<TabbedMenuItem>;
@@ -1000,10 +1039,11 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
1000
1039
  *
1001
1040
  * - `sender`: `CreatorBase`\
1002
1041
  * A Survey Creator instance that raised the event.
1003
- * - `options.tabName`: `"designer"` | `"test"` | `"theme"` | `"editor"` | `"embed"` | `"logic"` | `"translation"`\
1042
+ * - `options.tabName`: `"designer"` | `"test"` | `"theme"` | `"editor"` | `"logic"` | `"translation"`\
1004
1043
  * A tab that is going to become active.
1005
1044
  * - `options.allow`: `Boolean`\
1006
1045
  * Specifies whether the active tab can be switched. Set this property to `false` if you want to cancel the switch.
1046
+ * @see makeNewViewActive
1007
1047
  */
1008
1048
  onActiveTabChanging: CreatorEvent;
1009
1049
  /**
@@ -1013,22 +1053,32 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
1013
1053
  *
1014
1054
  * - `sender`: `CreatorBase`\
1015
1055
  * A Survey Creator instance that raised the event.
1016
- * - `options.tabName`: `"designer"` | `"test"` | `"theme"` | `"editor"` | `"embed"` | `"logic"` | `"translation"`\
1056
+ * - `options.tabName`: `"designer"` | `"test"` | `"theme"` | `"editor"` | `"logic"` | `"translation"`\
1017
1057
  * A tab that has become active.
1058
+ * @see makeNewViewActive
1018
1059
  */
1019
1060
  onActiveTabChanged: CreatorEvent;
1020
1061
  /**
1021
- * Get/set the active tab.
1022
- * The following values are available: "designer", "editor", "test", "embed", "logic" and "translation".
1023
- * Please note, not all tabs are visible.
1062
+ * Gets or sets the currently displayed tab.
1063
+ *
1064
+ * Possible values:
1065
+ *
1066
+ * - [`"designer"`](#showDesignerTab)
1067
+ * - [`"test"`](#showPreviewTab)
1068
+ * - [`"theme"`](#showThemeTab)
1069
+ * - [`"editor"`](#showJSONEditorTab)
1070
+ * - [`"logic"`](#showLogicTab)
1071
+ * - [`"translation"`](#showLogicTab)
1072
+ * @see makeNewViewActive
1024
1073
  */
1025
1074
  get activeTab(): string;
1026
1075
  set activeTab(val: string);
1027
1076
  /**
1028
- * Change the active view/tab. It will return false if it can't change the current tab.
1029
- * @param viewName name of new active view (tab). The following values are available: "designer", "editor", "test", "embed", "logic" and "translation".
1077
+ * Switches the [active tab](#activeTab). Returns `false` if the tab cannot be switched.
1078
+ * @param tabName A tab that you want to make active: `"designer"`, `"test"`, `"theme"`, `"editor"`, `"logic"`, or `"translation"`.
1079
+ * @returns `false` if the active tab cannot be switched, `true` otherwise.
1030
1080
  */
1031
- makeNewViewActive(viewName: string): boolean;
1081
+ makeNewViewActive(tabName: string): boolean;
1032
1082
  private switchViewType;
1033
1083
  private canSwitchViewType;
1034
1084
  private activatePlugin;
@@ -1300,57 +1350,30 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
1300
1350
  protected get designerPropertyGrid(): PropertyGridModel;
1301
1351
  get propertyGrid(): SurveyModel;
1302
1352
  /**
1303
- * Collapse certain property editor tab (category) in properties panel/grid
1304
- * name - tab category name
1305
- * @see collapseAllPropertyGridCategories
1353
+ * Collapses a specified category in Property Grid.
1354
+ * @param name A [category name](https://surveyjs.io/survey-creator/documentation/property-grid-customization#category).
1306
1355
  * @see expandPropertyGridCategory
1307
- * @see expandAllPropertyGridCategories
1308
1356
  */
1309
1357
  collapsePropertyGridCategory(name: string): void;
1310
1358
  /**
1311
- * Expand certain property editor tab (category) in properties panel/grid
1312
- * name - tab category name
1359
+ * Expands a specified category in Property Grid.
1360
+ * @param name A [category name](https://surveyjs.io/survey-creator/documentation/property-grid-customization#category).
1313
1361
  * @see collapsePropertyGridCategory
1314
- * @see collapseAllPropertyGridCategories
1315
- * @see expandAllPropertyGridCategories
1316
1362
  */
1317
1363
  expandPropertyGridCategory(name: string): void;
1318
1364
  /**
1319
- * Expand all property editor tabs (categories) in properties panel/grid
1320
- * @see collapsePropertyGridCategory
1321
- * @see expandPropertyGridCategory
1365
+ * Collapses all categories in Property Grid.
1322
1366
  * @see expandAllPropertyGridCategories
1323
1367
  */
1324
1368
  collapseAllPropertyGridCategories(): void;
1325
1369
  /**
1326
- * Expand all property editor tabs (categories) in properties panel/grid
1327
- * @see collapsePropertyGridCategory
1370
+ * Expands all categories in Property Grid.
1328
1371
  * @see collapseAllPropertyGridCategories
1329
- * @see expandPropertyGridCategory
1330
1372
  */
1331
1373
  expandAllPropertyGridCategories(): void;
1332
- /**
1333
- * @Deprecated Obsolete. Collapse all property editor tabs (categories) in properties panel/grid
1334
- * @see collapseAllPropertyGridCategories
1335
- *
1336
- */
1337
1374
  collapseAllPropertyTabs(): void;
1338
- /**
1339
- * @Deprecated Obsolete. Expand all property editor tabs (categories) in properties panel/grid
1340
- * @see expandAllPropertyGridCategories
1341
- */
1342
1375
  expandAllPropertyTabs(): void;
1343
- /**
1344
- * @Deprecated Obsolete. Expand certain property editor tab (category) in properties panel/grid
1345
- * name - tab category name
1346
- * @see expandPropertyGridCategory
1347
- */
1348
1376
  expandPropertyTab(name: string): void;
1349
- /**
1350
- * @Deprecated Obsolete. Collapse certain property editor tab (category) in properties panel/grid
1351
- * name - tab category name
1352
- * @see collapsePropertyGridCategory
1353
- */
1354
1377
  collapsePropertyTab(name: string): void;
1355
1378
  /**
1356
1379
  * Check for errors in property grid and adorners of the selected elements.
@@ -1423,9 +1446,11 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
1423
1446
  getHasMachineTranslation(): boolean;
1424
1447
  doMachineTranslation(fromLocale: string, toLocale: string, strings: Array<string>, callback: (translated: Array<string>) => void): void;
1425
1448
  /**
1426
- * The delay on saving survey JSON on autoSave in ms. It is 500 ms by default.
1427
- * If during this period of time an end-user modify survey, then the last version will be saved only. Set to 0 to save immediately.
1428
- * @see isAutoSave
1449
+ * A delay between changing survey or theme settings and saving the survey or theme JSON schema, measured in milliseconds. Applies only when the [`isAutoSave`](#isAutoSave) property is `true`.
1450
+ *
1451
+ * Default value: 500 (taken from `settings.autoSave.delay`)
1452
+ *
1453
+ * If a user changes the settings once again during the delay, only the latest version will be saved.
1429
1454
  */
1430
1455
  autoSaveDelay: number;
1431
1456
  private autoSaveTimerId;
@@ -170,6 +170,7 @@ export interface ISurveyCreatorOptions {
170
170
  maximumRateValues: number;
171
171
  maxNestedPanels: number;
172
172
  enableLinkFileEditor: boolean;
173
+ inplaceEditForValues: boolean;
173
174
  rootElement?: HTMLElement;
174
175
  getObjectDisplayName(obj: Base, area: string, reason: string, displayName: string): string;
175
176
  onCanShowPropertyCallback(object: any, property: JsonObjectProperty, showMode: string, parentObj: any, parentProperty: JsonObjectProperty): boolean;
@@ -217,6 +218,7 @@ export declare class EmptySurveyCreatorOptions implements ISurveyCreatorOptions
217
218
  maximumRowsCount: number;
218
219
  maximumRateValues: number;
219
220
  machineTranslationValue: boolean;
221
+ inplaceEditForValues: boolean;
220
222
  maxNestedPanels: number;
221
223
  getObjectDisplayName(obj: Base, area: string, reason: string, displayName: string): string;
222
224
  onCanShowPropertyCallback(object: any, property: JsonObjectProperty, showMode: string, parentObj: any, parentProperty: JsonObjectProperty): boolean;
@@ -7,7 +7,12 @@ export declare class QuestionFileEditorModel extends QuestionFileModel {
7
7
  get allowMultiple(): boolean;
8
8
  set allowMultiple(val: boolean);
9
9
  clear(doneCallback?: () => void, shouldClearValue?: boolean): void;
10
+ private _renderedValue;
11
+ placeholder: string;
12
+ protected updateRenderedValue(value: string): void;
13
+ get renderedValue(): string;
10
14
  protected updateValueFromInputEvent(event: Event): void;
15
+ onSurveyValueChanged(newValue: any): void;
11
16
  onInputChange(event: Event): void;
12
17
  onInputBlur(event: Event): void;
13
18
  getType(): string;