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