ZoomCharts Documentation

Version: 1.21.17 (2026-06-01)
Switch to Version 2.0 (BETA)

NetChart.settings.style.nodeExpanded.labelStyle

This section is defined by the type ItemsChartSettingsItemsLayerLabelStyle.

Properties

align: "center" | "right" | "left"
Default value: "left"

Text alignment.

angle: number

The angle at which the label are rotated

aspectRatio: number

Ratio between label sizes in different dimensions

View section details

Background style including fill color.

borderRadius: number

Radius of item border. Similar to CSS border radius property. Zero radius will show a rectangle

drawOrder: number

Controls the order the label is drawn in if the label supports configurable draw order. Lower numbers are always drawn before later numbers, and any non-zero drawOrder is always drawn after other chart elements. Note this cannot force drawing order to change beyond the boundaries of things like rendering clips.

extra: any

Extra data associated with the label

fontSizeScaleRoundingFunction: (fontSize: number) => number

If scaling by font size, how to round the scaled font. Mainly useful for optimizing font cache usage.

Parameters
fontSize: number
Return value
Data type: number
forceNoWrap: boolean
image: string

Label image.

imageSlicing: [number, number, number, number]

Slicing to use tiled images. Array of 4 values: [left, top, width, height]

lineSpacing: number
Default value: 0.2

Vertical space between the lines of text. In multiples of text line height.

margin: number

Margin around label text

maxWidth: number

Maximum width of the label.

minNonEllipsisWidth: number

The minimum space, in pixels, that a label must display before shortening the label with ellipsis is considered.

overlapStrategy: "none" | "skip" | "moveup" | "movedown" | "movevertical"

Specifies how the label handles overlap if the label supports configurable overlap strategy.

Valid values:
  • none - Ignore overlap and draw anyways
  • skip - Don't draw if it overlaps a previously drawn label
  • moveup - Move the label upwards until it no longer overlaps other labels.
  • movedown - Move the label downwards until it no longer overlaps other labels.
  • movevertical - Move the label either upwards or downwards to avoid overlap, depending on whichever direction moves the label less
padding: number

Padding between item content and item border.

scale: number

How much larger or smaller the item should be drawn

scaleByFontSize: boolean

Whether to apply scaling by changing the font size. Only necessary when using subpixel font sizes with large scaling factors, as otherwise the browser would have skipped calculating the font because it was too small to be seen.

scaleWithSize: boolean

Whether to apply different scale according to initial size of the link or node.

scaleWithZoom: boolean

Whether to apply the scale if zoom changes. If false, the label size never changes.

text: string

Label text.

Inherited from: BaseSettingsLabelStyle
View section details

Text style including fill color and font.

X