Layout concepts

Hotspots

You can resize and reposition dashboard content much as you like, but there are some constraints. For example, a minimum size can be specified for reports. This might prevent you placing a report widget in certain positions.

This topic is an overview of some basic layout concepts.

Dashboards have hotspots at their corners and edges. Widgets have hotspots at their edges and centers.

A hotspot is displayed when, whilst dragging a widget, the mouse pointer is over the hotspot.

If you pause over the hotspot, a preview is displayed beneath the widget. The preview indicates the position the widget will occupy if you drop it.

As you add content, further hotspots become available.

Initially, the hotspots at the edges of a dashboard occupy a position mid-way along the length of the edge. Here, when dropped, Widget I expands horizontally along the length of the edge. It also expands vertically to occupy half the available space.

But in this second example, the left and bottom edges of the dashboard are already partially occupied by Widgets I and II, leaving an empty space between the bottom of Widget I and the top edge of Widget II.

When Widget III is dragged over the space at the left hand edge, a hotspot is displayed. When dropped, Widget III contracts vertically to occupy the empty space, and expands horizontally to occupy half the available space.

Tile

Here, Widget II is dropped when the mouse pointer is above a hotspot of Widget I. Widget II captures half the space occupied by Widget I:

Swap

To swap the positions of two widgets, drag one widget over the other and drop when the central hotspots are aligned:

Note: Swapping might not be possible if the widgets contain reports for which a minimum size has been specified.

Push and crush

To push one widget with another, use one of these the options while dragging the widget: press the Shift key, or press both mouse clicks. If a widget is pushed against an edge of the dashboard, it is compressed. It does not return to its original size if the pushing widget is withdrawn.

If you withdraw the pushing widget before you drop it, the crushed widgets revert to their original dimensions.

Push between

To push a widget between adjacent widgets , drag it over the adjacent widgets, press Shift, and then drop the widget:

Fill

In the properties of a widget you can specify that the widget automatically expands horizontally or vertically to fill the available space. This is important in creating dashboards which auto-size. You can place widgets at either end of a widget that has horizontal or vertical fill:

  1. Drag a widget over the end of a widget with horizontal or vertical fill.
  2. Drop the widget when a hotspot is displayed at the edge of the widget underneath.

The filled widget shrinks to accommodate the new widget but retains its fill setting. It will expand again if Widget II is removed:

Shortcuts

You can use these keyboard shortcuts when you drag or resize widgets:

  • Ecs: To undo resizing or repositioning of a widget, press the Ecs key before you release the mouse button.
  • O: To keep a widget's original size, press and hold the O key while you drag it into position on a dashboard. The widget will not automatically resize to fit an available space.
  • R: To keep a widget's height to width ratio, press and hold the R key while you drag its borders to resize it.
  • S: To temporarily toggle helper lines and snapping or off, press the S key while dragging a widget.