survey-creator-core 1.9.33 → 1.9.36

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.
@@ -1,5 +1,5 @@
1
1
  /*
2
- * Type definition for Survey Creatorlibrary. Platform independent (core) v1.9.33
2
+ * Type definition for Survey Creatorlibrary. Platform independent (core) v1.9.36
3
3
  * Copyright (c) 2015-2022 Devsoft Baltic OÜ - https://surveyjs.io/
4
4
  * License: https://surveyjs.io/Licenses#SurveyCreator
5
5
  */
@@ -405,43 +405,44 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
405
405
  getPlugin<P extends ICreatorPlugin = ICreatorPlugin>(name: string): any;
406
406
  /*
407
407
  * The event is called on deleting an element (question/panel/page) from the survey. Typically, when a user click the delete from the element menu.
408
- * <br/> sender the survey creator object that fires the event
409
- * <br/> options.element an instance of the deleting element
410
- * <br/> options.elementType the type of the element: 'question', 'panel' or 'page'.
411
- * <br/> options.allowing set it to false to cancel the element deleting
408
+ * sender the survey creator object that fires the event
409
+ * options.element an instance of the deleting element
410
+ * options.elementType the type of the element: 'question', 'panel' or 'page'.
411
+ * options.allowing set it to false to cancel the element deleting
412
412
  */
413
413
  onElementDeleting: Event<(sender: CreatorBase, options: any) => any, any>;
414
414
  /*
415
415
  * The event is called on setting a readOnly property of the property editor. By default the property.readOnly property is used.
416
416
  * You may changed it and make the property editor read only or enabled for a particular object.
417
- * <br/> sender the survey creator object that fires the event
418
- * <br/> options.obj the survey object, Survey, Page, Panel or Question
419
- * <br/> options.property the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties.
420
- * <br/> options.readOnly a boolean value. It has value equals to options.readOnly property by default. You may change it.
421
- * <br/> options.parentObj the parent object. It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is a question (dropdown, radigroup, checkbox, matrices and so on).
422
- * <br/> options.parentProperty the parent property (Survey.JsonObjectProperty object). It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is choices, columns, rows, triggers and so on.
417
+ * sender the survey creator object that fires the event
418
+ * options.obj the survey object, Survey, Page, Panel or Question
419
+ * options.property the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties.
420
+ * options.readOnly a boolean value. It has value equals to options.readOnly property by default. You may change it.
421
+ * options.parentObj the parent object. It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is a question (dropdown, radigroup, checkbox, matrices and so on).
422
+ * options.parentProperty the parent property (Survey.JsonObjectProperty object). It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is choices, columns, rows, triggers and so on.
423
423
  */
424
424
  onGetPropertyReadOnly: Event<(sender: CreatorBase, options: any) => any, any>;
425
425
  /*
426
426
  * The event is fired when the survey creator creates a survey object (Survey.Survey).
427
- * <br/> sender the survey creator object that fires the event
428
- * <br/> options.survey the survey object showing in the creator.
429
- * <br/> options.reason indicates what component of the creator requests the survey. There are several reason types: "designer" - survey for designer survey, "test" - survey for "Preview" tab and "conditionEditor", "defaultValueEditor", "restfulEditor" - surveys for different property editors.
427
+ * sender the survey creator object that fires the event
428
+ * options.survey the survey object showing in the creator.
429
+ * options.reason indicates what component of the creator requests the survey. There are several reason types: "designer" - survey for designer survey, "test" - survey for "Preview" tab and "conditionEditor", "defaultValueEditor", "restfulEditor" - surveys for different property editors.
430
430
  */
431
431
  onSurveyInstanceCreated: Event<(sender: CreatorBase, options: any) => any, any>;
432
432
  /*
433
433
  * The event allows to display the custom name for objects: questions, pages and panels. By default the object name is using. You may show object title by setting showObjectTitles property to true.
434
434
  * Use this event, if you want custom display name for objects.
435
- * <br/> sender the survey creator object that fires the event
436
- * <br/> options.obj the survey object, Survey, Page, Panel or Question
437
- * <br/> options.reason the name of the UI that requests the object display name.
438
- * <br/> options.displayName change this property to show your custom display name for the object
439
- * <br/> The list of possible values in options.reason:
440
- * <br/> "condition" - raised from Condition modal window or on setup condition in a logic tab
441
- * <br/> "survey-tester" - raised from page selector list in "Preview" tab
442
- * <br/> "survey-tester-selected" - raised on setting page selector title in "Preview" tab
443
- * <br/> "survey-translation" - raised from translation tab
444
- * <br/> "property-grid" - raised from showing object selector for property grid in "Designer" tab.
435
+ * sender the survey creator object that fires the event
436
+ * options.obj the survey object, Survey, Page, Panel or Question
437
+ * options.reason the name of the UI that requests the object display name.
438
+ * options.displayName change this property to show your custom display name for the object
439
+ * The list of possible values in options.reason:
440
+ * "condition" - raised from Condition modal window or on setup condition in a logic tab
441
+ * "survey-tester" - raised from page selector list in "Preview" tab
442
+ * "survey-tester-selected" - raised on setting page selector title in "Preview" tab
443
+ * "survey-translation" - raised from translation tab
444
+ * "property-grid" - raised from showing object selector for property grid in "Designer" tab.
445
+ * "property-grid-title" - raised on rendering selected object title in property grid in "Designer" tab.
445
446
  */
446
447
  onGetObjectDisplayName: Event<(sender: CreatorBase, options: any) => any, any>;
447
448
  /*
@@ -476,127 +477,127 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
476
477
  onElementAllowOperations: Event<(sender: CreatorBase, options: any) => any, any>;
477
478
  /*
478
479
  * Use this event to add/remove/modify the element (question/panel) menu items.
479
- * <br/> sender the survey creator object that fires the event
480
- * <br/> options.obj the survey object which property is edited in the Property Editor.
481
- * <br/> options.items the list of menu items. It has two required fields: text and onClick: function(obj: Survey.Base) {} and optional name field.
480
+ * sender the survey creator object that fires the event
481
+ * options.obj the survey object which property is edited in the Property Editor.
482
+ * options.items the list of menu items. It has two required fields: text and onClick: function(obj: Survey.Base) {} and optional name field.
482
483
  */
483
484
  onDefineElementMenuItems: Event<(sender: CreatorBase, options: any) => any, any>;
484
485
  /*
485
486
  * The event is called before showing a property in the Properties Grid or in the Question Editor.
486
- * <br/> sender the survey creator object that fires the event
487
- * <br/> options.obj the survey object, Survey, Page, Panel or Question
488
- * <br/> options.property the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties.
489
- * <br/> options.canShow a boolean value. It is true by default. Set it false to hide the property from the Properties Grid and in the Question Editor.
490
- * <br/> options.parentObj the parent object. It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is a question (dropdown, radigroup, checkbox, matrices and so on).
491
- * <br/> options.parentProperty the parent property (Survey.JsonObjectProperty object). It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is choices, columns, rows, triggers and so on.
492
- * <br/>
493
- * <br/> [Example: Hide a category in the Properties Grid](https://surveyjs.io/Examples/Survey-Creator?id=hidecategoryinpropertiesgrid)
487
+ * sender the survey creator object that fires the event
488
+ * options.obj the survey object, Survey, Page, Panel or Question
489
+ * options.property the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties.
490
+ * options.canShow a boolean value. It is true by default. Set it false to hide the property from the Properties Grid and in the Question Editor.
491
+ * options.parentObj the parent object. It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is a question (dropdown, radigroup, checkbox, matrices and so on).
492
+ * options.parentProperty the parent property (Survey.JsonObjectProperty object). It is null for non-nested properties. It is not null for itemvalue or column objects. The parent object is choices, columns, rows, triggers and so on.
493
+ *
494
+ * [Example: Hide a category in the Properties Grid](https://surveyjs.io/Examples/Survey-Creator?id=hidecategoryinpropertiesgrid)
494
495
  */
495
496
  onShowingProperty: Event<(sender: CreatorBase, options: any) => any, any>;
496
497
  onCanShowProperty: Event<(sender: CreatorBase, options: any) => any, any>;
497
498
  /*
498
499
  * The event is called after a survey that represents the Property Grid is created and all its questions (property editors) are setup.
499
500
  * You can use this event to modify this survey to change the property grid behavior
500
- * <br/> options.obj the survey object that is currently editing in the property grid
501
- * <br/> options.survey the property grid survey
501
+ * options.obj the survey object that is currently editing in the property grid
502
+ * options.survey the property grid survey
502
503
  */
503
504
  onPropertyGridSurveyCreated: Event<(sender: CreatorBase, options: any) => any, any>;
504
505
  /*
505
506
  * The event is called after a property editor (in fact a survey question) has been created and all it's properties have been assign.
506
507
  * You can use this event to modify the property editor properties or set event handlers to customize it's behavior
507
- * <br/> options.obj the survey object that is currently editing in the property grid
508
- * <br/> options.property the property that the current property editor is editing
509
- * <br/> options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
508
+ * options.obj the survey object that is currently editing in the property grid
509
+ * options.property the property that the current property editor is editing
510
+ * options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
510
511
  */
511
512
  onPropertyEditorCreated: Event<(sender: CreatorBase, options: any) => any, any>;
512
513
  /*
513
514
  * The event is called after a property editor setups its title actions.
514
515
  * You can use this event to modify the property editor title actions
515
- * <br/> options.obj the survey object that is currently editing in the property grid
516
- * <br/> options.property the property that the current property editor is editing
517
- * <br/> options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
518
- * <br/> options.titleActions the list of title actions.
516
+ * options.obj the survey object that is currently editing in the property grid
517
+ * options.property the property that the current property editor is editing
518
+ * options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
519
+ * options.titleActions the list of title actions.
519
520
  */
520
521
  onPropertyEditorUpdateTitleActions: Event<(sender: CreatorBase, options: any) => any, any>;
521
522
  /*
522
523
  * The event is called before rendering a delete button in the Property Grid or in Question Editor.
523
524
  * Obsolete, please use onCollectionItemAllowOperations
524
- * <br/> sender the survey creator object that fires the event
525
- * <br/> options.obj the survey Question
526
- * <br/> options.item the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
527
- * <br/> options.canDelete a boolean value. It is true by default. Set it false to remove delete button from the Property Grid or in Question Editor
525
+ * sender the survey creator object that fires the event
526
+ * options.obj the survey Question
527
+ * options.item the object property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
528
+ * options.canDelete a boolean value. It is true by default. Set it false to remove delete button from the Property Grid or in Question Editor
528
529
  */
529
530
  onCanDeleteItem: Event<(sender: CreatorBase, options: any) => any, any>;
530
531
  /*
531
532
  * The event is called on deleting a collection item from the Property Editor. For example: column in columns editor or item in choices and so on.
532
533
  * Obsolete, please use onCollectionItemAllowOperations
533
- * <br/> sender the survey creator object that fires the event
534
- * <br/> options.obj the survey object: Question, Panel, Page or Survey
535
- * <br/> options.property the collection property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
536
- * <br/> options.propertyName the collection property name
537
- * <br/> options.collection the editing collection where deleting item is located. It is can be columns in the matrices or choices in dropdown question and so on.
538
- * <br/> options.item the collection item that we are going to delete
539
- * <br/> options.allowDelete a boolean value. It is true by default. Set it false to abondome the element removing from the collection
534
+ * sender the survey creator object that fires the event
535
+ * options.obj the survey object: Question, Panel, Page or Survey
536
+ * options.property the collection property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
537
+ * options.propertyName the collection property name
538
+ * options.collection the editing collection where deleting item is located. It is can be columns in the matrices or choices in dropdown question and so on.
539
+ * options.item the collection item that we are going to delete
540
+ * options.allowDelete a boolean value. It is true by default. Set it false to abondome the element removing from the collection
540
541
  */
541
542
  onCollectionItemDeleting: Event<(sender: CreatorBase, options: any) => any, any>;
542
543
  /*
543
544
  * The event is called before rendering a collection item from the Property Editor. For example: column in columns editor or item in choices and so on.
544
545
  * You can make detail/edit and remove buttons invsible and/or disable editing.
545
- * <br/> sender the survey creator object that fires the event
546
- * <br/> options.obj the survey object: Question, Panel, Page or Survey
547
- * <br/> options.property the collection property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
548
- * <br/> options.propertyName the collection property name
549
- * <br/> options.collection the editing collection where deleting item is located. It is can be columns in the matrices or choices in dropdown question and so on.
550
- * <br/> options.item the collection item that we are going to delete
551
- * <br/> options.allowDelete a boolean value. It is true by default. Set it false to abondome the element removing from the collection
552
- * <br/> options.allowEdit a boolean value. It is true by default. Set it false to disable editing.
546
+ * sender the survey creator object that fires the event
547
+ * options.obj the survey object: Question, Panel, Page or Survey
548
+ * options.property the collection property (Survey.JsonObjectProperty object). It has name, className, type, visible, readOnly and other properties
549
+ * options.propertyName the collection property name
550
+ * options.collection the editing collection where deleting item is located. It is can be columns in the matrices or choices in dropdown question and so on.
551
+ * options.item the collection item that we are going to delete
552
+ * options.allowDelete a boolean value. It is true by default. Set it false to abondome the element removing from the collection
553
+ * options.allowEdit a boolean value. It is true by default. Set it false to disable editing.
553
554
  */
554
555
  onCollectionItemAllowOperations: Event<(sender: CreatorBase, options: any) => any, any>;
555
556
  /*
556
557
  * The event is called on adding a new Survey.ItemValue object. It uses as an element in choices array in Radiogroup, checkbox and dropdown questions or Matrix columns and rows properties.
557
558
  * Use this event, to set ItemValue.value and ItemValue.text properties by default or set a value to the custom property.
558
- * <br/> sender the survey creator object that fires the event
559
- * <br /> options.obj the object that contains the itemsValues array, for example selector, rating and single choice matrix questions.
560
- * <br/> options.propertyName the object property Name. It can be "choices" for selector questions or rateValues for rating question or columns/rows for single choice matrix.
561
- * <br/> options.newItem a new created Survey.ItemValue object.
562
- * <br/> options.itemValues an editing Survey.ItemValue array. newItem object is not added yet into this array.
559
+ * sender the survey creator object that fires the event
560
+ * options.obj the object that contains the itemsValues array, for example selector, rating and single choice matrix questions.
561
+ * options.propertyName the object property Name. It can be "choices" for selector questions or rateValues for rating question or columns/rows for single choice matrix.
562
+ * options.newItem a new created Survey.ItemValue object.
563
+ * options.itemValues an editing Survey.ItemValue array. newItem object is not added yet into this array.
563
564
  */
564
565
  onItemValueAdded: Event<(sender: CreatorBase, options: any) => any, any>;
565
566
  /*
566
567
  * The event is called when a user adds a new column into MatrixDropdown or MatrixDynamic questions. Use it to set some properties of Survey.MatrixDropdownColumn by default, for example name or a custom property.
567
- * <br/> sender the survey creator object that fires the event
568
- * <br/> options.matrix a matrix question where column is located, matrix.columns.
569
- * <br/> options.newColumn a new created Survey.MatrixDropdownColumn object.
570
- * <br/> options.columns editable columns objects. They can be different from options.matrix.columns. options.columns and options.matrix.columns are equal after user press Apply or Cancel and options.columns will be set to options.matrix.columns or reset to initial state.
568
+ * sender the survey creator object that fires the event
569
+ * options.matrix a matrix question where column is located, matrix.columns.
570
+ * options.newColumn a new created Survey.MatrixDropdownColumn object.
571
+ * options.columns editable columns objects. They can be different from options.matrix.columns. options.columns and options.matrix.columns are equal after user press Apply or Cancel and options.columns will be set to options.matrix.columns or reset to initial state.
571
572
  */
572
573
  onMatrixColumnAdded: Event<(sender: CreatorBase, options: any) => any, any>;
573
574
  /*
574
575
  * Use this event to control Property Editors UI.
575
- * <br/> sender the survey creator object that fires the event
576
- * <br/> options.obj the survey object which property is edited in the Property Editor.
577
- * <br/> options.propertyName the name of the edited property.
578
- * <br/> options.editorOptions options that can be changed.
579
- * <br/> options.editorOptions.allowAddRemoveItems a boolean property, true by default. Set it false to disable add/remove items in array properties. For example 'choices', 'columns', 'rows'.
580
- * <br/> options.editorOptions.allowRemoveAllItems a boolean property, true by default. Set it false to disable remove all items in array properties. For example 'choices', 'columns', 'rows'.
581
- * <br/> options.editorOptions.showTextView a boolean property, true by default. Set it false to disable "Manual Entry" tab for "choices" property.
582
- * <br/> options.editorOptions.itemsEntryType a string property, 'form' by default. Set it 'fast' to show "Manual Entry" tab for "choices" property by default.
576
+ * sender the survey creator object that fires the event
577
+ * options.obj the survey object which property is edited in the Property Editor.
578
+ * options.propertyName the name of the edited property.
579
+ * options.editorOptions options that can be changed.
580
+ * options.editorOptions.allowAddRemoveItems a boolean property, true by default. Set it false to disable add/remove items in array properties. For example 'choices', 'columns', 'rows'.
581
+ * options.editorOptions.allowRemoveAllItems a boolean property, true by default. Set it false to disable remove all items in array properties. For example 'choices', 'columns', 'rows'.
582
+ * options.editorOptions.showTextView a boolean property, true by default. Set it false to disable "Manual Entry" tab for "choices" property.
583
+ * options.editorOptions.itemsEntryType a string property, 'form' by default. Set it 'fast' to show "Manual Entry" tab for "choices" property by default.
583
584
  */
584
585
  onSetPropertyEditorOptions: Event<(sender: CreatorBase, options: any) => any, any>;
585
586
  /*
586
587
  * The event is called on generation a new name for a new created element.
587
- * <br/> sender the survey creator object that fires the event
588
- * <br/> options.element a new created survey element. It can be question, panel or page
589
- * <br/> options.name a new suggested name, that is unique for the current survey. You can suggest your own name. If it is unique, creator will assign it to the element.
590
- * <br/> options.isUnique a boolean property, set this property to false, if you want to ask Creator to generate another name
588
+ * sender the survey creator object that fires the event
589
+ * options.element a new created survey element. It can be question, panel or page
590
+ * options.name a new suggested name, that is unique for the current survey. You can suggest your own name. If it is unique, creator will assign it to the element.
591
+ * options.isUnique a boolean property, set this property to false, if you want to ask Creator to generate another name
591
592
  */
592
593
  onGenerateNewName: Event<(sender: CreatorBase, options: any) => any, any>;
593
594
  /*
594
595
  * Use this event to show a custom error in the Question Editor on pressing Apply or OK buttons, if the values are not set correctly. The error will be displayed under the property editor.
595
- * <br/> sender the survey creator object that fires the event
596
- * <br/> options.obj the survey object which property is edited in the Property Editor.
597
- * <br/> options.propertyName the name of the edited property.
598
- * <br/> options.value the property value.
599
- * <br/> options.error the error you want to display. Set the empty string (the default value) or null if there is no errors.
596
+ * sender the survey creator object that fires the event
597
+ * options.obj the survey object which property is edited in the Property Editor.
598
+ * options.propertyName the name of the edited property.
599
+ * options.value the property value.
600
+ * options.error the error you want to display. Set the empty string (the default value) or null if there is no errors.
600
601
  */
601
602
  onPropertyValidationCustomError: Event<(sender: CreatorBase, options: any) => any, any>;
602
603
  /*
@@ -624,98 +625,98 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
624
625
  onSurveyPropertyValueChanged: Event<(sender: CreatorBase, options: any) => any, any>;
625
626
  /*
626
627
  * Use this event to modify the list (name and titles) of the questions available in a condition editor.
627
- * <br/> sender the survey creator object that fires the event
628
- * <br/> options.obj the survey object which property is edited in the Property Editor.
629
- * <br/> options.propertyName the name of the edited property.
630
- * <br/> options.editor the instance of Property Editor.
631
- * <br/> options.list the list of the questions available for condition
628
+ * sender the survey creator object that fires the event
629
+ * options.obj the survey object which property is edited in the Property Editor.
630
+ * options.propertyName the name of the edited property.
631
+ * options.editor the instance of Property Editor.
632
+ * options.list the list of the questions available for condition
632
633
  */
633
634
  onConditionQuestionsGetList: Event<(sender: CreatorBase, options: any) => any, any>;
634
635
  /*
635
636
  * Use this event to modify the title in a condition editor. The title is changing during editing. In case of empty or incorrect expression it tells that expression is incorrect
636
- * <br/> sender the survey creator object that fires the event.
637
- * <br/> options.expression the current expression. If the expression is empty or incorrect then the value is empty.
638
- * <br/> options.title the default value of the title. You can change the default value.
637
+ * sender the survey creator object that fires the event.
638
+ * options.expression the current expression. If the expression is empty or incorrect then the value is empty.
639
+ * options.title the default value of the title. You can change the default value.
639
640
  */
640
641
  onConditionGetTitle: Event<(sender: CreatorBase, options: any) => any, any>;
641
642
  /*
642
643
  * The event is called when a survey is changed in the designer. A new page/question/page is added or existing is removed, a property is changed and so on.
643
- * <br/> sender the survey creator object that fires the event
644
- * <br/> options object contains the information about certain modifications
645
- * <br/> options.type contains string constant describing certain modification
646
- * <br/> Available values:
647
- * <br/>
648
- * <br/> options.type: "ADDED_FROM_TOOLBOX"
649
- * <br/> options.question: newly added question
650
- * <br/>
651
- * <br/> options.type: "PAGE_ADDED"
652
- * <br/> options.newValue: newly created page
653
- * <br/>
654
- * <br/> options.type: "PAGE_MOVED"
655
- * <br/> options.page: page has been moved
656
- * <br/> options.indexFrom: pevious index
657
- * <br/> options.indexTo: new index
658
- * <br/>
659
- * <br/> options.type: "QUESTION_CONVERTED"
660
- * <br/> options.className: the converted class name
661
- * <br/> options.oldValue: pevious object
662
- * <br/> options.newValue: the new object, converted from oldVale to the given class name
663
- * <br/>
664
- * <br/> options.type: "QUESTION_CHANGED_BY_EDITOR"
665
- * <br/> options.question: question has been edited in the popup question editor
666
- * <br/>
667
- * <br/> options.type: "PROPERTY_CHANGED"
668
- * <br/> options.name: the name of the property has been changed
669
- * <br/> options.target: the object containing the changed property
670
- * <br/> options.oldValue: the previous value of the changed property
671
- * <br/> options.newValue: the new value of the changed property
672
- * <br/>
673
- * <br/> options.type: "OBJECT_DELETED"
674
- * <br/> options.target: deleted object
675
- * <br/>
676
- * <br/> options.type: "VIEW_TYPE_CHANGED"
677
- * <br/> options.newType: new type of the creator view: editor or designer
678
- * <br/>
679
- * <br/> options.type: "DO_DROP"
680
- * <br/> options.page: the page of the drap/drop operation
681
- * <br/> options.source: the source dragged object
682
- * <br/> options.target: the drop target
683
- * <br/> options.newElement: a new element. It is defined if a user drops question or panel from the toolbox
684
- * <br/>
685
- * <br/> options.type: "TRANSLATIONS_CHANGED"
686
- * <br/> options.type: "JSON_EDITOR"
644
+ * sender the survey creator object that fires the event
645
+ * options object contains the information about certain modifications
646
+ * options.type contains string constant describing certain modification
647
+ * Available values:
648
+ *
649
+ * options.type: "ADDED_FROM_TOOLBOX"
650
+ * options.question: newly added question
651
+ *
652
+ * options.type: "PAGE_ADDED"
653
+ * options.newValue: newly created page
654
+ *
655
+ * options.type: "PAGE_MOVED"
656
+ * options.page: page has been moved
657
+ * options.indexFrom: pevious index
658
+ * options.indexTo: new index
659
+ *
660
+ * options.type: "QUESTION_CONVERTED"
661
+ * options.className: the converted class name
662
+ * options.oldValue: pevious object
663
+ * options.newValue: the new object, converted from oldVale to the given class name
664
+ *
665
+ * options.type: "QUESTION_CHANGED_BY_EDITOR"
666
+ * options.question: question has been edited in the popup question editor
667
+ *
668
+ * options.type: "PROPERTY_CHANGED"
669
+ * options.name: the name of the property has been changed
670
+ * options.target: the object containing the changed property
671
+ * options.oldValue: the previous value of the changed property
672
+ * options.newValue: the new value of the changed property
673
+ *
674
+ * options.type: "OBJECT_DELETED"
675
+ * options.target: deleted object
676
+ *
677
+ * options.type: "VIEW_TYPE_CHANGED"
678
+ * options.newType: new type of the creator view: editor or designer
679
+ *
680
+ * options.type: "DO_DROP"
681
+ * options.page: the page of the drap/drop operation
682
+ * options.source: the source dragged object
683
+ * options.target: the drop target
684
+ * options.newElement: a new element. It is defined if a user drops question or panel from the toolbox
685
+ *
686
+ * options.type: "TRANSLATIONS_CHANGED"
687
+ * options.type: "JSON_EDITOR"
687
688
  */
688
689
  onModified: Event<(sender: CreatorBase, options: any) => any, any>;
689
690
  /*
690
691
  * 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.
691
- * <br/> sender the survey creator object that fires the event
692
- * <br/> options.question a new added survey question. Survey.Question object
693
- * <br/> options.page the survey Page object where question has been added.
692
+ * sender the survey creator object that fires the event
693
+ * options.question a new added survey question. Survey.Question object
694
+ * options.page the survey Page object where question has been added.
694
695
  */
695
696
  onQuestionAdded: Event<(sender: CreatorBase, options: any) => any, any>;
696
697
  /*
697
698
  * 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.
698
- * <br/> sender the survey creator object that fires the event
699
- * <br/> options.panel a new added survey panel. Survey.Panel object
700
- * <br/> options.page the survey Page object where question has been added.
699
+ * sender the survey creator object that fires the event
700
+ * options.panel a new added survey panel. Survey.Panel object
701
+ * options.page the survey Page object where question has been added.
701
702
  */
702
703
  onPanelAdded: Event<(sender: CreatorBase, options: any) => any, any>;
703
704
  /*
704
705
  * The event is called on adding a new page into the survey.
705
- * <br/> sender the survey creator object that fires the event
706
- * <br/> options.page the new survey Page object.
706
+ * sender the survey creator object that fires the event
707
+ * options.page the new survey Page object.
707
708
  */
708
709
  onPageAdded: Event<(sender: CreatorBase, options: any) => any, any>;
709
710
  /*
710
711
  * The event is fired when the survey creator is initialized and a survey object (Survey.Survey) is created.
711
- * <br/> sender the survey creator object that fires the event
712
- * <br/> options.survey the survey object showing in the creator.
712
+ * sender the survey creator object that fires the event
713
+ * options.survey the survey object showing in the creator.
713
714
  */
714
715
  onDesignerSurveyCreated: Event<(sender: CreatorBase, options: any) => any, any>;
715
716
  /*
716
717
  * The event is fired when the survey creator creates survey in Preview tab for testing.
717
- * <br/> sender the survey creator object that fires the event
718
- * <br/> options.survey the survey object showing in the "Preview" tab.
718
+ * sender the survey creator object that fires the event
719
+ * options.survey the survey object showing in the "Preview" tab.
719
720
  */
720
721
  onPreviewSurveyCreated: Event<(sender: CreatorBase, options: any) => any, any>;
721
722
  /*
@@ -725,34 +726,34 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
725
726
  /*
726
727
  * The event is called in case of UI notifications. By default all notifications are done via built-in alert () function.
727
728
  * In case of any subscriptions to this event all notifications will be redirected into the event handler.
728
- * <br/> options.message is a message to show.
729
+ * options.message is a message to show.
729
730
  */
730
731
  onNotify: Event<(sender: CreatorBase, options: any) => any, any>;
731
732
  /*
732
733
  * The event is called on changing the selected element. You may change the new selected element by changing the property options.newSelectedElement to your own
733
- * <br/> options.newSelectedElement the element that is going to be selected in the survey desiger: question, panel, page or survey.
734
+ * options.newSelectedElement the element that is going to be selected in the survey desiger: question, panel, page or survey.
734
735
  */
735
736
  onSelectedElementChanging: Event<(sender: CreatorBase, options: any) => any, any>;
736
737
  /*
737
738
  * The event is called after the selected element is changed.
738
- * <br/> options.newSelectedElement the new selected element in the survey desiger: question, panel, page or survey.
739
+ * options.newSelectedElement the new selected element in the survey desiger: question, panel, page or survey.
739
740
  */
740
741
  onSelectedElementChanged: Event<(sender: CreatorBase, options: any) => any, any>;
741
742
  /*
742
743
  * The event is fired then one need to choose files.
743
- * <br/> sender the survey creator object that fires the event
744
- * <br/> input file input HTML element
745
- * <br/> callback need to be called after files has been chosen
744
+ * sender the survey creator object that fires the event
745
+ * input file input HTML element
746
+ * callback need to be called after files has been chosen
746
747
  */
747
748
  onOpenFileChooser: Event<(sender: CreatorBase, options: any) => any, any>;
748
749
  /*
749
750
  * The event is fired on uploading the files.
750
- * <br/> sender the survey creator object that fires the event
751
- * <br/> There are two properties in options:
752
- * <br/> files the Javascript File objects array
753
- * <br/> callback called on upload complete,
754
- * <br/> which takes two string arguments:
755
- * <br/> a status and an image link
751
+ * sender the survey creator object that fires the event
752
+ * There are two properties in options:
753
+ * files the Javascript File objects array
754
+ * callback called on upload complete,
755
+ * which takes two string arguments:
756
+ * a status and an image link
756
757
  */
757
758
  onUploadFile: Event<(sender: CreatorBase, options: any) => any, any>;
758
759
  /*
@@ -777,18 +778,49 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
777
778
  */
778
779
  onTranslationLocaleInitiallySelected: Event<(sender: CreatorBase, options: any) => any, any>;
779
780
  /*
781
+ * Use this event to modify the imported localizable text. To block importing a particular localization text, set the options.text into undefined.
782
+ *
783
+ * The event handler accepts the following arguments:
784
+ *
785
+ * - `sender` - A Survey Creator instance that raised the event.
786
+ * - `options.locale` - the locale name, like 'en', 'de' and so on.
787
+ * - `options.name` - The full name of the localizable string, it can be: "survey.page1.question2.title"
788
+ * - `options.text` - The imported text for the locale for this item. Set it to undefined or empty string to block importing for this item
789
+ */
790
+ onTranslationImportItem: Event<(sender: CreatorBase, options: any) => any, any>;
791
+ /*
792
+ * The method is called when the translation from csv file is imported.
793
+ */
794
+ onTranslationImported: Event<(sender: CreatorBase, options: any) => any, any>;
795
+ /*
780
796
  * Use this event to control drag&drop operations.
781
- * <br/> sender the survey creator object that fires the event.
782
- * <br/> options.survey the editing survey object.
783
- * <br/> options.allow set it to false to disable dragging.
784
- * <br/> options.target a target element that is dragging.
785
- * <br/> options.source a source element. It can be null, if it is a new element, dragging from toolbox.
786
- * <br/> options.parent a page or panel where target element is dragging.
787
- * <br/> options.insertBefore an element before the target element is dragging. It can be null if parent container (page or panel) is empty or dragging an element under the last element of the container.
788
- * <br/> options.insertAfter an element after the target element is dragging. It can be null if parent container (page or panel) is empty or dragging element to the top of the parent container.
797
+ * sender the survey creator object that fires the event.
798
+ * options.survey the editing survey object.
799
+ * options.allow set it to false to disable dragging.
800
+ * options.target a target element that is dragging.
801
+ * options.source a source element. It can be null, if it is a new element, dragging from toolbox.
802
+ * options.parent a page or panel where target element is dragging.
803
+ * options.insertBefore an element before the target element is dragging. It can be null if parent container (page or panel) is empty or dragging an element under the last element of the container.
804
+ * options.insertAfter an element after the target element is dragging. It can be null if parent container (page or panel) is empty or dragging element to the top of the parent container.
789
805
  */
790
806
  onDragDropAllow: Event<(sender: CreatorBase, options: any) => any, any>;
791
807
  /*
808
+ * Use this event to override/disable element adorners - wrapping component name.
809
+ * sender the survey creator object that fires the event.
810
+ * options.element a survey object to be wrapped.
811
+ * options.reason why we need to wrap an element.
812
+ * options.conponentName component wrapper name.
813
+ */
814
+ onGetElementWrapperComponentName: Event<(sender: CreatorBase, options: any) => any, any>;
815
+ /*
816
+ * Use this event to override/disable element adorners - wrapping component data.
817
+ * sender the survey creator object that fires the event.
818
+ * options.element a survey object to be wrapped.
819
+ * options.reason why we need to wrap an element.
820
+ * options.conponentData component wrapper data.
821
+ */
822
+ onGetElementWrapperComponentData: Event<(sender: CreatorBase, options: any) => any, any>;
823
+ /*
792
824
  * This callback is used internally for providing survey JSON text.
793
825
  */
794
826
  getSurveyJSONTextCallback: any;
@@ -915,14 +947,14 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
915
947
  set isRTL(val: boolean);
916
948
  /*
917
949
  * The event is called when creator is going to change the active tab.
918
- * <br/> sender the survey creator object that fires the event
919
- * <br/> options.tabName the name of new active tab
950
+ * sender the survey creator object that fires the event
951
+ * options.tabName the name of new active tab
920
952
  */
921
953
  onActiveTabChanging: Event<(sender: CreatorBase, options: any) => any, any>;
922
954
  /*
923
955
  * The event is called when creator active tab is changed.
924
- * <br/> sender the survey creator object that fires the event
925
- * <br/> options.tabName the name of new active tab
956
+ * sender the survey creator object that fires the event
957
+ * options.tabName the name of new active tab
926
958
  */
927
959
  onActiveTabChanged: Event<(sender: CreatorBase, options: any) => any, any>;
928
960
  /*
@@ -958,22 +990,22 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
958
990
  leftContainerActiveItem(name: string): void;
959
991
  /*
960
992
  * The event is called before undo happens.
961
- * <br/> options.canUndo a boolean value. It is true by default. Set it false to hide prevent undo operation.
993
+ * options.canUndo a boolean value. It is true by default. Set it false to hide prevent undo operation.
962
994
  */
963
995
  onBeforeUndo: Event<(sender: CreatorBase, options: any) => any, any>;
964
996
  /*
965
997
  * The event is called before redo happens.
966
- * <br/> options.canRedo a boolean value. It is true by default. Set it false to hide prevent redo operation.
998
+ * options.canRedo a boolean value. It is true by default. Set it false to hide prevent redo operation.
967
999
  */
968
1000
  onBeforeRedo: Event<(sender: CreatorBase, options: any) => any, any>;
969
1001
  /*
970
1002
  * The event is called after undo happens.
971
- * <br/> options.state is an undo/redo item.
1003
+ * options.state is an undo/redo item.
972
1004
  */
973
1005
  onAfterUndo: Event<(sender: CreatorBase, options: any) => any, any>;
974
1006
  /*
975
1007
  * The event is called after redo happens.
976
- * <br/> options.state is an undo/redo item.
1008
+ * options.state is an undo/redo item.
977
1009
  */
978
1010
  onAfterRedo: Event<(sender: CreatorBase, options: any) => any, any>;
979
1011
  get undoRedoManager(): UndoRedoManager;
@@ -1877,27 +1909,27 @@ export declare class SurveyLogic extends Base implements ISurveyLogicItemOwner {
1877
1909
  onChangedCallback: (item: SurveyLogicItem, changeType: string) => void;
1878
1910
  /*
1879
1911
  * The event is called when logic item is saved.
1880
- * <br/> options.item is the saved logic item.
1912
+ * options.item is the saved logic item.
1881
1913
  */
1882
1914
  onLogicItemSaved: Event<(sender: SurveyLogic, options: any) => any, any>;
1883
1915
  /*
1884
1916
  * The event is called before logic item is saved. You can set options.error to non empty string to show error instead of saving the item.
1885
1917
  * You can use options.item.actions to access actions and optionally set errorText to a particular action.
1886
- * <br/> options.item is the editing logic item. options.item.actions contains the old actions.
1887
- * <br/> options.actions is the array of logic actions that user edit and create.
1888
- * <br/> usedNamesInExpression - the string list of all variables (questions, calculatedValues, and so on) that are used in expression
1889
- * <br/> error - the error string. It is empty by default. You have to set it to non-empty string to show the error on saving.
1918
+ * options.item is the editing logic item. options.item.actions contains the old actions.
1919
+ * options.actions is the array of logic actions that user edit and create.
1920
+ * usedNamesInExpression - the string list of all variables (questions, calculatedValues, and so on) that are used in expression
1921
+ * error - the error string. It is empty by default. You have to set it to non-empty string to show the error on saving.
1890
1922
  */
1891
1923
  onLogicItemValidation: Event<(sender: SurveyLogic, options: any) => any, any>;
1892
1924
  /*
1893
1925
  * The event is called before logic item is being removed.
1894
- * <br/> options.allowRemove is the option you can set to false and prevent removing.
1895
- * <br/> options.item is the logic item to remove.
1926
+ * options.allowRemove is the option you can set to false and prevent removing.
1927
+ * options.item is the logic item to remove.
1896
1928
  */
1897
1929
  onLogicItemRemoving: Event<(sender: SurveyLogic, options: any) => any, any>;
1898
1930
  /*
1899
1931
  * The event is called when logic item is removed.
1900
- * <br/> options.item is the removed logic item.
1932
+ * options.item is the removed logic item.
1901
1933
  */
1902
1934
  onLogicItemRemoved: Event<(sender: SurveyLogic, options: any) => any, any>;
1903
1935
  koAfterRender: any;
@@ -2227,6 +2259,7 @@ export declare class Translation extends Base implements ITranslationLocales {
2227
2259
  static newLineDelimiter: string;
2228
2260
  exportToCSVFileUI: any;
2229
2261
  importFromCSVFileUI: any;
2262
+ importItemCallback: (name: string, locale: string, text: string) => string;
2230
2263
  importFinishedCallback: any;
2231
2264
  translateItemAfterRenderCallback: (item: TranslationItem, el: any, locale: string) => void;
2232
2265
  availableTranlationsChangedCallback: any;
@@ -2279,7 +2312,7 @@ export declare class Translation extends Base implements ITranslationLocales {
2279
2312
  /*
2280
2313
  * Update a translation item with given values
2281
2314
  */
2282
- updateItemWithStrings(item: TranslationItem, values: any, locales: any): void;
2315
+ updateItemWithStrings(name: string, item: TranslationItem, values: any, locales: any): void;
2283
2316
  dispose(): void;
2284
2317
  }
2285
2318
  export declare class TranslationItemBase extends Base {
@@ -2312,22 +2345,22 @@ export declare class UndoRedoController extends Base {
2312
2345
  createActions(): any;
2313
2346
  /*
2314
2347
  * The event is called before undo happens.
2315
- * <br/> options.canUndo a boolean value. It is true by default. Set it false to hide prevent undo operation.
2348
+ * options.canUndo a boolean value. It is true by default. Set it false to hide prevent undo operation.
2316
2349
  */
2317
2350
  onBeforeUndo: Event<(sender: CreatorBase, options: any) => any, any>;
2318
2351
  /*
2319
2352
  * The event is called before redo happens.
2320
- * <br/> options.canRedo a boolean value. It is true by default. Set it false to hide prevent redo operation.
2353
+ * options.canRedo a boolean value. It is true by default. Set it false to hide prevent redo operation.
2321
2354
  */
2322
2355
  onBeforeRedo: Event<(sender: CreatorBase, options: any) => any, any>;
2323
2356
  /*
2324
2357
  * The event is called after undo happens.
2325
- * <br/> options.state is an undo/redo item.
2358
+ * options.state is an undo/redo item.
2326
2359
  */
2327
2360
  onAfterUndo: Event<(sender: CreatorBase, options: any) => any, any>;
2328
2361
  /*
2329
2362
  * The event is called after redo happens.
2330
- * <br/> options.state is an undo/redo item.
2363
+ * options.state is an undo/redo item.
2331
2364
  */
2332
2365
  onAfterRedo: Event<(sender: CreatorBase, options: any) => any, any>;
2333
2366
  }
@@ -2871,8 +2904,6 @@ export declare class PropertyGridEditorMatrix extends PropertyGridEditor {
2871
2904
  onMatrixCellCreated(obj: Base, options: any): void;
2872
2905
  onGetMatrixRowAction(obj: Base, options: any, setObjFunc: (obj: Base) => void): void;
2873
2906
  onGetQuestionTitleActions(obj: Base, options: any): void;
2874
- onValueChanged(obj: Base, prop: JsonObjectProperty, question: Question): void;
2875
- protected updateTitleActions(question: Question): void;
2876
2907
  protected createNewItem(matrix: QuestionMatrixDynamicModel, prop: JsonObjectProperty): Base;
2877
2908
  protected getDefaultClassName(prop: JsonObjectProperty): string;
2878
2909
  protected getBaseValue(prop: JsonObjectProperty): string;
@@ -2890,8 +2921,7 @@ export declare class PropertyGridEditorMatrix extends PropertyGridEditor {
2890
2921
  protected getAllowRowDragDrop(prop: JsonObjectProperty): boolean;
2891
2922
  getJSON(obj: Base, prop: JsonObjectProperty, options: ISurveyCreatorOptions): any;
2892
2923
  protected getMatrixJSON(obj: Base, prop: JsonObjectProperty, propNames: any, options: ISurveyCreatorOptions): any;
2893
- protected getHideColumnsEmpty(prop: JsonObjectProperty): boolean;
2894
- protected getEmptyRowsText(props: any): string;
2924
+ protected getEmptyRowsText(prop: JsonObjectProperty): string;
2895
2925
  protected getMaximumRowCount(obj: Base, prop: JsonObjectProperty, options: ISurveyCreatorOptions): number;
2896
2926
  protected getColumnsJSON(obj: Base, prop: JsonObjectProperty, propNames: any, options: ISurveyCreatorOptions): any;
2897
2927
  protected getEditItemAsStandAlone(): boolean;
@@ -3013,8 +3043,6 @@ export declare class PropertyGridEditorMatrixItemValues extends PropertyGridEdit
3013
3043
  protected getColumnClassName(obj: Base, prop: JsonObjectProperty): string;
3014
3044
  protected getDefaulColumnNames(): Array<any>;
3015
3045
  protected getKeyValue(): string;
3016
- protected getHideColumnsEmpty(prop: JsonObjectProperty): boolean;
3017
- protected getEmptyRowsText(prop: any): string;
3018
3046
  protected getMaximumRowCount(obj: Base, prop: JsonObjectProperty, options: ISurveyCreatorOptions): number;
3019
3047
  }
3020
3048
  export declare class PropertyGridEditorMatrixMultipleTypes extends PropertyGridEditorMatrix {
@@ -3179,6 +3207,8 @@ export declare function getItemValueWrapperComponentName(item: ItemValue, questi
3179
3207
  export declare function getItemValueWrapperComponentData(item: ItemValue, question: QuestionSelectBase, creator: CreatorBase): any;
3180
3208
  export declare function isStringEditable(element: any, name: string): boolean;
3181
3209
  export declare function isTextInput(target: any): boolean;
3210
+ export declare function registerAdorner(name: any, adorner: any): void;
3211
+ export declare function removeAdorners(names?: any): void;
3182
3212
  export declare var settings: {
3183
3213
  translation: {
3184
3214
  sortByName: boolean,
@@ -3187,6 +3217,10 @@ export declare var settings: {
3187
3217
  * The maximum number of locales that user can select at once for translation
3188
3218
  */
3189
3219
  maximumSelectedLocales: number,
3220
+ /*
3221
+ * The name of the translation export file in csv format
3222
+ */
3223
+ exportFileName: string,
3190
3224
  },
3191
3225
  operators: {
3192
3226
  empty: any,
@@ -3435,11 +3469,11 @@ export declare var propertyGridCss: {
3435
3469
  mainRoot: string,
3436
3470
  root: string,
3437
3471
  item: string,
3438
- control: string,
3439
3472
  itemChecked: string,
3440
3473
  itemIndeterminate: string,
3441
3474
  itemDisabled: string,
3442
3475
  svgIconId: string,
3476
+ controlCheckbox: string,
3443
3477
  label: string,
3444
3478
  disabledLabel: string,
3445
3479
  itemDecorator: string,