Text Molecule

Add an HTML editor and renderer.

Summary

Text Molecule
Preference Dialog
Properties
type	string, ( r )
pref.name	string, ( r )
pref.enableWhen	string, ( r, w )
pref.disableWhen	string, ( r, w )
pref.fontFamily	string, ( r, w )
pref.fontSize	string, ( r, w )
pref.fontStyle	string, ( r, w )
pref.fontWeight	string, ( r, w )
pref.textDecoration	string, ( r, w )
pref.textAlign	string, ( r, w )
pref.textShadow	string, ( r, w )
pref.flow	string, ( r, w )
pref.lineHeight	string, ( r, w )
pref.r	int [0, 255], ( r, w )
pref.g	int [0, 255], ( r, w )
pref.b	int [0, 255], ( r, w )
selectable	bool, ( r, w )
innerHTML	string, ( r, w )
innerText	string, ( r, w )
editMode	bool, ( r, w )
editText	string, ( r, w )
editWrap	string, ( r, w )
spellcheck	bool, ( r, w )
Functions
attach
detach
delete
rename
show
hide
refresh
clone
serialize

Preference Dialog

Properties

type

string, ( r )

Type of this molecule, text.

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.fontFamily

string, ( r, w )

Specifies font names of this molecule. This can be a comma-separated list, of which the molecule will use the first font it recognizes.

pref.fontSize

string, ( r, w )

Specifies font size of this molecule. Default to medium.

xx-small	9px (7pt).
x-small	10px (7.5pt).
small	13px (10pt).
medium	16px (12pt).
large	18px (13.5pt).
x-large	24px (18pt).
xx-large	32px (24pt).
smaller	Sets the font-size to a smaller size than the parent element.
larger	Sets the font-size to a larger size than the parent element.
length	Sets the font-size to a fixed size.
%	Sets the font-size to % of the parent element.

pref.fontStyle

string, ( r, w )

Specifies the font style.

normal	Default. The molecule displays a normal font.
italic	The molecule displays an italic font.
oblique	The molecule displays an oblique font.

pref.fontWeight

string, ( r, w )

Specifies font weight.

normal	Default. Defines normal characters.
bold	Defines thick characters.
bolder	Defines thicker characters.
lighter	Defines lighter characters.
100	Defines from thin to thick characters. 400 is the same as normal, and 700 is the same as bold.
200	Defines from thin to thick characters.
300	Defines from thin to thick characters.
400	Defines from thin to thick characters.
500	Defines from thin to thick characters.
600	Defines from thin to thick characters.
700	Defines from thin to thick characters.
800	Defines from thin to thick characters.
900	Defines from thin to thick characters.

pref.textDecoration

string, ( r, w )

Specifies the style of text decoration.

none	Default. Defines a normal text.
underline	Defines a line under the text.
overline	Defines a line over the text.
line-through	Defines a line through the text.
blink	Defines a blinking text.

pref.textAlign

string, ( r, w )

Specifies text alignment in the droplet.

left	Default. Aligns text to the left.
right	Aligns text to the right.
center	Centers the text.
justify	Justifies text to both edges.

pref.textShadow

string, ( r, w )

Accepts a comma-separated list of shadow effects to be applied to the text and text-decorations of the element. Each shadow effect is specified as <color> <offset-x> <offset-y> <blur-radius>. Multiple shadow effects are applied front-to-back: the first shadow is on top.

color	The color of the text-shadow (#6374AB).
offset-x	The x-coordinate of the text-shadow (20px), relative to the text.
offset-y	The y-coordinate of the text-shadow (-12px), relative to the text.
blur-radius	The blur radius of the text-shadow (2px).

pref.flow

string, ( r, w )

Specifies the style of the text flow within the droplet.

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

pref.lineHeight

string, ( r, w )

Specifies the distance between lines.

normal	Default. Sets a reasonable distance between lines.
number	Sets a number that will be multiplied with the current font-size to set the distance between the lines.
length	Sets a fixed distance between the lines.
%	Sets a distance between the lines in % of the current font size.

pref.r

int [0, 255], ( r, w )

Specifies the RED component of the text color.

pref.g

int [0, 255], ( r, w )

Specifies the GREEN component of the text color.

pref.b

int [0, 255], ( r, w )

Specifies the BLUE component of the text color.

selectable

bool, ( r, w )

Specifies whether the text is selectable.

innerHTML

string, ( r, w )

Reads or Writes the HTML text.

innerText

string, ( r, w )

Reads or Writes the raw text. Text is displayed as is, without HTML interpretation.

editMode

bool, ( r, w )

Specifies whether the edit mode is enabled. if enabled, this molecule displays an <input> textbox allowing users to enter text. Similar to contentEditable attribute.

editText

string, ( r, w )

Specifies the text in the <input> textbox.

editWrap

string, ( r, w )

Specifies whether the text should be wrapped when it reaches the right side of the textbox.

off	Default. No wrap.
soft	The browser inserts line breaks while displaying the text, but no actual line breaks in the text value.
hard	The browser inserts real line breaks in the text value.

spellcheck

bool, ( r, w )

Enable or disable spell checking in the <input> textbox.

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.