ImageInsertConfig

Api-interface icon interface

The configuration of the image insert dropdown panel view. Used by the image insert feature in the @ckeditor/ckeditor5-image package.

ClassicEditor
	.create( editorElement, {
			image: {
				insert: {
				... // settings for "insertImage" view goes here
				}
			}
	} )
	.then( ... )
	.catch( ... );
Copy code

See all editor options.

Properties

  • Chevron-right icon

    integrations : Array<string> | undefined

    The image insert panel view configuration contains a list of ImageInsert integrations.

    The option accepts string tokens.

    • for predefined integrations, we have 3 special strings: upload, url, and assetManager.
    • for custom integrations, each string should be a name of the integration registered by the ImageInsertUI#registerIntegration().
    // Add `upload`, `assetManager` and `url` integrations.
    const imageInsertConfig = {
    	insert: {
    		integrations: [
    			'upload',
    			'assetManager',
    			'url'
    		]
    	}
    };
    
    Copy code

    Defaults to [ 'upload', 'assetManager', 'url' ]

  • Chevron-right icon

    type : 'auto' | 'block' | 'inline' | undefined

    This option allows to override the image type used by the InsertImageCommand when the user inserts new images into the editor content. By default, all images inserted into the editor will be block if ImageBlock is loaded. To let the editor decide the image type, choose 'auto'.

    Available options are:

    • 'block' – all images inserted into the editor will be block (requires the ImageBlock plugin),
    • 'inline' – all images inserted into the editor will be inline (requires the ImageInline plugin),
    • 'auto' – the editor will choose the optimal image type based on the context of the insertion and availability of plugins.

    Defaults to 'block'