Skip to main content

@blockly/workspace-minimap

Built with Blockly​

A Blockly plugin that adds a minimap to the workspace. A minimap is a miniature version of your blocks that appears on top of your main workspace. This gives you an overview of what your code looks like, and how it is organized. There is a focus region within the minimap that highlights the users's current viewport; this is on by default.

Minimap example

Installation​

Yarn​

yarn add @blockly/workspace-minimap

npm​

npm install @blockly/workspace-minimap --save

Usage​

Positioned Minimap​

A positioned minimap is an embedded component that lies on top of the primary workspace. When using a PositionedMinimap, the size of the minimap is determined by the window size, and the position by the primary workspace layout configuration.

import * as Blockly from 'blockly';
import {PositionedMinimap} from '@blockly/workspace-minimap';

// Inject Blockly.
const workspace = Blockly.inject('blocklyDiv', {
toolbox: toolboxCategories,
});

// Initialize plugin.
const minimap = new PositionedMinimap(workspace);
minimap.init();

Unpositioned Minimap​

A raw minimap is an object whose size and position is configured using css.

import * as Blockly from 'blockly';
import {Minimap} from '@blockly/workspace-minimap';

// Inject Blockly.
const workspace = Blockly.inject('blocklyDiv', {
toolbox: toolboxCategories,
});

// Initialize plugin.
const minimap = new Minimap(workspace);
minimap.init();
.blockly-minimap {
position: absolute;
box-shadow: none;
width: 200px;
height: 150px;
top: 0px;
left: 50vw;
}

Configuration​

The minimap takes a workspace as input and it inherits its RTL and theme properties (so that they don't need to be configured manually). Additional styling of the minimap is possible with CSS. Use the blockly-minimap class for the minimap (box-shadow, etc.) and blockly-focus-region for the focus region (fill color, etc.).

Keyboard accessibility​

The minimap is a single tab stop in the page tab order. When focused, the arrow keys pan the main workspace:

KeyAction
ArrowUpPan the workspace up
ArrowDownPan the workspace down
ArrowLeftPan the workspace left
ArrowRightPan the workspace right

Modifier key combinations (Ctrl, Alt, Shift, Meta) are passed through without panning.

The default pan distance is 40 workspace pixels per keypress and is configurable:

minimap.setKeyboardPanStep(80); // pan 80px per arrow press

API​

  • init: Initializes the minimap.

  • dispose: Disposes of the minimap.

  • isFocusEnabled: Returns whether the focus region is enabled.

  • enableFocusRegion: Turns on the focus region in the minimap.

  • disableFocusRegion: Turns off the focus region in the minimap.

  • setKeyboardPanStep(stepPixels): Sets how far (in primary-workspace pixels) each arrow keypress pans the workspace when the minimap is focused.

  • getKeyboardPanStep(): Returns the current keyboard pan step in primary-workspace pixels.

The following methods are also accessible with PositionedMinimap instances.

  • position: Positions the minimap UI element.
  • getBoundingRectangle: Returns the bounding rectangle of the UI element in pixel units relative to the Blockly injection div.

License​

Apache 2.0

A Blockly plugin that adds a minimap, which is a miniature version of the blocks that appears on top of the main workspace.

Classes​

ClassDescription
MinimapA minimap is a miniature version of your blocks that appears on top of your main workspace. This gives you an overview of what your code looks like, and how it is organized.
PositionedMinimapA positionable version of minimap that implements IPositionable.