/
utils.js
119 lines (102 loc) · 3.98 KB
/
utils.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
/**
* @license Copyright (c) 2003-2020, CKSource - Frederico Knabben. All rights reserved.
* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
*/
/**
* @module media-embed/utils
*/
import { isWidget, toWidget } from '@ckeditor/ckeditor5-widget/src/utils';
/**
* Converts a given {@link module:engine/view/element~Element} to a media embed widget:
* * Adds a {@link module:engine/view/element~Element#_setCustomProperty custom property} allowing to recognize the media widget element.
* * Calls the {@link module:widget/utils~toWidget} function with the proper element's label creator.
*
* @param {module:engine/view/element~Element} viewElement
* @param {module:engine/view/downcastwriter~DowncastWriter} writer An instance of the view writer.
* @param {String} label The element's label.
* @returns {module:engine/view/element~Element}
*/
export function toMediaWidget( viewElement, writer, label ) {
writer.setCustomProperty( 'media', true, viewElement );
return toWidget( viewElement, writer, { label } );
}
/**
* Returns a media widget editing view element if one is selected.
*
* @param {module:engine/view/selection~Selection|module:engine/view/documentselection~DocumentSelection} selection
* @returns {module:engine/view/element~Element|null}
*/
export function getSelectedMediaViewWidget( selection ) {
const viewElement = selection.getSelectedElement();
if ( viewElement && isMediaWidget( viewElement ) ) {
return viewElement;
}
return null;
}
/**
* Checks if a given view element is a media widget.
*
* @param {module:engine/view/element~Element} viewElement
* @returns {Boolean}
*/
export function isMediaWidget( viewElement ) {
return !!viewElement.getCustomProperty( 'media' ) && isWidget( viewElement );
}
/**
* Creates a view element representing the media. Either a "semantic" one for the data pipeline:
*
* <figure class="media">
* <oembed url="foo"></oembed>
* </figure>
*
* or a "non-semantic" (for the editing view pipeline):
*
* <figure class="media">
* <div data-oembed-url="foo">[ non-semantic media preview for "foo" ]</div>
* </figure>
*
* @param {module:engine/view/downcastwriter~DowncastWriter} writer
* @param {module:media-embed/mediaregistry~MediaRegistry} registry
* @param {String} url
* @param {Object} options
* @param {String} [options.useSemanticWrapper]
* @param {String} [options.renderForEditingView]
* @returns {module:engine/view/containerelement~ContainerElement}
*/
export function createMediaFigureElement( writer, registry, url, options ) {
const figure = writer.createContainerElement( 'figure', { class: 'media' } );
writer.insert( writer.createPositionAt( figure, 0 ), registry.getMediaViewElement( writer, url, options ) );
return figure;
}
/**
* Returns a selected media element in the model, if any.
*
* @param {module:engine/model/selection~Selection} selection
* @returns {module:engine/model/element~Element|null}
*/
export function getSelectedMediaModelWidget( selection ) {
const selectedElement = selection.getSelectedElement();
if ( selectedElement && selectedElement.is( 'element', 'media' ) ) {
return selectedElement;
}
return null;
}
/**
* Creates a media element and inserts it into the model.
*
* **Note**: This method will use {@link module:engine/model/model~Model#insertContent `model.insertContent()`} logic of inserting content
* if no `insertPosition` is passed.
*
* @param {module:engine/model/model~Model} model
* @param {String} url An URL of an embeddable media.
* @param {module:engine/model/position~Position} [insertPosition] Position to insert the media. If not specified,
* the default behavior of {@link module:engine/model/model~Model#insertContent `model.insertContent()`} will
* be applied.
*/
export function insertMedia( model, url, insertPosition ) {
model.change( writer => {
const mediaElement = writer.createElement( 'media', { url } );
model.insertContent( mediaElement, insertPosition );
writer.setSelection( mediaElement, 'on' );
} );
}