Stacks API

Image — image

Overview

• Type:image
• Output Value:string: an img tag

An image well for the user to drag-and-drop an image to.

The image control gives stack developers a way to maintain complete control over an image. The user cannot scale/rotate the images in an image control like they can with images dropped into edit mode.

Image controls are designed to be used in conjunction with Image Transforms. Image transforms allow the developer to scale, rotate, and add styles to an image -- all of the same adjustments the user can perform from inside the Stack image editing mode.

Available: Stacks API v3

ID

• Key:id
• Type:string
• Required

The ID for this control. This ID must be unique within this stack. The ID is used to refer to control's property. IDs should be alpha-numeric (dashes and underscores are allowed), but should not contain special characters.

Title

• Key:title
• Type:string
• Default Value:"Untitled"
• Required

The title displayed next to the control. Long titles will be trancated, so keep it short.

Enable

• Key:enable
• Type:dictionary
• Default Value:enabled

Hide or show the control based on the value of another property.

Enables allow a stack to show only the controls needed by the user to achieve a specific task.

The enable dictionary defines the ID of another control and the value that other control must equal. When the other control's value is not equal to the provided value, this control is hidden.

Enable Dictionary

• id (string) — the ID of another control on which this control (Popup Menu) should depend.
• value (any type) — when the value of the other control is equal to this value, this control is displayed, otherwise it is hidden.

Warning: creating infinite loops in enable dependencies has undefined behavior but will likely result in a crash.

Tool Tip

• Key:toolTip
• Type:string
• Default Value:No tooltip is displayed.

The tooltip value is used to display hints for the user on the use of each control. If the function of the control is obvious, then a tooltip should be avoided. Simply re-displaying redundant information like the title has no value to the user.