aceUIImageEditor

Enables the ability to create, edit and view images through the ACE Image Service.

Minion

Features

  • Vertical/horizontal flip Flips the image around the vertical or horizontal axis.
  • 90°/180°/270° rotation Rotates the image clockwise or anti-clockwise in 90° steps.
  • Pixelation Allows for pixelation of an area within the image, each pixelation can be undone unrelated to each other.
  • Cropping This operation allows for a crop rectangle per image format.
  • Paste from clipboard Allows for pasting of an image file from a content referenced in a server side clipboard.

Pasting an image into the image editor from the clipboard will result in the image file from the referenced content being copied into the current content. Only the image file itself is copied; no metadata or other kinds of data will be copied.

Configuration

Attribute Description Default
"maximumImageSize" number

The maximum file size of images to upload, in kilobytes.		 10240
"allowedMimeTypes" Array

A list of allowed mime types for image files to use. Applies to both images uploaded and pasted from the clipboard.		 ["image/png", "image/jpeg"]
"displayFormatNames" boolean

Enables the presentation of format names in preview mode.		 true
"allowedTypes" Array

A list of content types allowed to be pasted into the image editor.
"pasteEnabled" boolean

Whether it should be allowed to paste into the image editor.		 true

Based on the pasteEnabled and allowedTypes configuration, the paste operation will be available unless:

  • pasteEnabled is explicitly set to false
  • allowedTypes is explicitly set to the empty list ([])

Localization

This widget has localization support.

Expected domain objects

This widget expects multiple domain objects:

Name Description
"files" The aceFiles aspect.
"editInfo" The aceImageEdits aspect.
"image" The aceImage aspect.

ACE Images

Example template json

{
  "label": "Image",
  "widget": "aceUIImageEditor",
  "config": {
    "maximumImageSize": 10240,
    "allowedMimeTypes": ["image/png", "image/jpeg"],
    "allowedTypes": ["imageContent"],
    "displayFormatNames": true,
    "pasteEnabled": true
  },

  "domainObjects": {
    "files": "aceFiles",
    "editInfo": "aceImageEdits",
    "image": "aceImage"
  }
}