Interface NvlOptions

Configurations for a NVL instance

interface NvlOptions {
    allowDynamicMinZoom?: boolean;
    callbacks?: ExternalCallbacks;
    disableAria?: boolean;
    disableTelemetry?: boolean;
    disableWebGL?: boolean;
    disableWebWorkers?: boolean;
    disabledItemColor?: string;
    disabledItemFontColor?: string;
    frame?: HTMLElement;
    initialZoom?: number;
    instanceId?: string;
    layout?: Layout;
    layoutOptions?: LayoutOptions;
    layoutTimeLimit?: number;
    logging?: {
        level: LogLevelDesc;
    };
    maxZoom?: number;
    minZoom?: number;
    minimapContainer?: HTMLElement;
    nodeDefaultBorderColor?: string;
    panX?: number;
    panY?: number;
    relationshipThreshold?: number;
    renderer?: Renderer;
    selectedBorderColor?: string;
    styling?: {
        defaultNodeColor?: string;
        defaultRelationshipColor?: string;
        disabledItemColor?: string;
        disabledItemFontColor?: string;
        dropShadowColor?: string;
        minimapViewportBoxColor?: string;
        nodeDefaultBorderColor?: string;
        selectedBorderColor?: string;
        selectedInnerBorderColor?: string;
    };
    useWebGL?: boolean;
}

Properties

allowDynamicMinZoom? callbacks? disableAria? disableTelemetry? disableWebGL? disableWebWorkers? disabledItemColor? disabledItemFontColor? frame? initialZoom? instanceId? layout? layoutOptions? layoutTimeLimit? logging? maxZoom? minZoom? minimapContainer? nodeDefaultBorderColor? panX? panY? relationshipThreshold? renderer? selectedBorderColor? styling? useWebGL?

Properties

OptionalallowDynamicMinZoom

allowDynamicMinZoom?: boolean

Whether or not to dynamically allow decreasing minimum zoom value if current graph does not fit on screen at minimum zoom. When set to true, zoom and fit operations will allow zooming out further than the minimum zoom value if the graph does not fit on screen. When set to false, zoom and fit operations will stop at the minimum zoom value, even if the full graph does not fit on screen at that zoom level.

Default Value

true

Optionalcallbacks

callbacks?: ExternalCallbacks

OptionaldisableAria

disableAria?: boolean

Disables ARIA attributes on the graph. By default, NVL adds ARIA attributes to the graph container to make it more accessible. Attributes include role="image", aria-label="Graph visualization" and aria-describedby="nvl-${instanceId}-description". The description element is a live region that will announce changes to the graph.

Default Value

false

OptionaldisableTelemetry

disableTelemetry?: boolean

Disables tracking of library usage

Default Value

false

Optional InternaldisableWebGL

disableWebGL?: boolean

Whether or not to disable WebGL completely.

OptionaldisableWebWorkers

disableWebWorkers?: boolean

Disables the use of web workers for the layout calculations.

OptionaldisabledItemColor

disabledItemColor?: string

The color to use for the disabled nodes and relationships

Deprecated

Use styling.disabledItemColor instead

OptionaldisabledItemFontColor

disabledItemFontColor?: string

The color to use for the labels of the disabled nodes and relationships

Deprecated

Use styling.disabledItemFontColor instead

Optional Internalframe

frame?: HTMLElement

Deprecated

The DOM element in which to render the graph visualization

OptionalinitialZoom

initialZoom?: number

Zoom value of the current viewport

Optional InternalinstanceId

instanceId?: string

Id for uniquely identifying the instance of Nvl

Optionallayout

layout?: Layout

The graph layout algorithm to be used

OptionallayoutOptions

layoutOptions?: LayoutOptions

Configuration for the current layout

Optional InternallayoutTimeLimit

layoutTimeLimit?: number

Defines a time limit for how long layout iterations may run

Optional Internallogging

logging?: {
    level: LogLevelDesc;
}

Specify the log level.

OptionalmaxZoom

maxZoom?: number

The maximum zoom level allowed

Default

10

OptionalminZoom

minZoom?: number

The minimum zoom level allowed

Default

0.075

OptionalminimapContainer

minimapContainer?: HTMLElement

The DOM container in which to render the minimap.

Note

When using a React ref, make sure the attached element is rendered before the NVL instance is created. Otherwise, the minimap will not be displayed.

OptionalnodeDefaultBorderColor

nodeDefaultBorderColor?: string

The color to use for the default border of nodes

Deprecated

Use styling.nodeDefaultBorderColor instead

OptionalpanX

panX?: number

X-coordinate for panning of the current viewport

OptionalpanY

panY?: number

Y-coordinate for panning of the current viewport

Optional InternalrelationshipThreshold

relationshipThreshold?: number

Optionalrenderer

renderer?: Renderer

What renderer to use Possible values are 'webgl' or 'canvas'

Default Value

'webgl'
WebGL renderer uses GPU and has better performance.
Captions and arrowheads are only displayed when using the canvas renderer.

OptionalselectedBorderColor

selectedBorderColor?: string

The color to use for the selected border of nodes

Deprecated

Use styling.selectedBorderColor instead

Optionalstyling

styling?: {
    defaultNodeColor?: string;
    defaultRelationshipColor?: string;
    disabledItemColor?: string;
    disabledItemFontColor?: string;
    dropShadowColor?: string;
    minimapViewportBoxColor?: string;
    nodeDefaultBorderColor?: string;
    selectedBorderColor?: string;
    selectedInnerBorderColor?: string;
}

Type declaration

  • OptionaldefaultNodeColor?: string
  • OptionaldefaultRelationshipColor?: string
  • OptionaldisabledItemColor?: string

    The color to use for the disabled nodes and relationships

  • OptionaldisabledItemFontColor?: string

    The color to use for the labels of the disabled nodes and relationships

  • OptionaldropShadowColor?: string

    The color to use for the drop shadow of selected/hovered nodes and relationships

  • OptionalminimapViewportBoxColor?: string

    The color to use for the viewport box in the minimap

  • OptionalnodeDefaultBorderColor?: string

    The color to use for the default border of nodes

  • OptionalselectedBorderColor?: string

    The color to use for the selected border of nodes and relationships

  • OptionalselectedInnerBorderColor?: string

    The color to use for the selected inner border of nodes and relationships

OptionaluseWebGL

useWebGL?: boolean

Deprecated

use renderer instead Whether to user the Canvas or WebGL renderer Will be ignored when renderer is set

Settings

Member Visibility

On This Page

Properties