@ckeditor/ckeditor5-engine 34.2.0 → 35.1.0
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.
- package/CHANGELOG.md +823 -0
- package/LICENSE.md +4 -0
- package/package.json +32 -25
- package/src/controller/datacontroller.js +467 -561
- package/src/controller/editingcontroller.js +168 -204
- package/src/conversion/conversion.js +541 -565
- package/src/conversion/conversionhelpers.js +24 -28
- package/src/conversion/downcastdispatcher.js +457 -686
- package/src/conversion/downcasthelpers.js +1583 -1965
- package/src/conversion/mapper.js +518 -707
- package/src/conversion/modelconsumable.js +240 -283
- package/src/conversion/upcastdispatcher.js +372 -718
- package/src/conversion/upcasthelpers.js +707 -818
- package/src/conversion/viewconsumable.js +524 -581
- package/src/dataprocessor/basichtmlwriter.js +12 -16
- package/src/dataprocessor/dataprocessor.js +5 -0
- package/src/dataprocessor/htmldataprocessor.js +101 -117
- package/src/dataprocessor/htmlwriter.js +1 -18
- package/src/dataprocessor/xmldataprocessor.js +117 -138
- package/src/dev-utils/model.js +260 -352
- package/src/dev-utils/operationreplayer.js +106 -126
- package/src/dev-utils/utils.js +34 -51
- package/src/dev-utils/view.js +632 -753
- package/src/index.js +0 -11
- package/src/model/batch.js +111 -127
- package/src/model/differ.js +988 -1233
- package/src/model/document.js +340 -449
- package/src/model/documentfragment.js +327 -364
- package/src/model/documentselection.js +996 -1189
- package/src/model/element.js +306 -410
- package/src/model/history.js +224 -262
- package/src/model/item.js +5 -0
- package/src/model/liveposition.js +84 -145
- package/src/model/liverange.js +108 -185
- package/src/model/markercollection.js +379 -480
- package/src/model/model.js +883 -1034
- package/src/model/node.js +419 -463
- package/src/model/nodelist.js +175 -201
- package/src/model/operation/attributeoperation.js +153 -182
- package/src/model/operation/detachoperation.js +64 -83
- package/src/model/operation/insertoperation.js +135 -166
- package/src/model/operation/markeroperation.js +114 -140
- package/src/model/operation/mergeoperation.js +163 -191
- package/src/model/operation/moveoperation.js +157 -187
- package/src/model/operation/nooperation.js +28 -38
- package/src/model/operation/operation.js +106 -125
- package/src/model/operation/operationfactory.js +30 -34
- package/src/model/operation/renameoperation.js +109 -135
- package/src/model/operation/rootattributeoperation.js +155 -188
- package/src/model/operation/splitoperation.js +196 -232
- package/src/model/operation/transform.js +1833 -2204
- package/src/model/operation/utils.js +140 -204
- package/src/model/position.js +899 -1053
- package/src/model/range.js +910 -1028
- package/src/model/rootelement.js +77 -97
- package/src/model/schema.js +1189 -1835
- package/src/model/selection.js +745 -862
- package/src/model/text.js +90 -114
- package/src/model/textproxy.js +204 -240
- package/src/model/treewalker.js +316 -397
- package/src/model/typecheckable.js +16 -0
- package/src/model/utils/autoparagraphing.js +32 -44
- package/src/model/utils/deletecontent.js +334 -418
- package/src/model/utils/findoptimalinsertionrange.js +25 -36
- package/src/model/utils/getselectedcontent.js +96 -118
- package/src/model/utils/insertcontent.js +654 -773
- package/src/model/utils/insertobject.js +96 -119
- package/src/model/utils/modifyselection.js +120 -158
- package/src/model/utils/selection-post-fixer.js +153 -201
- package/src/model/writer.js +1305 -1474
- package/src/view/attributeelement.js +189 -225
- package/src/view/containerelement.js +75 -85
- package/src/view/document.js +172 -215
- package/src/view/documentfragment.js +200 -249
- package/src/view/documentselection.js +338 -367
- package/src/view/domconverter.js +1371 -1613
- package/src/view/downcastwriter.js +1747 -2076
- package/src/view/editableelement.js +81 -97
- package/src/view/element.js +739 -890
- package/src/view/elementdefinition.js +5 -0
- package/src/view/emptyelement.js +82 -92
- package/src/view/filler.js +35 -50
- package/src/view/item.js +5 -0
- package/src/view/matcher.js +260 -559
- package/src/view/node.js +274 -360
- package/src/view/observer/arrowkeysobserver.js +19 -28
- package/src/view/observer/bubblingemittermixin.js +120 -263
- package/src/view/observer/bubblingeventinfo.js +47 -55
- package/src/view/observer/clickobserver.js +7 -13
- package/src/view/observer/compositionobserver.js +14 -24
- package/src/view/observer/domeventdata.js +57 -67
- package/src/view/observer/domeventobserver.js +40 -64
- package/src/view/observer/fakeselectionobserver.js +81 -96
- package/src/view/observer/focusobserver.js +45 -61
- package/src/view/observer/inputobserver.js +7 -13
- package/src/view/observer/keyobserver.js +17 -27
- package/src/view/observer/mouseobserver.js +7 -14
- package/src/view/observer/mutationobserver.js +220 -315
- package/src/view/observer/observer.js +81 -102
- package/src/view/observer/selectionobserver.js +191 -246
- package/src/view/observer/tabobserver.js +23 -36
- package/src/view/placeholder.js +128 -173
- package/src/view/position.js +350 -401
- package/src/view/range.js +453 -513
- package/src/view/rawelement.js +85 -112
- package/src/view/renderer.js +874 -1014
- package/src/view/rooteditableelement.js +80 -90
- package/src/view/selection.js +608 -689
- package/src/view/styles/background.js +43 -44
- package/src/view/styles/border.js +220 -276
- package/src/view/styles/margin.js +8 -17
- package/src/view/styles/padding.js +8 -16
- package/src/view/styles/utils.js +127 -160
- package/src/view/stylesmap.js +728 -905
- package/src/view/text.js +102 -126
- package/src/view/textproxy.js +144 -170
- package/src/view/treewalker.js +383 -479
- package/src/view/typecheckable.js +19 -0
- package/src/view/uielement.js +166 -187
- package/src/view/upcastwriter.js +395 -449
- package/src/view/view.js +569 -664
- package/src/dataprocessor/dataprocessor.jsdoc +0 -64
- package/src/model/item.jsdoc +0 -14
- package/src/view/elementdefinition.jsdoc +0 -59
- package/src/view/item.jsdoc +0 -14
package/src/model/rootelement.js
CHANGED
|
@@ -2,110 +2,90 @@
|
|
|
2
2
|
* @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
|
|
3
3
|
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
|
|
4
4
|
*/
|
|
5
|
-
|
|
6
5
|
/**
|
|
7
6
|
* @module engine/model/rootelement
|
|
8
7
|
*/
|
|
9
|
-
|
|
10
8
|
import Element from './element';
|
|
11
|
-
|
|
12
9
|
/**
|
|
13
10
|
* Type of {@link module:engine/model/element~Element} that is a root of a model tree.
|
|
14
11
|
* @extends module:engine/model/element~Element
|
|
15
12
|
*/
|
|
16
13
|
export default class RootElement extends Element {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
* rootElement.is( 'element' ); // -> true
|
|
60
|
-
* rootElement.is( 'node' ); // -> true
|
|
61
|
-
* rootElement.is( 'model:rootElement' ); // -> true
|
|
62
|
-
* rootElement.is( 'model:element' ); // -> true
|
|
63
|
-
* rootElement.is( 'model:node' ); // -> true
|
|
64
|
-
*
|
|
65
|
-
* rootElement.is( 'view:element' ); // -> false
|
|
66
|
-
* rootElement.is( 'documentFragment' ); // -> false
|
|
67
|
-
*
|
|
68
|
-
* Assuming that the object being checked is an element, you can also check its
|
|
69
|
-
* {@link module:engine/model/element~Element#name name}:
|
|
70
|
-
*
|
|
71
|
-
* rootElement.is( 'rootElement', '$root' ); // -> same as above
|
|
72
|
-
*
|
|
73
|
-
* {@link module:engine/model/node~Node#is Check the entire list of model objects} which implement the `is()` method.
|
|
74
|
-
*
|
|
75
|
-
* @param {String} type Type to check.
|
|
76
|
-
* @param {String} [name] Element name.
|
|
77
|
-
* @returns {Boolean}
|
|
78
|
-
*/
|
|
79
|
-
is( type, name ) {
|
|
80
|
-
if ( !name ) {
|
|
81
|
-
return type === 'rootElement' || type === 'model:rootElement' ||
|
|
82
|
-
// From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
|
|
83
|
-
type === 'element' || type === 'model:element' ||
|
|
84
|
-
type === 'node' || type === 'model:node';
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
return name === this.name && (
|
|
88
|
-
type === 'rootElement' || type === 'model:rootElement' ||
|
|
89
|
-
// From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
|
|
90
|
-
type === 'element' || type === 'model:element'
|
|
91
|
-
);
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* Converts `RootElement` instance to `String` containing it's name.
|
|
96
|
-
*
|
|
97
|
-
* @returns {String} `RootElement` instance converted to `String`.
|
|
98
|
-
*/
|
|
99
|
-
toJSON() {
|
|
100
|
-
return this.rootName;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
// @if CK_DEBUG_ENGINE // toString() {
|
|
104
|
-
// @if CK_DEBUG_ENGINE // return this.rootName;
|
|
105
|
-
// @if CK_DEBUG_ENGINE // }
|
|
106
|
-
|
|
107
|
-
// @if CK_DEBUG_ENGINE // log() {
|
|
108
|
-
// @if CK_DEBUG_ENGINE // console.log( 'ModelRootElement: ' + this );
|
|
109
|
-
// @if CK_DEBUG_ENGINE // }
|
|
14
|
+
/**
|
|
15
|
+
* Creates root element.
|
|
16
|
+
*
|
|
17
|
+
* @param {module:engine/model/document~Document} document Document that is an owner of this root.
|
|
18
|
+
* @param {String} name Node name.
|
|
19
|
+
* @param {String} [rootName='main'] Unique root name used to identify this root
|
|
20
|
+
* element by {@link module:engine/model/document~Document}.
|
|
21
|
+
*/
|
|
22
|
+
constructor(document, name, rootName = 'main') {
|
|
23
|
+
super(name);
|
|
24
|
+
/**
|
|
25
|
+
* Document that is an owner of this root.
|
|
26
|
+
*
|
|
27
|
+
* @private
|
|
28
|
+
* @member {module:engine/model/document~Document}
|
|
29
|
+
*/
|
|
30
|
+
this._document = document;
|
|
31
|
+
/**
|
|
32
|
+
* Unique root name used to identify this root element by {@link module:engine/model/document~Document}.
|
|
33
|
+
*
|
|
34
|
+
* @readonly
|
|
35
|
+
* @member {String}
|
|
36
|
+
*/
|
|
37
|
+
this.rootName = rootName;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* {@link module:engine/model/document~Document Document} that owns this root element.
|
|
41
|
+
*
|
|
42
|
+
* @readonly
|
|
43
|
+
* @type {module:engine/model/document~Document|null}
|
|
44
|
+
*/
|
|
45
|
+
get document() {
|
|
46
|
+
return this._document;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Converts `RootElement` instance to `String` containing it's name.
|
|
50
|
+
*
|
|
51
|
+
* @returns {String} `RootElement` instance converted to `String`.
|
|
52
|
+
*/
|
|
53
|
+
toJSON() {
|
|
54
|
+
return this.rootName;
|
|
55
|
+
}
|
|
110
56
|
}
|
|
111
|
-
|
|
57
|
+
/**
|
|
58
|
+
* Checks whether this object is of the given.
|
|
59
|
+
*
|
|
60
|
+
* rootElement.is( 'rootElement' ); // -> true
|
|
61
|
+
* rootElement.is( 'element' ); // -> true
|
|
62
|
+
* rootElement.is( 'node' ); // -> true
|
|
63
|
+
* rootElement.is( 'model:rootElement' ); // -> true
|
|
64
|
+
* rootElement.is( 'model:element' ); // -> true
|
|
65
|
+
* rootElement.is( 'model:node' ); // -> true
|
|
66
|
+
*
|
|
67
|
+
* rootElement.is( 'view:element' ); // -> false
|
|
68
|
+
* rootElement.is( 'documentFragment' ); // -> false
|
|
69
|
+
*
|
|
70
|
+
* Assuming that the object being checked is an element, you can also check its
|
|
71
|
+
* {@link module:engine/model/element~Element#name name}:
|
|
72
|
+
*
|
|
73
|
+
* rootElement.is( 'rootElement', '$root' ); // -> same as above
|
|
74
|
+
*
|
|
75
|
+
* {@link module:engine/model/node~Node#is Check the entire list of model objects} which implement the `is()` method.
|
|
76
|
+
*
|
|
77
|
+
* @param {String} type Type to check.
|
|
78
|
+
* @param {String} [name] Element name.
|
|
79
|
+
* @returns {Boolean}
|
|
80
|
+
*/
|
|
81
|
+
RootElement.prototype.is = function (type, name) {
|
|
82
|
+
if (!name) {
|
|
83
|
+
return type === 'rootElement' || type === 'model:rootElement' ||
|
|
84
|
+
// From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
|
|
85
|
+
type === 'element' || type === 'model:element' ||
|
|
86
|
+
type === 'node' || type === 'model:node';
|
|
87
|
+
}
|
|
88
|
+
return name === this.name && (type === 'rootElement' || type === 'model:rootElement' ||
|
|
89
|
+
// From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
|
|
90
|
+
type === 'element' || type === 'model:element');
|
|
91
|
+
};
|