EdgeLabelOptions

Defined in: packages/sigma/src/rendering/edges/types.ts:465

Options for edge label styling. Used both in EdgeProgramOptions.label and CreateEdgeLabelProgramOptions.

Note: Property names here (color, position, margin, fontSizeMode) are shorter than the corresponding settings (edgeLabelColor, edgeLabelPosition, etc.) since these are already in an edge label context.

Extended by

• CreateEdgeLabelProgramOptions

Properties

color?

optional color?: EdgeLabelColorSpecification

Defined in: packages/sigma/src/rendering/edges/types.ts:470

Label color configuration. Can specify either a fixed color or an attribute name. Default: uses settings.edgeLabelColor

---

fontSizeMode?

optional fontSizeMode?: EdgeLabelFontSizeMode

Defined in: packages/sigma/src/rendering/edges/types.ts:505

Font size mode for edge labels.

• “fixed”: Constant pixel size regardless of zoom (default)
• “scaled”: Scales with zoom level using zoomToSizeRatioFunction from settings Default: uses settings.edgeLabelFontSizeMode

---

fullVisibilityThreshold?

optional fullVisibilityThreshold?: number

Defined in: packages/sigma/src/rendering/edges/types.ts:519

Visibility ratio at which labels reach full opacity (0-1). Between minVisibilityThreshold and this value, labels fade in gradually. Default: 0.6

---

keepUpright?

optional keepUpright?: boolean

Defined in: packages/sigma/src/rendering/edges/types.ts:527

Keeps labels readable: labels whose edge points leftward on screen are reversed so they never render upside down. The edge direction is kept. Labels flip as soon as their edge crosses vertical on screen. Default: true

---

margin?

optional margin?: number

Defined in: packages/sigma/src/rendering/edges/types.ts:480

Margin between the edge surface and the label (in pixels) for “above”/“below”/“auto” modes. Default: uses settings.edgeLabelMargin

Note: per-edge position is set via the style system (labelPosition style), not here — styles are the single source of truth so the text and its background/picking hitbox can’t disagree.

---

minVisibilityThreshold?

optional minVisibilityThreshold?: number

Defined in: packages/sigma/src/rendering/edges/types.ts:512

Minimum label visibility ratio to render (0-1). Labels with less visible content are hidden entirely. Default: 0.5

---

textBorder?

optional textBorder?: object

Defined in: packages/sigma/src/rendering/edges/types.ts:486

Text border (outline/stroke) configuration for improved readability. When specified, renders a border around each character using SDF techniques.

color

color: EdgeLabelColorSpecification

Border color - fixed color string or attribute-based. Examples:

• "#ffffff" - Fixed white color
• { attribute: "borderColor" } - Read from edge attribute
• { attribute: "borderColor", defaultColor: "#fff" } - Attribute with fallback

width

width: number

Border width in pixels