Image Molecule

Add an image.

Summary

Image Molecule
Preference Dialog
Properties
type	string, ( r )
pref.name	string, ( r )
pref.enableWhen	string, ( r, w )
pref.disableWhen	string, ( r, w )
pref.url	string, ( r, w )
pref.imgWidth	string, ( r, w )
pref.imgHeight	string, ( r, w )
pref.border	string, ( r, w )
pref.margin	string, ( r, w )
pref.padding	string, ( r, w )
pref.float	string, ( r, w )
pref.clear	string, ( r, w )
pref.flow	string, ( r, w )
Functions
attach
detach
delete
rename
show
hide
refresh
clone
serialize

Preference Dialog

Properties

type

string, ( r )

Type of this molecule, image.

pref.name

string, ( r )

The scriptable name for this molecule. This name can be set using rename function dynamically.

pref.enableWhen

string, ( r, w )

Specifies the event that activates this molecule. Default is load.

pref.disableWhen

string, ( r, w )

Specifies the event that deactivates this molecule. Default is none.

pref.url

string, ( r, w )

Specifies the URL of this image. This can be a valid http URL or a private vault URL that begins with //.

pref.imgWidth

string, ( r, w )

Specifies the image width.

auto	Default. The molecule calculates the actual width.
%	Defines the width in % of the droplet’s width.
length	Defines the width in px, cm, etc.

pref.imgHeight

string, ( r, w )

Specifies the image height.

auto	Default. The molecule calculates the actual height.
%	Defines the height in % of the droplet’s height.
length	Defines the height in px, cm, etc.

pref.border

string, ( r, w )

Specifies the image border style.

Possible formats,

none
<border-width> <border-style> <border-color>
<top-border-width> <right-border-width> <bottom-border-width> <left-border-width>
<top-bottom-border-width> <left-right-border-width>
<border-width>

border-width	thin, medium, thick, ~length~ (in pixel value).
border-color	rgb(255, 0, 0) or #ff0000.
border-style	none, hidden, dotted, dashed, solid, double, groove, ridge, inset, outset.

pref.margin

string, ( r, w )

Specifies the image margin.

Possible formats,

none
<margin-top> <margin-right> <margin-bottom> <margin-left>
<margins>

pref.padding

string, ( r, w )

Specifies the image padding.

Possible formats,

none
<padding-top> <padding-right> <padding-bottom> <padding-left>
<paddings>

pref.float

string, ( r, w )

Specifies how the image appears in the droplet.

left	The image floats to the left of the droplet.
right	The image floats to the right of the droplet.
none	Default. The image is displayed just where it occurs in the text.

pref.clear

string, ( r, w )

Specifies the sides of the image where other floating elements are not allowed.

left	No floating elements allowed on the left side.
right	No floating elements allowed on the right side.
both	No floating elements allowed on either the left or the right side.
none	Default. Allows floating elements on both sides.

pref.flow

string, ( r, w )

Specifies the style of the image flow within the droplet.

inline	Takes up only as much width as the image needs, and does not force new lines.
block	Takes up the full width available, with a new line before and after.

Functions

attach

attach(droplet);

Attach this molecule to the given droplet.

Parameters

droplet

(object) a droplet.

Returns

N/A

detach

detach();

Remove this molecule from its droplet.

Parameters

N/A

Returns

N/A

delete

delete();

Delete this molecule.

Parameters

N/A

Returns

N/A

rename

rename(name);

Rename this molecule.

Parameters

name	(string) a new name.

Returns

N/A

show

show();

Shows the effects of this molecule.

Parameters

N/A

Returns

N/A

hide

hide();

Hides the effects of this molecule.

Parameters

N/A

Returns

N/A

refresh

refresh();

Forces molecule to redraw with the current set of preferences.

Parameters

N/A

Returns

N/A

clone

clone();

Create a clone of this molecule.

Parameters

N/A

Returns

(object) a molecule.

serialize

serialize();

Serialize this molecule into its JSON representation.

Parameters

N/A

Returns

(string) JSON representation of a molecule.