mxText

Extends mxShape to implement a text shape. To change vertical text from bottom to top to top to bottom, the following code can be used:

mxText.prototype.verticalTextRotation = 90;

Summary

mxText	Extends mxShape to implement a text shape.
Functions
mxText	Constructs a new text shape.
Variables
baseSpacingTop	Specifies the spacing to be added to the top spacing.
baseSpacingBottom	Specifies the spacing to be added to the bottom spacing.
baseSpacingLeft	Specifies the spacing to be added to the left spacing.
baseSpacingRight	Specifies the spacing to be added to the right spacing.
replaceLinefeeds	Specifies if linefeeds in HTML labels should be replaced with BR tags.
verticalTextRotation	Rotation for vertical text.
ignoreClippedStringSize	Specifies if the actual string size should be measured if a label is clipped.
ignoreStringSize	Specifies if the actual string size should be measured.
Functions
isParseVml	Text shapes do not contain VML markup and do not need to be parsed.
isHtmlAllowed	Returns true if HTML is allowed for this shape.
getSvgScreenOffset	Disables offset in IE9 for crisper image output.
checkBounds	Returns true if the bounds are not null and all of its variables are numeric.
apply	Extends mxShape to updat the text styles.
updateBoundingBox	Updates the <boundingBox> for this shape using the given node and position.
getShapeRotation	Returns 0 to avoid using rotation in the canvas via updateTransform.
getTextRotation	Returns the rotation for the text label of the corresponding shape.
isPaintBoundsInverted	Inverts the bounds if <mxShape.isBoundsInverted> returns true or if the horizontal style is false.
configureCanvas	Sets the state of the canvas for drawing the shape.
updateVmlContainer	Sets the width and height of the container to 1px.
paint	Generic rendering code.
redrawHtmlShape	Updates the HTML node(s) to reflect the latest bounds and scale.
updateHtmlTransform	Returns the spacing as an mxPoint.
updateHtmlFilter	Rotated text rendering quality is bad for IE9 quirks/IE8 standards
updateValue	Updates the HTML node(s) to reflect the latest bounds and scale.
updateFont	Updates the HTML node(s) to reflect the latest bounds and scale.
updateSize	Updates the HTML node(s) to reflect the latest bounds and scale.
getMargin	Returns the spacing as an mxPoint.
getSpacing	Returns the spacing as an mxPoint.

Functions

mxText

function mxText( value,
bounds,
align,
valign,
color,
family,
size,
fontStyle,
spacing,
spacingTop,
spacingRight,
spacingBottom,
spacingLeft,
horizontal,
background,
border,
wrap,
clipped,
overflow,
labelPadding )

Constructs a new text shape.

Parameters

value	String that represents the text to be displayed. This is stored in <value>.
bounds	mxRectangle that defines the bounds. This is stored in mxShape.bounds.
align	Specifies the horizontal alignment. Default is ‘’. This is stored in <align>.
valign	Specifies the vertical alignment. Default is ‘’. This is stored in <valign>.
color	String that specifies the text color. Default is ‘black’. This is stored in <color>.
family	String that specifies the font family. Default is mxConstants.DEFAULT_FONTFAMILY. This is stored in <family>.
size	Integer that specifies the font size. Default is mxConstants.DEFAULT_FONTSIZE. This is stored in <size>.
fontStyle	Specifies the font style. Default is 0. This is stored in <fontStyle>.
spacing	Integer that specifies the global spacing. Default is 2. This is stored in <spacing>.
spacingTop	Integer that specifies the top spacing. Default is 0. The sum of the spacing and this is stored in <spacingTop>.
spacingRight	Integer that specifies the right spacing. Default is 0. The sum of the spacing and this is stored in <spacingRight>.
spacingBottom	Integer that specifies the bottom spacing. Default is 0.The sum of the spacing and this is stored in <spacingBottom>.
spacingLeft	Integer that specifies the left spacing. Default is 0. The sum of the spacing and this is stored in <spacingLeft>.
horizontal	Boolean that specifies if the label is horizontal. Default is true. This is stored in <horizontal>.
background	String that specifies the background color. Default is null. This is stored in <background>.
border	String that specifies the label border color. Default is null. This is stored in <border>.
wrap	Specifies if word-wrapping should be enabled. Default is false. This is stored in <wrap>.
clipped	Specifies if the label should be clipped. Default is false. This is stored in <clipped>.
overflow	Value of the overflow style. Default is ‘visible’.

Variables

baseSpacingTop

mxText.prototype.baseSpacingTop

Specifies the spacing to be added to the top spacing. Default is 0. Use the value 5 here to get the same label positions as in mxGraph 1.x.

baseSpacingBottom

mxText.prototype.baseSpacingBottom

Specifies the spacing to be added to the bottom spacing. Default is 0. Use the value 1 here to get the same label positions as in mxGraph 1.x.

baseSpacingLeft

mxText.prototype.baseSpacingLeft

Specifies the spacing to be added to the left spacing. Default is 0.

baseSpacingRight

mxText.prototype.baseSpacingRight

Specifies the spacing to be added to the right spacing. Default is 0.

replaceLinefeeds

mxText.prototype.replaceLinefeeds

Specifies if linefeeds in HTML labels should be replaced with BR tags. Default is true.

verticalTextRotation

mxText.prototype.verticalTextRotation

Rotation for vertical text. Default is -90 (bottom to top).

ignoreClippedStringSize

mxText.prototype.ignoreClippedStringSize

Specifies if the actual string size should be measured if a label is clipped. If disabled the boundingBox will not ignore the actual size of the string, otherwise <bounds> will be used instead. Default is true. ignoreStringSize has precedence over this switch.

ignoreStringSize

mxText.prototype.ignoreStringSize

Specifies if the actual string size should be measured. If disabled the boundingBox will not ignore the actual size of the string, otherwise <bounds> will be used instead. Default is false.

Functions

isParseVml

mxText.prototype.isParseVml = function()

Text shapes do not contain VML markup and do not need to be parsed. This method returns false to speed up rendering in IE8.

isHtmlAllowed

mxText.prototype.isHtmlAllowed = function()

Returns true if HTML is allowed for this shape. This implementation returns true if the browser is not in IE8 standards mode.

getSvgScreenOffset

mxText.prototype.getSvgScreenOffset = function()

Disables offset in IE9 for crisper image output.

checkBounds

mxText.prototype.checkBounds = function()

Returns true if the bounds are not null and all of its variables are numeric.

apply

mxText.prototype.apply = function( state )

Extends mxShape to updat the text styles.

Parameters

state

mxCellState of the corresponding cell.

updateBoundingBox

mxText.prototype.updateBoundingBox = function()

Updates the <boundingBox> for this shape using the given node and position.

getShapeRotation

mxText.prototype.getShapeRotation = function()

Returns 0 to avoid using rotation in the canvas via updateTransform.

getTextRotation

mxText.prototype.getTextRotation = function()

Returns the rotation for the text label of the corresponding shape.

isPaintBoundsInverted

mxText.prototype.isPaintBoundsInverted = function()

Inverts the bounds if <mxShape.isBoundsInverted> returns true or if the horizontal style is false.

configureCanvas

mxText.prototype.configureCanvas = function( c,
x,
y,
w,
h )

Sets the state of the canvas for drawing the shape.

updateVmlContainer

mxText.prototype.updateVmlContainer = function()

Sets the width and height of the container to 1px.

paint

mxText.prototype.paint = function( c )

Generic rendering code.

redrawHtmlShape

mxText.prototype.redrawHtmlShape = function()

Updates the HTML node(s) to reflect the latest bounds and scale.

updateHtmlTransform

mxText.prototype.updateHtmlTransform = function()

Returns the spacing as an mxPoint.

updateHtmlFilter

mxText.prototype.updateHtmlFilter = function()

Rotated text rendering quality is bad for IE9 quirks/IE8 standards

updateValue

mxText.prototype.updateValue = function()

Updates the HTML node(s) to reflect the latest bounds and scale.

updateFont

mxText.prototype.updateFont = function( node )

Updates the HTML node(s) to reflect the latest bounds and scale.

updateSize

mxText.prototype.updateSize = function( node )

Updates the HTML node(s) to reflect the latest bounds and scale.

getMargin

Returns the spacing as an mxPoint.

getSpacing

mxText.prototype.getSpacing = function()

Returns the spacing as an mxPoint.