CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Module

media-embed/converters

@ckeditor/ckeditor5-media-embed/src/converters

module

Filtering

Functions

  • modelToViewUrlAttributeConverter( registry, options ) → ( DowncastDispatcher ) => void

    See source

    Returns a function that converts the model "url" attribute to the view representation.

    Depending on the configuration, the view representation can be "semantic" (for the data pipeline):

    <figure class="media">
	<oembed url="foo"></oembed>
</figure>

    or "non-semantic" (for the editing view pipeline):

    <figure class="media">
	<div data-oembed-url="foo">[ non-semantic media preview for "foo" ]</div>
</figure>

    Note: Changing the model "url" attribute replaces the entire content of the <figure> in the view.

    Parameters

    registry : MediaRegistry

    The registry providing the media and their content.

    options : MediaOptions

    options object with following properties:

    • elementName When set, overrides the default element name for semantic media embeds.
    • renderMediaPreview When true, the converter will create the view in the non-semantic form.
    • renderForEditingView When true, the converter will create a view specific for the editing pipeline (e.g. including CSS classes, content placeholders).

    Returns

    ( DowncastDispatcher ) => void