The following list contains events that you can react on in a paper:

pointerdblclick

Triggered when pointer is double-clicked on a target (a `dblclick` event is detected).

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:pointerdblclick | Triggered when pointer is double-clicked on a cell.
link:pointerdblclick | Triggered when pointer is double-clicked on a link.
element:pointerdblclick | Triggered when pointer is double-clicked on an element.
blank:pointerdblclick | Triggered when pointer is double-clicked on the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

pointerclick

Triggered when pointer is clicked on a target without pointer movement (a `click` or `touchend` event is detected). Occurs alongside `pointerdown` and `pointerup` events.

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:pointerclick | Triggered when pointer is clicked on a cell.
link:pointerclick | Triggered when pointer is clicked on a link.
element:pointerclick | Triggered when pointer is clicked on an element.
blank:pointerclick | Triggered when pointer is clicked on the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

contextmenu

Triggered when pointer is right-clicked on a target (a `contextmenu` event is detected).

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:contextmenu | Triggered when pointer is right-clicked on a cell.
link:contextmenu | Triggered when pointer is right-clicked on a link.
element:contextmenu | Triggered when pointer is right-clicked on an element.
blank:contextmenu | Triggered when pointer is right-clicked on the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

pointerdown

Triggered when pointer is pressed down on a target (a `mousedown` or `touchstart` event is detected). The paper also starts delegating respective `pointermove` and `pointerup` events (including their touch counterparts; see below).

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:pointerdown | Triggered when pointer is pressed down on a cell.
link:pointerdown | Triggered when pointer is pressed down on a link.
element:pointerdown | Triggered when pointer is pressed down on an element.
blank:pointerdown | Triggered when pointer is pressed down on the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

pointermove

Triggered when pointer is moved over a target while pressed down (a `mousemove` or `touchmove` event is detected).

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:pointermove | Triggered when pointer is moved over a cell.
link:pointermove | Triggered when pointer is moved over a link.
element:pointermove | Triggered when pointer is moved over an element.
blank:pointermove | Triggered when pointer is moved over the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

pointerup

Triggered when pointer is released on a target after being pressed down (a `mouseup` or `touchend` event is detected).

The callback function is passed `cellView`, `evt`, `x` and `y` as arguments.

cell:pointerup | Triggered when pointer is released on a cell.
link:pointerup | Triggered when pointer is relased on a link.
element:pointerup | Triggered when pointer is released on an element.
blank:pointerup | Triggered when pointer is released on the paper outside any cell. The callback function is passed `evt`, `x` and `y` as arguments.

Calling `evt.stopPropagation()` prevents triggering a subsequent `pointerclick` event.

mouseover

Triggered when pointer begins to hover directly over a target.

The callback function is passed `cellView` and `evt` as arguments.

cell:mouseover | Triggered when pointer begins to hover directly over a cell.
link:mouseover | Triggered when pointer begins to hover directly over a link.
element:mouseover | Triggered when pointer begins to hover directly over an element.
blank:mouseover | Triggered when pointer begins to hover over the `svg` element of the paper outside any cell. The callback function is passed `evt` as argument.

mouseout

Triggered when pointer ceases to hover directly over a target.

The callback function is passed `cellView` and `evt` as arguments.

cell:mouseout | Triggered when pointer ceases to hover directly over a cell.
link:mouseout | Triggered when pointer ceases to hover directly over a link.
element:mouseout | Triggered when pointer ceases to hover directly over an element.
blank:mouseout | Triggered when pointer ceases to hover over the `svg` element of the paper outside any cell. The callback function is passed `evt` as argument.

mouseenter

Triggered when pointer enters the area above a target.

The callback function is passed `cellView` and `evt` as arguments.

cell:mouseenter | Triggered when pointer enters the area above a cell.
link:mouseenter | Triggered when pointer enters the area above a link.
element:mouseenter | Triggered when pointer enters the area above an element.
paper:mouseenter | Triggered when pointer enters the area of the paper (including paper border, if present). The callback function is passed `evt` as argument.

mouseleave

Triggered when pointer leaves the area above a target.

The callback function is passed `cellView` and `evt` as arguments.

cell:mouseleave | Triggered when pointer leaves the area above a cell.
link:mouseleave | Triggered when pointer leaves the area above a link.
element:mouseleave | Triggered when pointer leaves the area above an element.
paper:mouseleave | Triggered when pointer leaves the area of the paper (including paper border, if present). The callback function is passed `evt` as argument.

mousewheel

Triggered when mouse wheel is rotated while pointer is on a target.

The callback function is passed `cellView`, `evt`, `x`, `y` and `delta` as arguments.

cell:mousewheel | Triggered when mouse wheel is rotated while the pointer is on a cell.
link:mousewheel | Triggered when mouse wheel is rotated while the pointer is on a link.
element:mousewheel | Triggered when mouse wheel is rotated while the pointer is on an element.
blank:mousewheel | Triggered when mouse wheel is rotated while the pointer is on the paper outside any cell. The callback function is passed `evt`, `x`, `y` and `delta` as arguments.

magnet

Triggered when interacting with a magnet target.

The callback function is passed `elementView`, `evt`, `magnetSVGElement`, `x`, `y` as arguments.

element:magnet:pointerclick | Triggered when pointer is clicked on an element magnet and no link was created yet from this magnet (controlled by magnetThreshold option). Calling `evt.stopPropagation()` prevents triggering `cell:pointerclick` and `element:pointerclick` events.
element:magnet:pointerdblclick | Triggered when pointer is double-clicked on an element magnet. Calling `evt.stopPropagation()` prevents triggering `cell:pointerdblclick` and `element:pointerdblclick` events.
element:magnet:contextmenu | Triggered when pointer is right-clicked on an element magnet. Calling `evt.stopPropagation()` prevents triggering `cell:contextmenu` and `element:contextmenu` events. |

cell:highlight

Triggered when the `cellView.highlight` method is called on a link or element view.

The callback function is passed `cellView` and `el` as arguments.

The default handler method adds the `"highlighted"` CSS class to the cell, so that it can be targeted in user stylesheets. To use a different method for highlighting cells, first unregister the default handler with `paper.off('cell:highlight')` and then register a custom handler with `paper.on('cell:highlight', myHandler)`.

This method is also called automatically, in two situations. First, if the user reconnects a link and the connection is valid as determined by the `paper.options.validateConnection` method. Second, if embedding mode is enabled on the paper and dragged element is above another element it can be dropped onto as determined by the `paper.options.validateEmbedding` method.

cell:unhighlight

Triggered when the `cellView.unhighlight` method is called on a link or element view.

The callback function is passed `cellView` and `el` as arguments.

The default handler method removes the `"highlighted"` CSS class from the cell. To use a different method, first unregister the default handler with `paper.off('cell:unhighlight')` and then register a custom handler with `paper.on('cell:unhighlight', myHandler)`.

It is important to note that if a cell was highlighted using custom options, those exact same options must be provided to the unhighlight handler.

link:connect | Triggered when a link is connected to a cell. The callback function is passed `linkView`, `evt`, `elementViewConnected`, `magnet` and `arrowhead` as arguments.
link:disconnect | Triggered when a link is disconnected from a cell. The callback function is passed `linkView`, `evt`, `elementViewDisconnected`, `magnet` and `arrowhead` as arguments.
render:done | Triggered on `async` papers when all scheduled updates are done (i.e. all scheduled batches have finished).
[custom] | Custom cell event can be triggered on pointerdown with Event attribute. Calling `evt.stopPropagation()` prevents triggering all subsequent events.

An example of a simple `blank:pointerdown` event listener:

    paper.on('blank:pointerdown', function(evt, x, y) {
      alert('pointerdown on a blank area in the paper.')
    })

Consecutive `pointerdown`, `pointermove` and `pointerup` events can share information through the `evt.data` object:

    // Create a new link by dragging
    paper.on({
      'blank:pointerdown': function(evt, x, y) {
        var link = new joint.dia.Link();
        link.set('source', { x: x, y: y });
        link.set('target', { x: x, y: y });
        link.addTo(this.model);
        evt.data = { link: link, x: x, y: y };
      },
      'blank:pointermove': function(evt, x, y) {
        evt.data.link.set('target', { x: x, y: y });
      },
      'blank:pointerup': function(evt) {
        var target = evt.data.link.get('target');
        if (evt.data.x === target.x && evt.data.y === target.y) {
            // remove zero-length links
            evt.data.link.remove();
        }
      }
    });