@progress/kendo-angular-editor 2.5.0-dev.202111291334 → 3.0.0-dev.202201121158

package/dist/es2015/editor.component.d.ts

@@ -16,6 +16,7 @@ import { PluginsFn } from './common/plugins-function';
 import { ApplyToWordOptions } from './common/apply-to-word-options';
 import { EditorResizableOptions } from './common/resizable-options.interface';
 import { EditorToolsService } from './tools/tools.service';
+import { EditorPasteEvent } from './preventable-events/paste-event';
 /**
  * Represents the [Kendo UI Editor component for Angular]({% slug overview_editor %}).
  */
@@ -70,14 +71,6 @@ export declare class EditorComponent implements AfterViewInit, ControlValueAcces
      * The hint, which is displayed when the component is empty.
      */
     placeholder: string;
-    /**
-     * By design, the Editor emits `valueChange`, updates the model and the ToolBar state on each keystroke.
-     * When you are interested in ignoring the new values for a given amout of time and take only the most recent one, you can use the `updateInterval` property.
-     * A possible use case is to get the new values and to update the ToolBar state at a maximum rate per second in order to speed up your application.
-     * The specified interval (in milliseconds) should be a positive number.
-     * By default the `updateInterval` is set to 100 miliseconds. If set to zero the delay will be disabled entirely.
-     */
-    updateInterval: number;
     /**
      * By default, whitespace is collapsed as per HTML's rules.
      * Set to `true` to preserve whitespace, but normalize newlines to spaces.
@@ -107,6 +100,11 @@ export declare class EditorComponent implements AfterViewInit, ControlValueAcces
      * Fires when the content area of the Editor is focused ([see example]({% slug overview_editor %}#toc-events)).
      */
     onFocus: EventEmitter<undefined>;
+    /**
+     * Fires when the user performs paste in the content area of the Editor ([see example]({% slug overview_editor %}#toc-events)).
+     * The event is preventable. If you cancel it, the Editor content will not change.
+     */
+    paste: EventEmitter<EditorPasteEvent>;
     /**
      * Fires when the content area of the Editor is blurred ([see example]({% slug overview_editor %}#toc-events)).
      */
@@ -159,13 +157,16 @@ export declare class EditorComponent implements AfterViewInit, ControlValueAcces
     private subs;
     private _view;
     private _value;
-    private _previousValue;
     private _disabled;
     private _readonly;
     private _schema;
     private _plugins;
     private _placeholder;
     private _styleObserver;
+    private trOnChange;
+    private htmlOnChange;
+    private inForm;
+    private _pasteEvent;
     private afterViewInit;
     private contentAreaLoaded;
     constructor(dialogService: DialogService, localization: LocalizationService, cdr: ChangeDetectorRef, ngZone: NgZone, element: ElementRef, toolsService: EditorToolsService);
@@ -188,7 +189,7 @@ export declare class EditorComponent implements AfterViewInit, ControlValueAcces
      * @param {any} attr - Optional parameters for the command. Apart from the following list,
      * the parameters do not expect specific attributes when you call them:
      * - `format` - Accepts an object with the `tag` property.
-     * The supported tags are `p`, `blockquote`, and any of the `h1` to `h6` heading tags.
+     * The supported tags are `p` and any of the `h1` to `h6` heading tags.
      * - `createLink` - Accepts an object with the `href`, `title`, and `target` properties. The `href` property is mandatory.
      * - `setHTML` - Accepts a `string` parameter.
      * - `insertTable` - Accepts an object with the `rows` and `cols` properties. The number values are zero based.
@@ -279,8 +280,12 @@ export declare class EditorComponent implements AfterViewInit, ControlValueAcces
      */
     isEmpty(): boolean;
     private initialize;
+    private dispatchTransaction;
+    private transformPastedHTML;
+    private changeValue;
+    private onChangeCallback;
     private normalizeSize;
     private normalizeProperties;
-    private onChangeCallback;
     private onTouchedCallback;
+    private onPaste;
 }

package/dist/es2015/editor.component.js

@@ -6,12 +6,12 @@ import * as tslib_1 from "tslib";
 var EditorComponent_1;
 import { Component, HostBinding, ViewChild, ContentChild, ViewContainerRef, Output, ElementRef, EventEmitter, forwardRef, Input, ChangeDetectorRef, NgZone, isDevMode } from '@angular/core';
 import { NG_VALUE_ACCESSOR } from '@angular/forms';
-import { BehaviorSubject, fromEvent, merge, Subject, zip } from 'rxjs';
-import { map, filter, auditTime, take } from 'rxjs/operators';
+import { BehaviorSubject, fromEvent, Subject, zip } from 'rxjs';
+import { map, filter, take } from 'rxjs/operators';
 import { ToolBarComponent } from '@progress/kendo-angular-toolbar';
 import { DialogService } from '@progress/kendo-angular-dialog';
-import { isDocumentAvailable, KendoInput } from '@progress/kendo-angular-common';
-import { buildKeymap, buildListKeymap, hasSameMarkup, getHtml, pasteCleanup, sanitize, removeComments, sanitizeClassAttr, sanitizeStyleAttr, removeAttribute, placeholder, EditorView, EditorState, baseKeymap, keymap, history, parseContent, Plugin, PluginKey, TextSelection, Schema, gapCursor, getSelectionText, imageResizing } from '@progress/kendo-editor-common';
+import { hasObservers, isDocumentAvailable, KendoInput } from '@progress/kendo-angular-common';
+import { buildKeymap, buildListKeymap, getHtml, pasteCleanup, sanitize, removeComments, sanitizeClassAttr, sanitizeStyleAttr, removeAttribute, placeholder, EditorView, EditorState, baseKeymap, keymap, history, parseContent, Plugin, PluginKey, TextSelection, Schema, AllSelection, gapCursor, getSelectionText, imageResizing, tableEditing } from '@progress/kendo-editor-common';
 import { validatePackage } from '@progress/kendo-licensing';
 import { packageMetadata } from './package-metadata';
 import { schema } from './config/schema';
@@ -26,15 +26,16 @@ import { EditorLocalizationService } from './localization/editor-localization.se
 import { defaultStyle, tablesStyles, rtlStyles } from './common/styles';
 import { EditorErrorMessages } from './common/error-messages';
 import { EditorToolsService } from './tools/tools.service';
+import { EditorPasteEvent } from './preventable-events/paste-event';
 const EMPTY_PARAGRAPH = '<p></p>';
 const defaultPasteCleanupSettings = {
     convertMsLists: false,
     removeAttributes: [],
     removeHtmlComments: false,
-    removeInvalidHTML: false,
+    removeInvalidHTML: true,
     removeMsClasses: false,
     removeMsStyles: false,
-    stripTags: ['']
+    stripTags: []
 };
 const removeCommentsIf = conditionallyExecute(removeComments);
 const removeInvalidHTMLIf = conditionallyExecute(sanitize);
@@ -71,14 +72,6 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
          * @default false
          */
         this.applyToWord = false;
-        /**
-         * By design, the Editor emits `valueChange`, updates the model and the ToolBar state on each keystroke.
-         * When you are interested in ignoring the new values for a given amout of time and take only the most recent one, you can use the `updateInterval` property.
-         * A possible use case is to get the new values and to update the ToolBar state at a maximum rate per second in order to speed up your application.
-         * The specified interval (in milliseconds) should be a positive number.
-         * By default the `updateInterval` is set to 100 miliseconds. If set to zero the delay will be disabled entirely.
-         */
-        this.updateInterval = 100;
         /**
          * By default, whitespace is collapsed as per HTML's rules.
          * Set to `true` to preserve whitespace, but normalize newlines to spaces.
@@ -104,6 +97,11 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
          * Fires when the content area of the Editor is focused ([see example]({% slug overview_editor %}#toc-events)).
          */
         this.onFocus = new EventEmitter();
+        /**
+         * Fires when the user performs paste in the content area of the Editor ([see example]({% slug overview_editor %}#toc-events)).
+         * The event is preventable. If you cancel it, the Editor content will not change.
+         */
+        this.paste = new EventEmitter();
         /**
          * Fires when the content area of the Editor is blurred ([see example]({% slug overview_editor %}#toc-events)).
          */
@@ -119,10 +117,76 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
         this.valueModified = new Subject();
         this._readonly = false;
         this._placeholder = '';
+        this.inForm = false;
         this.afterViewInit = new Subject();
         this.contentAreaLoaded = new Subject();
-        this.onChangeCallback = (_) => { }; // tslint:disable-line:no-empty
+        this.dispatchTransaction = (tr) => {
+            const docChanged = tr.docChanged;
+            if (this.disabled || (this.readonly && docChanged)) {
+                return;
+            }
+            if (docChanged) {
+                const doc = tr.doc;
+                const html = getHtml({ doc });
+                this.trOnChange = tr;
+                this.htmlOnChange = html;
+                this.ngZone.run(() => {
+                    this.valueModified.next(html);
+                });
+            }
+            if (!docChanged || this.inForm) {
+                this.view.updateState(this.view.state.apply(tr));
+            }
+        };
+        this.transformPastedHTML = (dirtyHtml) => {
+            const pasteCleanupSettings = Object.assign({}, defaultPasteCleanupSettings, this.pasteCleanupSettings);
+            const html = pipe(removeInvalidHTMLIf(pasteCleanupSettings.removeInvalidHTML), removeCommentsIf(pasteCleanupSettings.removeHtmlComments))(dirtyHtml);
+            const clean = pasteCleanup(html, {
+                convertMsLists: pasteCleanupSettings.convertMsLists,
+                stripTags: pasteCleanupSettings.stripTags.join('|'),
+                attributes: getPasteCleanupAttributes(pasteCleanupSettings)
+            });
+            if (hasObservers(this.paste)) {
+                const event = new EditorPasteEvent(clean, dirtyHtml, this._pasteEvent);
+                this.ngZone.run(() => this.paste.emit(event));
+                return event.isDefaultPrevented() ? '' : event.cleanedHtml;
+            }
+            return clean;
+        };
+        this.changeValue = (value) => {
+            const prev = this._value;
+            this._value = value;
+            if (!this._view) {
+                return;
+            }
+            if (this.htmlOnChange === value && this.trOnChange) {
+                this.view.updateState(this.view.state.apply(this.trOnChange));
+            }
+            else {
+                if ((prev || '') !== (value || '')) {
+                    const iframeContentWindowNotPresent = this.iframe && !this.container.element.nativeElement.contentWindow;
+                    if (iframeContentWindowNotPresent) {
+                        return;
+                    }
+                    const state = this.view.state;
+                    const nextDoc = parseContent(value || '', state.schema, { preserveWhitespace: this.preserveWhitespace });
+                    const tr = state.tr
+                        .setSelection(new AllSelection(state.doc))
+                        .replaceSelectionWith(nextDoc);
+                    this.view.updateState(state.apply(tr));
+                }
+            }
+            this.trOnChange = null;
+            this.htmlOnChange = null;
+        };
+        this.onChangeCallback = (value) => {
+            this.changeValue(value);
+        };
         this.onTouchedCallback = (_) => { }; // tslint:disable-line:no-empty
+        this.onPaste = (_view, nativeEvent) => {
+            this._pasteEvent = nativeEvent;
+            return false;
+        };
         validatePackage(packageMetadata);
         this.direction = localization.rtl ? 'rtl' : 'ltr';
         // https://stackoverflow.com/questions/56572483/chrome-is-synchronously-handling-iframe-loading-whereas-firefox-handles-it-asyn
@@ -132,25 +196,12 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
      * Sets the value of the Editor ([see example]({% slug overview_editor %}#toc-basic-usage)).
      */
     set value(value) {
-        if (this._previousValue === value) {
-            return;
-        }
-        this._value = value;
-        this._previousValue = value;
-        if (this._view) {
-            const iframeContentWindowNotPresent = this.iframe && !this.container.element.nativeElement.contentWindow;
-            if (iframeContentWindowNotPresent) {
-                return;
-            }
-            this.exec('setHTML', {
-                content: this._value || '',
-                parseOptions: {
-                    preserveWhitespace: this.preserveWhitespace
-                }
-            });
-        }
+        this.changeValue(value);
     }
     get value() {
+        if (this.trOnChange) {
+            return this.htmlOnChange;
+        }
         let value = this._view ? this.getSource() : this._value;
         if (value === EMPTY_PARAGRAPH) {
             return this._value ? '' : this._value;
@@ -340,6 +391,9 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
         }
     }
     ngOnChanges(changes) {
+        if (changes.value && this.view) {
+            this.changeValue(changes.value.currentValue);
+        }
         if (changes.iframe && !changes.iframe.isFirstChange()) {
             this.ngZone.onStable.pipe(take(1)).subscribe(() => this.initialize());
         }
@@ -367,7 +421,7 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
      * @param {any} attr - Optional parameters for the command. Apart from the following list,
      * the parameters do not expect specific attributes when you call them:
      * - `format` - Accepts an object with the `tag` property.
-     * The supported tags are `p`, `blockquote`, and any of the `h1` to `h6` heading tags.
+     * The supported tags are `p` and any of the `h1` to `h6` heading tags.
      * - `createLink` - Accepts an object with the `href`, `title`, and `target` properties. The `href` property is mandatory.
      * - `setHTML` - Accepts a `string` parameter.
      * - `insertTable` - Accepts an object with the `rows` and `cols` properties. The number values are zero based.
@@ -425,8 +479,6 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
         const command = editorCommands[commandName](attr);
         // Executes a ProseMirror command.
         command(this._view.state, this._view.dispatch, this._view);
-        // See the `dispatchTransaction` comments.
-        // this.stateChange.emit(updateToolBar(this.view));
     }
     /**
      * Opens a dialog.
@@ -511,6 +563,7 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
      * @hidden
      */
     writeValue(value) {
+        this.inForm = true;
         // To avoid confusion, non-existent values are always undefined.
         this.value = value === null ? undefined : value;
     }
@@ -538,7 +591,6 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
             return;
         }
         const currentSchema = this.schema || schema;
-        const that = this;
         const containerNativeElement = this.container.element.nativeElement;
         const contentNode = parseContent((this.value || '').trim(), currentSchema, { preserveWhitespace: this.preserveWhitespace });
         if (this.iframe) {
@@ -580,16 +632,13 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
                     }
                 })
             }),
-            new Plugin({
-                key: new PluginKey('editor-filter-disabled-state'),
-                filterTransaction: () => !this.disabled
-            }),
             history(),
             keymap(buildListKeymap(currentSchema)),
             keymap(buildKeymap(currentSchema, { applyToWord: this.applyToWord })),
             keymap(baseKeymap),
             gapCursor(),
-            imageResizing()
+            imageResizing(),
+            tableEditing()
         ];
         if (this.placeholder) {
             defaultPlugins.push(placeholder(this.placeholder));
@@ -609,31 +658,10 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
             this._view = new EditorView({ mount: this.viewMountElement }, {
                 state,
                 editable: () => !this.readonly,
-                dispatchTransaction: function (tr) {
-                    // `this` is bound to the view instance.
-                    this.updateState(this.state.apply(tr));
-                    // that.cdr.detectChanges();
-                    // When the user utilizes keyboard shortcuts&mdash;for example, `Ctrl`+`b`&mdash;
-                    // `tr.docChanged` is `true` and the toolbar is not updated.
-                    // A possible future solution is to move the keymaps to the service.
-                    // if (!tr.docChanged) {
-                    //     that.stateChange.emit(updateToolBar(that.view));
-                    // }
-                    const value = that.value;
-                    if (!hasSameMarkup(value, that._previousValue, this.state.schema)) {
-                        that._previousValue = value;
-                        that.ngZone.run(() => that.valueModified.next(value));
-                    }
-                },
-                transformPastedHTML: (html) => {
-                    const pasteCleanupSettings = Object.assign({}, defaultPasteCleanupSettings, this.pasteCleanupSettings);
-                    const clean = pipe(removeCommentsIf(pasteCleanupSettings.removeHtmlComments), removeInvalidHTMLIf(pasteCleanupSettings.removeInvalidHTML))(html);
-                    const attributes = getPasteCleanupAttributes(pasteCleanupSettings);
-                    return pasteCleanup(clean, {
-                        convertMsLists: pasteCleanupSettings.convertMsLists,
-                        stripTags: pasteCleanupSettings.stripTags.join('|'),
-                        attributes
-                    });
+                dispatchTransaction: this.dispatchTransaction,
+                transformPastedHTML: this.transformPastedHTML,
+                handleDOMEvents: {
+                    paste: this.onPaste
                 }
             });
         });
@@ -674,7 +702,7 @@ let EditorComponent = EditorComponent_1 = class EditorComponent {
                 this.cdr.detectChanges();
             }
         }));
-        this.subs.add(merge(this.valueModified.pipe(filter(() => this.updateInterval > 0), auditTime(this.updateInterval)), this.valueModified.pipe(filter(() => this.updateInterval === 0))).subscribe((value) => {
+        this.subs.add(this.valueModified.subscribe((value) => {
             this.onChangeCallback(value);
             this.valueChange.emit(value);
             this.cdr.markForCheck();
@@ -767,10 +795,6 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:type", String),
     tslib_1.__metadata("design:paramtypes", [String])
 ], EditorComponent.prototype, "placeholder", null);
-tslib_1.__decorate([
-    Input(),
-    tslib_1.__metadata("design:type", Number)
-], EditorComponent.prototype, "updateInterval", void 0);
 tslib_1.__decorate([
     Input(),
     tslib_1.__metadata("design:type", Object)
@@ -791,6 +815,10 @@ tslib_1.__decorate([
     Output('focus'),
     tslib_1.__metadata("design:type", EventEmitter)
 ], EditorComponent.prototype, "onFocus", void 0);
+tslib_1.__decorate([
+    Output(),
+    tslib_1.__metadata("design:type", EventEmitter)
+], EditorComponent.prototype, "paste", void 0);
 tslib_1.__decorate([
     Output('blur'),
     tslib_1.__metadata("design:type", EventEmitter)
@@ -911,6 +939,8 @@ EditorComponent = EditorComponent_1 = tslib_1.__decorate([
             alignRight="Align text right"
             i18n-backColor="kendo.editor.backColor|The title of the tool that changes the text background color."
             backColor="Background color"
+            i18n-blockquote="kendo.editor.blockquote|The title of the tool that wraps an element in a blockquote"
+            blockquote="Quotation"
             i18n-bold="kendo.editor.bold|The title of the tool that makes text bold."
             bold="Bold"
             i18n-cleanFormatting="kendo.editor.cleanFormatting|The title of the Clean Formatting tool."
@@ -1038,7 +1068,7 @@ EditorComponent = EditorComponent_1 = tslib_1.__decorate([
         <div *ngIf="!iframe" #content [attr.dir]="direction" class="k-editor-content"></div>
 
         <div class="k-editor-content" *ngIf="iframe">
-            <iframe #content frameborder="0" class="k-iframe" (load)="iframeOnLoad()"></iframe>
+            <iframe #content srcdoc="<!DOCTYPE html>" frameborder="0" class="k-iframe" (load)="iframeOnLoad()"></iframe>
         </div>
 
         <ng-container #dialogsContainer></ng-container>

package/dist/es2015/editor.module.js

@@ -30,6 +30,7 @@ import { EditorAlignLeftButtonDirective } from './tools/alignment/editor-align-l
 import { EditorAlignCenterButtonDirective } from './tools/alignment/editor-align-center-button.directive';
 import { EditorAlignRightButtonDirective } from './tools/alignment/editor-align-right-button.directive';
 import { EditorAlignJustifyButtonDirective } from './tools/alignment/editor-align-justify-button.directive';
+import { EditorBlockquoteDirective } from './tools/blockquote/editor-blockquote-button.directive';
 import { EditorRedoButtonDirective } from './tools/history/editor-redo-button.directive';
 import { EditorUndoButtonDirective } from './tools/history/editor-undo-button.directive';
 import { EditorInsertImageButtonDirective } from './tools/image/editor-insert-image-button.directive';
@@ -123,7 +124,9 @@ const COMPONENT_DIRECTIVES = [
     // print
     EditorPrintDirective,
     // select all
-    EditorSelectAllButtonDirective
+    EditorSelectAllButtonDirective,
+    // blockquote
+    EditorBlockquoteDirective
 ];
 const TOOLBAR_TOOLS = [
     EditorFontSizeComponent,

package/dist/es2015/index.d.ts

@@ -7,6 +7,7 @@
  */
 export * from './main';
 export { DialogCommand, EditorCommand } from './common/commands';
+export { semanticNodes, semanticTagNames } from './config/semantic-nodes';
 export { ColorPickerDialogComponent } from './dialogs/colorpicker-dialog.component';
 export { FileLinkDialogComponent } from './dialogs/file-link-dialog.component';
 export { FontFamilyDialogComponent } from './dialogs/font-family-dialog.component';
@@ -23,6 +24,7 @@ export { EditorAlignCenterButtonDirective } from './tools/alignment/editor-align
 export { EditorAlignJustifyButtonDirective } from './tools/alignment/editor-align-justify-button.directive';
 export { EditorAlignLeftButtonDirective } from './tools/alignment/editor-align-left-button.directive';
 export { EditorAlignRightButtonDirective } from './tools/alignment/editor-align-right-button.directive';
+export { EditorBlockquoteDirective } from './tools/blockquote/editor-blockquote-button.directive';
 export { EditorBackColorDirective } from './tools/colorpicker/editor-back-color.directive';
 export { EditorColorPickerComponent } from './tools/colorpicker/editor-colorpicker.component';
 export { EditorForeColorDirective } from './tools/colorpicker/editor-fore-color.directive';

package/dist/es2015/index.js

@@ -6,6 +6,7 @@
  * Generated bundle index. Do not edit.
  */
 export * from './main';
+export { semanticNodes, semanticTagNames } from './config/semantic-nodes';
 export { ColorPickerDialogComponent } from './dialogs/colorpicker-dialog.component';
 export { FileLinkDialogComponent } from './dialogs/file-link-dialog.component';
 export { FontFamilyDialogComponent } from './dialogs/font-family-dialog.component';
@@ -22,6 +23,7 @@ export { EditorAlignCenterButtonDirective } from './tools/alignment/editor-align
 export { EditorAlignJustifyButtonDirective } from './tools/alignment/editor-align-justify-button.directive';
 export { EditorAlignLeftButtonDirective } from './tools/alignment/editor-align-left-button.directive';
 export { EditorAlignRightButtonDirective } from './tools/alignment/editor-align-right-button.directive';
+export { EditorBlockquoteDirective } from './tools/blockquote/editor-blockquote-button.directive';
 export { EditorBackColorDirective } from './tools/colorpicker/editor-back-color.directive';
 export { EditorColorPickerComponent } from './tools/colorpicker/editor-colorpicker.component';
 export { EditorForeColorDirective } from './tools/colorpicker/editor-fore-color.directive';