SVG Events

API Reference

Standard event listeners can be registered (and unregistered) in D3 using the selection's on operator. While you can use the native event's pageX and pageY, it is often more convenient to transform the event position to the local coordinate system of the container that received the event. For example, if you embed an SVG in the normal flow of your page, you may want the event position relative to the top-left corner of the SVG image. If your SVG contains svg:g elements to translate or transform your shapes, you might also want to know the position of the event relative to those shapes. Use the mouse operator for the standard mouse pointer, and use touches for multitouch events on iOS.

# d3.svg.mouse(container)

Returns the x and y coordinates of the current d3.event, relative to the specified container. The container must be an SVG container element, such as an svg:g or svg:svg. The coordinates are returned as a two-element array [x, y].

# d3.svg.touches(container)

Returns the x and y coordinates of each touch associated with the current d3.event, based on the touches attribute, relative to the specified container. The container must be an SVG container element, such as an svg:g or svg:svg. The coordinates are returned as an array of two-element arrays [[x1, y1], [x2, y2], …].