@progress/kendo-angular-editor 13.1.0 → 13.1.1-develop.1

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 (99) hide show
  1. package/common/apply-to-word-options.d.ts +1 -3
  2. package/common/commands.d.ts +16 -1
  3. package/common/css-settings.interface.d.ts +1 -3
  4. package/common/font-family-item.interface.d.ts +0 -8
  5. package/common/font-size-item.interface.d.ts +0 -8
  6. package/common/format-item.interface.d.ts +0 -8
  7. package/common/paste-cleanup-settings.d.ts +0 -11
  8. package/editor.component.d.ts +1 -63
  9. package/editor.module.d.ts +4 -25
  10. package/esm2020/editor.component.mjs +1 -63
  11. package/esm2020/editor.module.mjs +4 -25
  12. package/esm2020/localization/custom-messages.component.mjs +1 -1
  13. package/esm2020/package-metadata.mjs +2 -2
  14. package/esm2020/tools/alignment/editor-align-center-button.directive.mjs +2 -9
  15. package/esm2020/tools/alignment/editor-align-justify-button.directive.mjs +2 -9
  16. package/esm2020/tools/alignment/editor-align-left-button.directive.mjs +2 -9
  17. package/esm2020/tools/alignment/editor-align-right-button.directive.mjs +2 -9
  18. package/esm2020/tools/blockquote/editor-blockquote-button.directive.mjs +2 -9
  19. package/esm2020/tools/colorpicker/editor-back-color.directive.mjs +4 -0
  20. package/esm2020/tools/colorpicker/editor-colorpicker.component.mjs +3 -1
  21. package/esm2020/tools/colorpicker/editor-fore-color.directive.mjs +4 -0
  22. package/esm2020/tools/editor-clean-formatting-button.directive.mjs +2 -9
  23. package/esm2020/tools/fontfamily/editor-fontfamily.component.mjs +1 -1
  24. package/esm2020/tools/fontsize/editor-fontsize.component.mjs +1 -3
  25. package/esm2020/tools/format/editor-format.component.mjs +1 -1
  26. package/esm2020/tools/history/editor-redo-button.directive.mjs +2 -9
  27. package/esm2020/tools/history/editor-undo-button.directive.mjs +2 -9
  28. package/esm2020/tools/image/editor-insert-image-button.directive.mjs +2 -9
  29. package/esm2020/tools/indentation/editor-indent-button.directive.mjs +2 -9
  30. package/esm2020/tools/indentation/editor-outdent-button.directive.mjs +2 -9
  31. package/esm2020/tools/link/editor-create-link-button.directive.mjs +2 -9
  32. package/esm2020/tools/link/editor-insert-file-button.directive.mjs +3 -3
  33. package/esm2020/tools/link/editor-unlink-button.directive.mjs +2 -9
  34. package/esm2020/tools/list/editor-insert-ordered-list-button.directive.mjs +2 -9
  35. package/esm2020/tools/list/editor-insert-unordered-list-button.directive.mjs +2 -9
  36. package/esm2020/tools/print/editor-print-button.directive.mjs +2 -9
  37. package/esm2020/tools/select-all/select-all-button.directive.mjs +2 -9
  38. package/esm2020/tools/source/editor-view-source-button.directive.mjs +2 -9
  39. package/esm2020/tools/tables/editor-add-column-after-button.directive.mjs +3 -3
  40. package/esm2020/tools/tables/editor-add-column-before-button.directive.mjs +3 -3
  41. package/esm2020/tools/tables/editor-add-row-after-button.directive.mjs +3 -3
  42. package/esm2020/tools/tables/editor-add-row-before-button.directive.mjs +3 -3
  43. package/esm2020/tools/tables/editor-delete-column-button.directive.mjs +3 -3
  44. package/esm2020/tools/tables/editor-delete-row-button.directive.mjs +3 -3
  45. package/esm2020/tools/tables/editor-delete-table-button.directive.mjs +3 -3
  46. package/esm2020/tools/typographical-emphasis/editor-bold-button.directive.mjs +2 -9
  47. package/esm2020/tools/typographical-emphasis/editor-italic-button.directive.mjs +2 -9
  48. package/esm2020/tools/typographical-emphasis/editor-strikethrough-button.directive.mjs +2 -9
  49. package/esm2020/tools/typographical-emphasis/editor-subscript-button.directive.mjs +2 -9
  50. package/esm2020/tools/typographical-emphasis/editor-superscript-button.directive.mjs +2 -9
  51. package/esm2020/tools/typographical-emphasis/editor-underline-button.directive.mjs +2 -9
  52. package/esm2020/util.mjs +12 -1
  53. package/fesm2015/progress-kendo-angular-editor.mjs +106 -338
  54. package/fesm2020/progress-kendo-angular-editor.mjs +106 -338
  55. package/index.d.ts +0 -1
  56. package/localization/custom-messages.component.d.ts +1 -1
  57. package/package.json +14 -14
  58. package/schematics/ngAdd/index.js +3 -3
  59. package/tools/alignment/editor-align-center-button.directive.d.ts +2 -9
  60. package/tools/alignment/editor-align-justify-button.directive.d.ts +2 -9
  61. package/tools/alignment/editor-align-left-button.directive.d.ts +2 -9
  62. package/tools/alignment/editor-align-right-button.directive.d.ts +2 -9
  63. package/tools/blockquote/editor-blockquote-button.directive.d.ts +2 -9
  64. package/tools/colorpicker/editor-back-color.directive.d.ts +4 -0
  65. package/tools/colorpicker/editor-colorpicker.component.d.ts +3 -1
  66. package/tools/colorpicker/editor-fore-color.directive.d.ts +4 -0
  67. package/tools/editor-clean-formatting-button.directive.d.ts +2 -9
  68. package/tools/fontfamily/editor-fontfamily.component.d.ts +1 -1
  69. package/tools/fontsize/editor-fontsize.component.d.ts +1 -3
  70. package/tools/format/editor-format.component.d.ts +1 -1
  71. package/tools/history/editor-redo-button.directive.d.ts +2 -9
  72. package/tools/history/editor-undo-button.directive.d.ts +2 -9
  73. package/tools/image/editor-insert-image-button.directive.d.ts +2 -9
  74. package/tools/indentation/editor-indent-button.directive.d.ts +2 -9
  75. package/tools/indentation/editor-outdent-button.directive.d.ts +2 -9
  76. package/tools/link/editor-create-link-button.directive.d.ts +2 -9
  77. package/tools/link/editor-insert-file-button.directive.d.ts +3 -3
  78. package/tools/link/editor-unlink-button.directive.d.ts +2 -9
  79. package/tools/list/editor-insert-ordered-list-button.directive.d.ts +2 -9
  80. package/tools/list/editor-insert-unordered-list-button.directive.d.ts +2 -9
  81. package/tools/print/editor-print-button.directive.d.ts +2 -9
  82. package/tools/select-all/select-all-button.directive.d.ts +2 -9
  83. package/tools/source/editor-view-source-button.directive.d.ts +2 -9
  84. package/tools/tables/editor-add-column-after-button.directive.d.ts +3 -3
  85. package/tools/tables/editor-add-column-before-button.directive.d.ts +3 -3
  86. package/tools/tables/editor-add-row-after-button.directive.d.ts +3 -3
  87. package/tools/tables/editor-add-row-before-button.directive.d.ts +3 -3
  88. package/tools/tables/editor-delete-column-button.directive.d.ts +3 -3
  89. package/tools/tables/editor-delete-row-button.directive.d.ts +3 -3
  90. package/tools/tables/editor-delete-table-button.directive.d.ts +3 -3
  91. package/tools/typographical-emphasis/editor-bold-button.directive.d.ts +2 -9
  92. package/tools/typographical-emphasis/editor-italic-button.directive.d.ts +2 -9
  93. package/tools/typographical-emphasis/editor-strikethrough-button.directive.d.ts +2 -9
  94. package/tools/typographical-emphasis/editor-subscript-button.directive.d.ts +2 -9
  95. package/tools/typographical-emphasis/editor-superscript-button.directive.d.ts +2 -9
  96. package/tools/typographical-emphasis/editor-underline-button.directive.d.ts +2 -9
  97. package/util.d.ts +12 -1
  98. package/esm2020/preventable-events/paste-event-data.mjs +0 -5
  99. package/preventable-events/paste-event-data.d.ts +0 -21
@@ -40,8 +40,8 @@ const packageMetadata = {
40
40
  name: '@progress/kendo-angular-editor',
41
41
  productName: 'Kendo UI for Angular',
42
42
  productCodes: ['KENDOUIANGULAR', 'KENDOUICOMPLETE'],
43
- publishDate: 1687932622,
44
- version: '13.1.0',
43
+ publishDate: 1688385076,
44
+ version: '13.1.1-develop.1',
45
45
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
46
46
  };
47
47
 
@@ -621,7 +621,18 @@ const conditionallyExecute = (fn) => (condition) => (param) => (condition ? fn(p
621
621
  const pipe = (...fns) => x => fns.reduce((y, f) => f(y), x);
622
622
  // This re-declaration is neccessary for proper API generation
623
623
  /**
624
- * A method for extracting the text from the current editor state's selection
624
+ * A method for extracting the text from the current editor state's selection ([see example]({% slug plugins_editor %}#toc-popup-tools)).
625
+ *
626
+ * ```ts
627
+ * import {getSelectionText} from '@progress/kendo-angular-editor';
628
+ *
629
+ * export class AppComponent {
630
+ * @ViewChild('editor') public editor;
631
+ * public onClick(){
632
+ * const selection = getSelectionText(this.editor.view.state)
633
+ * }
634
+ * }
635
+ * ```
625
636
  * @param state
626
637
  * @returns
627
638
  */
@@ -1860,7 +1871,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
1860
1871
  * A component which configures an existing `DropDownListComponent` as an Editor tool
1861
1872
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
1862
1873
  * The component associates a `kendo-dropdownlist` with an Editor command that changes the format of a content block and
1863
- * automatically defines the options of the drop-down list and sets its values.
1874
+ * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
1864
1875
  *
1865
1876
  * @example
1866
1877
  * ```ts-no-run
@@ -2401,22 +2412,15 @@ class EditorCommandButton extends EditorCommandBaseDirective {
2401
2412
  }
2402
2413
 
2403
2414
  /**
2404
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Bold tool
2415
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Bold** tool
2405
2416
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2406
- * The directive will predefine the `icon` and `click` event handlers of the button.
2417
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2407
2418
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2408
2419
  *
2409
2420
  * @example
2410
2421
  * ```html
2411
2422
  * <kendo-toolbar-button kendoEditorBoldButton></kendo-toolbar-button>
2412
2423
  * ```
2413
- *
2414
- * The following example demonstrates how to change the default icon that is applied by the directive.
2415
- *
2416
- * @example
2417
- * ```html
2418
- * <kendo-toolbar-button kendoEditorBoldButton ></kendo-toolbar-button>
2419
- * ```
2420
2424
  */
2421
2425
  class EditorBoldButtonDirective extends EditorCommandButton {
2422
2426
  constructor(button, localization, providerService, toolsService) {
@@ -2433,22 +2437,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2433
2437
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2434
2438
 
2435
2439
  /**
2436
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Italic tool
2440
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Italic** tool
2437
2441
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2438
- * The directive will predefine the `icon` and `click` event handlers of the button.
2442
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2439
2443
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2440
2444
  *
2441
2445
  * @example
2442
2446
  * ```html
2443
2447
  * <kendo-toolbar-button kendoEditorItalicButton></kendo-toolbar-button>
2444
2448
  * ```
2445
- *
2446
- * The following example demonstrates how to change the default icon that is applied by the directive.
2447
- *
2448
- * @example
2449
- * ```html
2450
- * <kendo-toolbar-button kendoEditorItalicButton ></kendo-toolbar-button>
2451
- * ```
2452
2449
  */
2453
2450
  class EditorItalicButtonDirective extends EditorCommandButton {
2454
2451
  constructor(button, localization, providerService, toolsService) {
@@ -2465,22 +2462,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2465
2462
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2466
2463
 
2467
2464
  /**
2468
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Underline tool
2465
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Underline** tool
2469
2466
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2470
- * The directive will predefine the `icon` and `click` event handlers of the button.
2467
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2471
2468
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2472
2469
  *
2473
2470
  * @example
2474
2471
  * ```html
2475
2472
  * <kendo-toolbar-button kendoEditorUnderlineButton></kendo-toolbar-button>
2476
2473
  * ```
2477
- *
2478
- * The following example demonstrates how to change the default icon that is applied by the directive.
2479
- *
2480
- * @example
2481
- * ```html
2482
- * <kendo-toolbar-button kendoEditorUnderlineButton ></kendo-toolbar-button>
2483
- * ```
2484
2474
  */
2485
2475
  class EditorUnderlineButtonDirective extends EditorCommandButton {
2486
2476
  constructor(button, localization, providerService, toolsService) {
@@ -2497,22 +2487,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2497
2487
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2498
2488
 
2499
2489
  /**
2500
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AlignLeft tool
2490
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignLeft** tool
2501
2491
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2502
- * The directive will predefine the `icon` and `click` event handlers of the button.
2492
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2503
2493
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2504
2494
  *
2505
2495
  * @example
2506
2496
  * ```html
2507
2497
  * <kendo-toolbar-button kendoEditorAlignLeftButton></kendo-toolbar-button>
2508
2498
  * ```
2509
- *
2510
- * The following example demonstrates how to change the default icon that is applied by the directive.
2511
- *
2512
- * @example
2513
- * ```html
2514
- * <kendo-toolbar-button kendoEditorAlignLeftButton ></kendo-toolbar-button>
2515
- * ```
2516
2499
  */
2517
2500
  class EditorAlignLeftButtonDirective extends EditorCommandButton {
2518
2501
  constructor(button, localization, providerService, toolsService) {
@@ -2529,22 +2512,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2529
2512
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2530
2513
 
2531
2514
  /**
2532
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AlignCenter tool
2515
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignCenter** tool
2533
2516
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2534
- * The directive will predefine the `icon` and `click` event handlers of the button.
2517
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2535
2518
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2536
2519
  *
2537
2520
  * @example
2538
2521
  * ```html
2539
2522
  * <kendo-toolbar-button kendoEditorAlignCenterButton></kendo-toolbar-button>
2540
2523
  * ```
2541
- *
2542
- * The following example demonstrates how to change the default icon that is applied by the directive.
2543
- *
2544
- * @example
2545
- * ```html
2546
- * <kendo-toolbar-button kendoEditorAlignCenterButton ></kendo-toolbar-button>
2547
- * ```
2548
2524
  */
2549
2525
  class EditorAlignCenterButtonDirective extends EditorCommandButton {
2550
2526
  constructor(button, localization, providerService, toolsService) {
@@ -2561,22 +2537,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2561
2537
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2562
2538
 
2563
2539
  /**
2564
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AlignRight tool
2540
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignRight** tool
2565
2541
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2566
- * The directive will predefine the `icon` and `click` event handlers of the button.
2542
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2567
2543
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2568
2544
  *
2569
2545
  * @example
2570
2546
  * ```html
2571
2547
  * <kendo-toolbar-button kendoEditorAlignRightButton></kendo-toolbar-button>
2572
2548
  * ```
2573
- *
2574
- * The following example demonstrates how to change the default icon that is applied by the directive.
2575
- *
2576
- * @example
2577
- * ```html
2578
- * <kendo-toolbar-button kendoEditorAlignRightButton ></kendo-toolbar-button>
2579
- * ```
2580
2549
  */
2581
2550
  class EditorAlignRightButtonDirective extends EditorCommandButton {
2582
2551
  constructor(button, localization, providerService, toolsService) {
@@ -2593,22 +2562,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2593
2562
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2594
2563
 
2595
2564
  /**
2596
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AlignJustify tool
2565
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AlignJustify** tool
2597
2566
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2598
- * The directive will predefine the `icon` and `click` event handlers of the button.
2567
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2599
2568
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2600
2569
  *
2601
2570
  * @example
2602
2571
  * ```html
2603
2572
  * <kendo-toolbar-button kendoEditorAlignJustifyButton></kendo-toolbar-button>
2604
2573
  * ```
2605
- *
2606
- * The following example demonstrates how to change the default icon that is applied by the directive.
2607
- *
2608
- * @example
2609
- * ```html
2610
- * <kendo-toolbar-button kendoEditorAlignJustifyButton ></kendo-toolbar-button>
2611
- * ```
2612
2574
  */
2613
2575
  class EditorAlignJustifyButtonDirective extends EditorCommandButton {
2614
2576
  constructor(button, localization, providerService, toolsService) {
@@ -2625,22 +2587,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2625
2587
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2626
2588
 
2627
2589
  /**
2628
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor InsertUnorderedList tool
2590
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertUnorderedList** tool
2629
2591
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2630
- * The directive will predefine the `icon` and `click` event handlers of the button.
2592
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2631
2593
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2632
2594
  *
2633
2595
  * @example
2634
2596
  * ```html
2635
2597
  * <kendo-toolbar-button kendoEditorInsertUnorderedListButton></kendo-toolbar-button>
2636
2598
  * ```
2637
- *
2638
- * The following example demonstrates how to change the default icon that is applied by the directive.
2639
- *
2640
- * @example
2641
- * ```html
2642
- * <kendo-toolbar-button kendoEditorInsertUnorderedListButton ></kendo-toolbar-button>
2643
- * ```
2644
2599
  */
2645
2600
  class EditorInsertUnorderedListButtonDirective extends EditorCommandButton {
2646
2601
  constructor(button, localization, providerService, toolsService) {
@@ -2657,22 +2612,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2657
2612
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2658
2613
 
2659
2614
  /**
2660
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor InsertOrderedList tool
2615
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertOrderedList** tool
2661
2616
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2662
- * The directive will predefine the `icon` and `click` event handlers of the button.
2617
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2663
2618
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
2664
2619
  *
2665
2620
  * @example
2666
2621
  * ```html
2667
2622
  * <kendo-toolbar-button kendoEditorInsertOrderedListButton></kendo-toolbar-button>
2668
2623
  * ```
2669
- *
2670
- * The following example demonstrates how to change the default icon that is applied by the directive.
2671
- *
2672
- * @example
2673
- * ```html
2674
- * <kendo-toolbar-button kendoEditorInsertOrderedListButton ></kendo-toolbar-button>
2675
- * ```
2676
2624
  */
2677
2625
  class EditorInsertOrderedListButtonDirective extends EditorCommandButton {
2678
2626
  constructor(button, localization, providerService, toolsService) {
@@ -2689,22 +2637,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2689
2637
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2690
2638
 
2691
2639
  /**
2692
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Indent tool
2640
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Indent** tool
2693
2641
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2694
- * The directive will predefine the `icon` and `click` event handlers of the button.
2642
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2695
2643
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
2696
2644
  *
2697
2645
  * @example
2698
2646
  * ```html
2699
2647
  * <kendo-toolbar-button kendoEditorIndentButton></kendo-toolbar-button>
2700
2648
  * ```
2701
- *
2702
- * The following example demonstrates how to change the default icon that is applied by the directive.
2703
- *
2704
- * @example
2705
- * ```html
2706
- * <kendo-toolbar-button kendoEditorIndentButton ></kendo-toolbar-button>
2707
- * ```
2708
2649
  */
2709
2650
  class EditorIndentButtonDirective extends EditorCommandButton {
2710
2651
  constructor(button, localization, providerService, toolsService) {
@@ -2721,22 +2662,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2721
2662
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2722
2663
 
2723
2664
  /**
2724
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Outdent tool
2665
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Outdent** tool
2725
2666
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2726
- * The directive will predefine the `icon` and `click` event handlers of the button.
2667
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2727
2668
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
2728
2669
  *
2729
2670
  * @example
2730
2671
  * ```html
2731
2672
  * <kendo-toolbar-button kendoEditorOutdentButton></kendo-toolbar-button>
2732
2673
  * ```
2733
- *
2734
- * The following example demonstrates how to change the default icon that is applied by the directive.
2735
- *
2736
- * @example
2737
- * ```html
2738
- * <kendo-toolbar-button kendoEditorOutdentButton ></kendo-toolbar-button>
2739
- * ```
2740
2674
  */
2741
2675
  class EditorOutdentButtonDirective extends EditorCommandButton {
2742
2676
  constructor(button, localization, providerService, toolsService) {
@@ -2776,22 +2710,15 @@ class EditorCommandDialog extends EditorCommandBaseDirective {
2776
2710
  }
2777
2711
 
2778
2712
  /**
2779
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor CreateLink tool
2713
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **CreateLink** tool
2780
2714
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2781
- * The directive will predefine the `icon` and `click` event handlers of the button.
2715
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2782
2716
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
2783
2717
  *
2784
2718
  * @example
2785
2719
  * ```html
2786
2720
  * <kendo-toolbar-button kendoEditorCreateLinkButton></kendo-toolbar-button>
2787
2721
  * ```
2788
- *
2789
- * The following example demonstrates how to change the default icon that is applied by the directive.
2790
- *
2791
- * @example
2792
- * ```html
2793
- * <kendo-toolbar-button kendoEditorCreateLinkButton ></kendo-toolbar-button>
2794
- * ```
2795
2722
  */
2796
2723
  class EditorCreateLinkButtonDirective extends EditorCommandDialog {
2797
2724
  constructor(button, localization, providerService, toolsService) {
@@ -2808,22 +2735,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2808
2735
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2809
2736
 
2810
2737
  /**
2811
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Unlink tool
2738
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Unlink** tool
2812
2739
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2813
- * The directive will predefine the `icon` and `click` event handlers of the button.
2740
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2814
2741
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
2815
2742
  *
2816
2743
  * @example
2817
2744
  * ```html
2818
2745
  * <kendo-toolbar-button kendoEditorUnlinkButton></kendo-toolbar-button>
2819
2746
  * ```
2820
- *
2821
- * The following example demonstrates how to change the default icon that is applied by the directive.
2822
- *
2823
- * @example
2824
- * ```html
2825
- * <kendo-toolbar-button kendoEditorUnlinkButton ></kendo-toolbar-button>
2826
- * ```
2827
2747
  */
2828
2748
  class EditorUnlinkButtonDirective extends EditorCommandButton {
2829
2749
  constructor(button, localization, providerService, toolsService) {
@@ -2840,21 +2760,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
2840
2760
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
2841
2761
 
2842
2762
  /**
2843
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor InsertImage tool
2763
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **InsertImage** tool
2844
2764
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
2845
- * The directive will predefine the `icon` and `click` event handlers of the button.
2765
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
2846
2766
  *
2847
2767
  * @example
2848
2768
  * ```html
2849
2769
  * <kendo-toolbar-button kendoEditorInsertImageButton></kendo-toolbar-button>
2850
2770
  * ```
2851
- *
2852
- * The following example demonstrates how to change the default icon that is applied by the directive.
2853
- *
2854
- * @example
2855
- * ```html
2856
- * <kendo-toolbar-button kendoEditorInsertImageButton ></kendo-toolbar-button>
2857
- * ```
2858
2771
  */
2859
2772
  class EditorInsertImageButtonDirective extends EditorCommandDialog {
2860
2773
  constructor(button, localization, providerService, toolsService) {
@@ -3151,13 +3064,6 @@ class EditorComponent {
3151
3064
  * Defines a function which determines the plugins that will be used when initializing the Editor.
3152
3065
  * It exposes the default plugins collection as an argument, and returns
3153
3066
  * the plugins collection that will be used when creating the Editor component. ([see example]({% slug plugins_editor %}))
3154
- *
3155
- * ```ts-no-run
3156
- * pluginsCallback(defaultPlugins: Plugin[]): Plugin[] {
3157
- * const myPlugin = new Plugin({/custom plugin code/});
3158
- * return [...defaultPlugins, myPlugin];
3159
- * }
3160
- * ```
3161
3067
  */
3162
3068
  set plugins(fn) {
3163
3069
  if (isDevMode) {
@@ -3290,46 +3196,7 @@ class EditorComponent {
3290
3196
  * ([more information and example]({% slug toolbartools_editor %}#toc-custom-tools)).
3291
3197
  *
3292
3198
  * @param {EditorCommand} commandName - The command that will be executed.
3293
- * @param {any} attr - Optional parameters for the command. Apart from the following list,
3294
- * the parameters do not expect specific attributes when you call them:
3295
- * - `format` - Accepts an object with the `tag` property.
3296
- * The supported tags are `p` and any of the `h1` to `h6` heading tags.
3297
- * - `createLink` - Accepts an object with the `href`, `title`, and `target` properties. The `href` property is mandatory.
3298
- * - `setHTML` - Accepts a `string` parameter.
3299
- * - `insertTable` - Accepts an object with the `rows` and `cols` properties. The number values are zero based.
3300
- *
3301
- * @example
3302
- * ```ts-no-run
3303
- * // Toggles the bold styling.
3304
- * editor.exec('bold');
3305
- *
3306
- * // Creates a bullet list.
3307
- * editor.exec('insertUnorderedList');
3308
- *
3309
- * // Creates a link.
3310
- * editor.exec('createLink', { href: 'www.progress.com', title: 'Progress', target: 'window' });
3311
- *
3312
- * // Inserts a file.
3313
- * editor.exec('insertFile', { href: 'www.progress.com/resources/myfile.doc', title: 'My file', target: 'window' });
3314
- *
3315
- * // Inserts a image.
3316
- * editor.exec('insertImage', { src: 'www.progress.com/resources/logo.jpg', title: 'Progress', target: 'window' });
3317
- *
3318
- * // Inserts a text at a given position. If no position is specified, the text will be inserted after the cursor.
3319
- * editor.exec('insertText', { text: 'Hello World!', from: 0, to: 0 });
3320
- *
3321
- * // Changes the format of a text block.
3322
- * editor.exec('format', { tag: 'h2' });
3323
- *
3324
- * // Changes the font size of the selected text.
3325
- * editor.exec('fontSize', 24);
3326
- *
3327
- * // Changes the content of the Editor.
3328
- * editor.exec('setHTML', '<p>HTML content</p>');
3329
- *
3330
- * // Creates and inserts a table with the specified number of rows and columns. Numbers are zero based.
3331
- * this.editor.exec("insertTable", { rows: 3, cols: 5 });
3332
- * ```
3199
+ * @param {any} attr - Optional parameters for the command.
3333
3200
  */
3334
3201
  exec(commandName, attr) {
3335
3202
  // normalizes setHTML attributes
@@ -3355,22 +3222,6 @@ class EditorComponent {
3355
3222
  /**
3356
3223
  * Opens a dialog.
3357
3224
  * @param {DialogCommand} dialogName - The name of the dialog that will open.
3358
- *
3359
- * The supported values are:
3360
- * * `createLink`
3361
- * * `viewSource`
3362
- * * `insertFile`
3363
- * * `insertImage`
3364
- * * `tableWizard`
3365
- *
3366
- * @example
3367
- * ```ts-no-run
3368
- * // Opens a `createLink` dialog.
3369
- * editor.openDialog('createLink');
3370
- *
3371
- * // Opens a `viewSource` dialog.
3372
- * editor.openDialog('viewSource');
3373
- * ```
3374
3225
  */
3375
3226
  openDialog(dialogName) {
3376
3227
  const editorDialogs = {
@@ -4763,14 +4614,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
4763
4614
  * A component which configures an existing `DropDownListComponent` as an Editor tool
4764
4615
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
4765
4616
  * The component associates a `kendo-dropdownlist` with an Editor command that changes the font size of a content block and
4766
- * automatically defines the options of the drop-down list and sets its values.
4617
+ * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
4767
4618
  *
4768
4619
  * @example
4769
4620
  * ```ts-no-run
4770
4621
  * <kendo-toolbar-dropdownlist kendoEditorFontSize></kendo-toolbar-dropdownlist>
4771
4622
  * ```
4772
- *
4773
- * Use the FontSize tool to provide a custom list of font size options including any allowed units ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
4774
4623
  */
4775
4624
  class EditorFontSizeComponent extends ToolBarToolComponent {
4776
4625
  constructor(dialogService, localization, providerService, toolsService, renderer) {
@@ -5000,7 +4849,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5000
4849
  * A component which configures an existing `DropDownListComponent` as an Editor tool
5001
4850
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5002
4851
  * The component associates a `kendo-toolbar-dropdownlist` with an Editor command that changes the font family of a content block and
5003
- * automatically defines the options of the drop-down list and sets its values.
4852
+ * automatically defines the options of the drop-down list and sets its values ([see example]({% slug toolbartools_editor %}#toc-dropdownlists)).
5004
4853
  *
5005
4854
  * @example
5006
4855
  * ```ts-no-run
@@ -5227,7 +5076,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5227
5076
  /**
5228
5077
  * A component which configures an existing ColorPickerComponent as a ToolBar tool.
5229
5078
  * To associate a `kendo-toolbar-colorpicker` with an Editor command that changes the
5230
- * foreground or the background color of the text, use the `kendoEditorForeColor` or `kendoEditorBackColor` directive.
5079
+ * foreground or the background color of the text, use the `kendoEditorForeColor` or `kendoEditorBackColor` directivе ([more information]({% slug toolbartools_editor %}#toc-colorpickers)).
5231
5080
  */
5232
5081
  class EditorColorPickerComponent extends ToolBarToolComponent {
5233
5082
  constructor(localization, dialogService, ngZone, providerService, renderer) {
@@ -5239,6 +5088,8 @@ class EditorColorPickerComponent extends ToolBarToolComponent {
5239
5088
  this.tabindex = -1;
5240
5089
  /**
5241
5090
  * Specifies if the component should be disabled.
5091
+ *
5092
+ * @default false
5242
5093
  */
5243
5094
  this.disabled = false;
5244
5095
  /**
@@ -5741,21 +5592,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5741
5592
  }] } });
5742
5593
 
5743
5594
  /**
5744
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Blockquote tool
5595
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Blockquote** tool
5745
5596
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5746
- * The directive will predefine the `icon` and `click` event handlers of the button.
5597
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5747
5598
  *
5748
5599
  * @example
5749
5600
  * ```html
5750
5601
  * <kendo-toolbar-button kendoEditorBlockquoteButton></kendo-toolbar-button>
5751
5602
  * ```
5752
- *
5753
- * The following example demonstrates how to change the default icon that is applied by the directive.
5754
- *
5755
- * @example
5756
- * ```html
5757
- * <kendo-toolbar-button kendoEditorBlockquoteButton ></kendo-toolbar-button>
5758
- * ```
5759
5603
  */
5760
5604
  class EditorBlockquoteDirective extends EditorCommandButton {
5761
5605
  constructor(button, localization, providerService, toolsService) {
@@ -5772,22 +5616,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5772
5616
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5773
5617
 
5774
5618
  /**
5775
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Redo tool
5619
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Redo** tool
5776
5620
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5777
- * The directive will predefine the `icon` and `click` event handlers of the button.
5621
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5778
5622
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
5779
5623
  *
5780
5624
  * @example
5781
5625
  * ```html
5782
5626
  * <kendo-toolbar-button kendoEditorRedoButton></kendo-toolbar-button>
5783
5627
  * ```
5784
- *
5785
- * The following example demonstrates how to change the default icon that is applied by the directive.
5786
- *
5787
- * @example
5788
- * ```html
5789
- * <kendo-toolbar-button kendoEditorRedoButton ></kendo-toolbar-button>
5790
- * ```
5791
5628
  */
5792
5629
  class EditorRedoButtonDirective extends EditorCommandButton {
5793
5630
  constructor(button, localization, providerService, toolsService) {
@@ -5804,22 +5641,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5804
5641
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5805
5642
 
5806
5643
  /**
5807
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Undo tool
5644
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Undo** tool
5808
5645
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5809
- * The directive will predefine the `icon` and `click` event handlers of the button.
5646
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5810
5647
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
5811
5648
  *
5812
5649
  * @example
5813
5650
  * ```html
5814
5651
  * <kendo-toolbar-button kendoEditorUndoButton></kendo-toolbar-button>
5815
5652
  * ```
5816
- *
5817
- * The following example demonstrates how to change the default icon that is applied by the directive.
5818
- *
5819
- * @example
5820
- * ```html
5821
- * <kendo-toolbar-button kendoEditorUndoButton ></kendo-toolbar-button>
5822
- * ```
5823
5653
  */
5824
5654
  class EditorUndoButtonDirective extends EditorCommandButton {
5825
5655
  constructor(button, localization, providerService, toolsService) {
@@ -5836,21 +5666,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5836
5666
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5837
5667
 
5838
5668
  /**
5839
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor ViewSource tool
5669
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **ViewSource** tool
5840
5670
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5841
- * The directive will predefine the `icon` and `click` event handlers of the button.
5671
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5842
5672
  *
5843
5673
  * @example
5844
5674
  * ```html
5845
5675
  * <kendo-toolbar-button kendoEditorViewSourceButton></kendo-toolbar-button>
5846
5676
  * ```
5847
- *
5848
- * The following example demonstrates how to change the default icon that is applied by the directive.
5849
- *
5850
- * @example
5851
- * ```html
5852
- * <kendo-toolbar-button kendoEditorViewSourceButton ></kendo-toolbar-button>
5853
- * ```
5854
5677
  */
5855
5678
  class EditorViewSourceButtonDirective extends EditorCommandDialog {
5856
5679
  constructor(button, localization, providerService, toolsService) {
@@ -5867,22 +5690,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5867
5690
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5868
5691
 
5869
5692
  /**
5870
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Strikethrough tool
5693
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Strikethrough** tool
5871
5694
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5872
- * The directive will predefine the `icon` and `click` event handlers of the button.
5695
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5873
5696
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
5874
5697
  *
5875
5698
  * @example
5876
5699
  * ```html
5877
5700
  * <kendo-toolbar-button kendoEditorStrikethroughButton></kendo-toolbar-button>
5878
5701
  * ```
5879
- *
5880
- * The following example demonstrates how to change the default icon that is applied by the directive.
5881
- *
5882
- * @example
5883
- * ```html
5884
- * <kendo-toolbar-button kendoEditorStrikethroughButton ></kendo-toolbar-button>
5885
- * ```
5886
5702
  */
5887
5703
  class EditorStrikethroughButtonDirective extends EditorCommandButton {
5888
5704
  constructor(button, localization, providerService, toolsService) {
@@ -5899,22 +5715,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5899
5715
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5900
5716
 
5901
5717
  /**
5902
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Subscript tool
5718
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Subscript** tool
5903
5719
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5904
- * The directive will predefine the `icon` and `click` event handlers of the button.
5720
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5905
5721
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
5906
5722
  *
5907
5723
  * @example
5908
5724
  * ```html
5909
5725
  * <kendo-toolbar-button kendoEditorSubscriptButton></kendo-toolbar-button>
5910
5726
  * ```
5911
- *
5912
- * The following example demonstrates how to change the default icon that is applied by the directive.
5913
- *
5914
- * @example
5915
- * ```html
5916
- * <kendo-toolbar-button kendoEditorSubscriptButton ></kendo-toolbar-button>
5917
- * ```
5918
5727
  */
5919
5728
  class EditorSubscriptButtonDirective extends EditorCommandButton {
5920
5729
  constructor(button, localization, providerService, toolsService) {
@@ -5931,22 +5740,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5931
5740
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5932
5741
 
5933
5742
  /**
5934
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Superscript tool
5743
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Superscript** tool
5935
5744
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5936
- * The directive will predefine the `icon` and `click` event handlers of the button.
5745
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5937
5746
  * In addition, the directive updates the `selected` state of the button according to the cursor position in the editing area.
5938
5747
  *
5939
5748
  * @example
5940
5749
  * ```html
5941
5750
  * <kendo-toolbar-button kendoEditorSuperscriptButton></kendo-toolbar-button>
5942
5751
  * ```
5943
- *
5944
- * The following example demonstrates how to change the default icon that is applied by the directive.
5945
- *
5946
- * @example
5947
- * ```html
5948
- * <kendo-toolbar-button kendoEditorSuperscriptButton ></kendo-toolbar-button>
5949
- * ```
5950
5752
  */
5951
5753
  class EditorSuperscriptButtonDirective extends EditorCommandButton {
5952
5754
  constructor(button, localization, providerService, toolsService) {
@@ -5963,12 +5765,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5963
5765
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
5964
5766
 
5965
5767
  /**
5966
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor 'Insert File' tool
5768
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Insert File** tool
5967
5769
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5968
- * The directive will predefine the `icon` and `click` event handlers of the button.
5770
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
5969
5771
  *
5970
5772
  * @example
5971
- * ```ts-no-run
5773
+ * ```html
5972
5774
  * <kendo-toolbar-button kendoEditorInsertFileButton></kendo-toolbar-button>
5973
5775
  * ```
5974
5776
  */
@@ -5990,6 +5792,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
5990
5792
  * A directive which configures an `EditorColorPickerComponent`
5991
5793
  * for manipulating the foreground color of the text
5992
5794
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5795
+ *
5796
+ * ```html
5797
+ * <kendo-toolbar-colorpicker kendoEditorForeColor ></kendo-toolbar-colorpicker>
5798
+ * ```
5993
5799
  */
5994
5800
  class EditorForeColorDirective {
5995
5801
  constructor(colorPicker) {
@@ -6012,6 +5818,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6012
5818
  * A directive which configures an `EditorColorPickerComponent`
6013
5819
  * for manipulating the background color of the text
6014
5820
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
5821
+ *
5822
+ * ```html
5823
+ * <kendo-toolbar-colorpicker kendoEditorBackColor view="gradient"> </kendo-toolbar-colorpicker>
5824
+ * ```
6015
5825
  */
6016
5826
  class EditorBackColorDirective {
6017
5827
  constructor(colorPicker) {
@@ -6031,21 +5841,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6031
5841
  }], ctorParameters: function () { return [{ type: EditorColorPickerComponent }]; } });
6032
5842
 
6033
5843
  /**
6034
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Clean Formatting tool
5844
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Clean Formatting** tool
6035
5845
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6036
- * The directive will predefine the `icon` and `click` event handlers of the button.
5846
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6037
5847
  *
6038
5848
  * @example
6039
5849
  * ```html
6040
5850
  * <kendo-toolbar-button kendoEditorCleanFormattingButton></kendo-toolbar-button>
6041
5851
  * ```
6042
- *
6043
- * The following example demonstrates how to change the default icon applied by the directive.
6044
- *
6045
- * @example
6046
- * ```html
6047
- * <kendo-toolbar-button kendoEditorCleanFormattingButton ></kendo-toolbar-button>
6048
- * ```
6049
5852
  */
6050
5853
  class EditorCleanFormattingButtonDirective extends EditorCommandButton {
6051
5854
  constructor(button, localization, providerService, toolsService) {
@@ -6062,13 +5865,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6062
5865
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6063
5866
 
6064
5867
  /**
6065
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AddColumnBefore tool
5868
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddColumnBefore** tool
6066
5869
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6067
- * The directive will predefine the `icon` and `click` event handlers of the button.
5870
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6068
5871
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6069
5872
  *
6070
5873
  * @example
6071
- * ```ts-no-run
5874
+ * ```html
6072
5875
  * <kendo-toolbar-button kendoEditorAddColumnBeforeButton></kendo-toolbar-button>
6073
5876
  * ```
6074
5877
  */
@@ -6087,13 +5890,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6087
5890
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6088
5891
 
6089
5892
  /**
6090
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AddColumnAfter tool
5893
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddColumnAfter** tool
6091
5894
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6092
- * The directive will predefine the `icon` and `click` event handlers of the button.
5895
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6093
5896
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6094
5897
  *
6095
5898
  * @example
6096
- * ```ts-no-run
5899
+ * ```html
6097
5900
  * <kendo-toolbar-button kendoEditorAddColumnAfterButton></kendo-toolbar-button>
6098
5901
  * ```
6099
5902
  */
@@ -6112,13 +5915,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6112
5915
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6113
5916
 
6114
5917
  /**
6115
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AddRowBefore tool
5918
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddRowBefore** tool
6116
5919
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6117
- * The directive will predefine the `icon` and `click` event handlers of the button.
5920
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6118
5921
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6119
5922
  *
6120
5923
  * @example
6121
- * ```ts-no-run
5924
+ * ```html
6122
5925
  * <kendo-toolbar-button kendoEditorAddRowBeforeButton></kendo-toolbar-button>
6123
5926
  * ```
6124
5927
  */
@@ -6137,13 +5940,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6137
5940
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6138
5941
 
6139
5942
  /**
6140
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor AddRowAfter tool
5943
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **AddRowAfter** tool
6141
5944
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6142
- * The directive will predefine the `icon` and `click` event handlers of the button.
5945
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6143
5946
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6144
5947
  *
6145
5948
  * @example
6146
- * ```ts-no-run
5949
+ * ```html
6147
5950
  * <kendo-toolbar-button kendoEditorAddRowAfterButton></kendo-toolbar-button>
6148
5951
  * ```
6149
5952
  */
@@ -6162,13 +5965,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6162
5965
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6163
5966
 
6164
5967
  /**
6165
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor DeleteColumn tool
5968
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteColumn** tool
6166
5969
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6167
- * The directive will predefine the `icon` and `click` event handlers of the button.
5970
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6168
5971
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6169
5972
  *
6170
5973
  * @example
6171
- * ```ts-no-run
5974
+ * ```html
6172
5975
  * <kendo-toolbar-button kendoEditorDeleteColumnButton></kendo-toolbar-button>
6173
5976
  * ```
6174
5977
  */
@@ -6187,13 +5990,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6187
5990
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6188
5991
 
6189
5992
  /**
6190
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor DeleteRow tool
5993
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteRow** tool
6191
5994
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6192
- * The directive will predefine the `icon` and `click` event handlers of the button.
5995
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6193
5996
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6194
5997
  *
6195
5998
  * @example
6196
- * ```ts-no-run
5999
+ * ```html
6197
6000
  * <kendo-toolbar-button kendoEditorDeleteRowButton></kendo-toolbar-button>
6198
6001
  * ```
6199
6002
  */
@@ -6212,13 +6015,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6212
6015
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6213
6016
 
6214
6017
  /**
6215
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor DeleteTable tool
6018
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **DeleteTable** tool
6216
6019
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6217
- * The directive will predefine the `icon` and `click` event handlers of the button.
6020
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6218
6021
  * In addition, the directive updates the `disabled` state of the button according to the cursor position in the editing area.
6219
6022
  *
6220
6023
  * @example
6221
- * ```ts-no-run
6024
+ * ```html
6222
6025
  * <kendo-toolbar-button kendoEditorDeleteTableButton></kendo-toolbar-button>
6223
6026
  * ```
6224
6027
  */
@@ -6292,7 +6095,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6292
6095
 
6293
6096
  /**
6294
6097
  * Custom component messages override default component messages
6295
- * ([see example]({% slug globalization_editor %}#toc-localization)).
6098
+ * ([see example]({% slug globalization_editor %}#toc-custom-messages)).
6296
6099
  */
6297
6100
  class CustomMessagesComponent extends MessagesDirective {
6298
6101
  constructor(service) {
@@ -6325,9 +6128,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6325
6128
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
6326
6129
 
6327
6130
  /**
6328
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor Print tool
6131
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **Print** tool
6329
6132
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6330
- * The directive will predefine the `icon` and `click` event handlers of the button.
6133
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6331
6134
  *
6332
6135
  * > The Editor Print tool is supported in the default [`iframe`](https://www.telerik.com/kendo-angular-ui-develop/components/editor/api/EditorComponent/#toc-iframe) mode only.
6333
6136
  *
@@ -6335,13 +6138,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6335
6138
  * ```html
6336
6139
  * <kendo-toolbar-button kendoEditorPrintButton></kendo-toolbar-button>
6337
6140
  * ```
6338
- *
6339
- * The following example demonstrates how to change the default icon that is applied by the directive.
6340
- *
6341
- * @example
6342
- * ```html
6343
- * <kendo-toolbar-button kendoEditorPrintButton ></kendo-toolbar-button>
6344
- * ```
6345
6141
  */
6346
6142
  class EditorPrintDirective extends EditorCommandButton {
6347
6143
  constructor(button, localization, providerService, toolsService) {
@@ -6376,21 +6172,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.12", ngImpo
6376
6172
  }], ctorParameters: function () { return [{ type: i1$3.ToolBarButtonComponent }, { type: EditorLocalizationService }, { type: ProviderService }, { type: EditorToolsService }]; } });
6377
6173
 
6378
6174
  /**
6379
- * A directive which configures an existing `ToolBarButtonComponent` as an Editor SelectAll tool
6175
+ * A directive which configures an existing `ToolBarButtonComponent` as an Editor **SelectAll** tool
6380
6176
  * ([see example]({% slug toolbartools_editor %}#toc-built-in-tools)).
6381
- * The directive will predefine the `icon` and `click` event handlers of the button.
6177
+ * The directive will predefine the SVG icon and `click` event handlers of the button.
6382
6178
  *
6383
6179
  * @example
6384
6180
  * ```html
6385
6181
  * <kendo-toolbar-button kendoEditorSelectAllButton></kendo-toolbar-button>
6386
6182
  * ```
6387
- *
6388
- * The following example demonstrates how to change the default icon that is applied by the directive.
6389
- *
6390
- * @example
6391
- * ```html
6392
- * <kendo-toolbar-button kendoEditorSelectAllButton ></kendo-toolbar-button>
6393
- * ```
6394
6183
  */
6395
6184
  class EditorSelectAllButtonDirective extends EditorCommandButton {
6396
6185
  constructor(button, localization, providerService, toolsService) {
@@ -6500,40 +6289,19 @@ const INTERNAL_COMPONENTS = [
6500
6289
  /**
6501
6290
  * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Editor component.
6502
6291
  *
6503
- * The package exports:
6504
- * - `EditorComponent`&mdash;The `EditorComponent` class.
6505
- * - `EditorButtonDirective`&mdash;The `EditorButton` directive class.
6506
- * - `EditorDropDownDirective`&mdash;The `EditorDropDown` directive class.
6507
- * - `EditorDialogDirective`&mdash;The `EditorDialog` directive class.
6508
- * - `ToolBarDropDownListComponent`&mdash;The `ToolBarDropDownListComponent` directive class.
6509
- * - `ButtonModule`&mdash;The `KendoButton` module.
6510
- * - `ToolBarModule`&mdash;The `KendoToolBar` module.
6511
- *
6512
- * * @example
6513
- *
6514
6292
  * ```ts-no-run
6515
- * // Import the Editor module
6516
- * import { EditorModule } from '@progress/kendo-angular-editor';
6517
- *
6518
- * // The browser platform with a compiler
6519
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
6520
- *
6521
6293
  * import { NgModule } from '@angular/core';
6522
- *
6523
- * // Import the app component
6294
+ * import { EditorModule } from '@progress/kendo-angular-editor';
6295
+ * import { BrowserModule } from "@angular/platform-browser";
6524
6296
  * import { AppComponent } from './app.component';
6525
6297
  *
6526
- * // Define the app module
6527
6298
  * _@NgModule({
6528
- * declarations: [AppComponent], // declare the app component
6529
- * imports: [BrowserModule, EditorModule], // import the Editor module
6299
+ * declarations: [AppComponent],
6300
+ * imports: [BrowserModule, EditorModule],
6530
6301
  * bootstrap: [AppComponent]
6531
6302
  * })
6532
6303
  * export class AppModule {}
6533
6304
  *
6534
- * // Compile and launch the module
6535
- * platformBrowserDynamic().bootstrapModule(AppModule);
6536
- *
6537
6305
  * ```
6538
6306
  */
6539
6307
  class EditorModule {