Weave.js

Stage Grid

Renders a reference grid behind the nodes layer

Introduction

This plugin adds a visual background grid to the canvas stage, helping users align and position elements more precisely. The grid can be rendered as lines or dots, and supports customizable spacing, color, and style.

Is especially useful for diagramming tools, design interfaces, or any application where spatial structure improves usability. It integrates seamlessly with zoom and pan behaviors to ensure the grid remains consistent and responsive during interactions.

Usage

Import the Plugin

Start by importing the plugin:

import { WeaveStageGridPlugin } from "@inditextech/weave-sdk";

Register the Plugin

Then register the plugin on the Weave class instance.

const instance = new Weave({
  ...
  plugins: [
    ...,
    new WeaveStageGridPlugin(), 
  ]
})

You can also define:

  • The type of the grid (by default is a line grid, but it also can be a dot grid).
  • The style of the grid (visual colors and appearance).
  • The separation of the grid cells.

For more information check the WeaveStageGridPlugin plugin API.

Use the plugin

Once the plugin is registered the final user should be able to see the reference grid.

The plugin also provides a public API to:

  • Enable / disable the grid.
  • Change the grid type.