Images in Blazor DocumentEditor Component

17 Oct 20251 minute to read

The Blazor Word Processor (Document Editor) component provides robust support for working with images in documents. It supports common raster image formats like PNG, BMP, and JPEG, as well as GIF and SVG images. You can insert an image file or online image in the document using the InsertImageAsync method.

await container.DocumentEditor.Editor.InsertImageAsync("<<base64String>>");

Image files will be internally converted to base64 string. Whereas, online images are preserved as URL.

Image resizing

Document editor provides built-in image resizer that can be injected into your application based on the requirements. This allows the image to be resized by dragging the resizing points using mouse or touch interactions. This resizer appears as follows.

Changing size

Document editor expose API to get or resize the selected image. Refer to the following sample code.

int height = await container.DocumentEditor.Selection.ImageFormat.GetHeightAsync();
int width = await container.DocumentEditor.Selection.ImageFormat.GetWidthAsync();
await container.DocumentEditor.Selection.ImageFormat.ResizeAsync(width + 10, height + 10);

Text wrapping style

Text wrapping refers to how images fit with surrounding text in a document. Refer to this page for more information about text wrapping styles available in Word documents.

Positioning the image

DocumentEditor preserves the position properties of the image and displays the image based on position properties. It does not support modifying the position properties. Whereas the image will be automatically moved along with text edited if it is positioned relative to the line or paragraph.

You can also explore our Blazor Word Processor example to know how to render and configure the document editor.