Class Index | File Index

Classes


Class pv.Behavior.select


Extends pv.Behavior.
Implements interactive selecting starting with mousedown events. Register this behavior on panels that should be selectable by the user, such for brushing and linking. This behavior can be used in tandom with pv.Behavior.drag to allow the selected region to be dragged interactively.

After the initial mousedown event is triggered, this behavior listens for mousemove and mouseup events on the window. This allows selecting to continue even if the mouse temporarily leaves the assigned panel, or even the root panel.

This behavior requires that the data associated with the mark being dragged have x, y, dx and dy attributes that correspond to the mark's location and dimensions in pixels. The mark's positional properties are not set directly by this behavior; instead, the positional properties should be defined as:

    .left(function(d) d.x)
    .top(function(d) d.y)
    .width(function(d) d.dx)
    .height(function(d) d.dy)
Thus, the behavior does not resize the mark directly, but instead updates the selection by updating the assigned panel's underlying data. Note that if the positional properties are defined with bottom and right (rather than top and left), the drag behavior will be inverted, which will confuse users!

The select behavior is bounded by the assigned panel; the positional attributes are clamped such that the selection does not extend outside the panel's bounds.

The panel being selected is automatically re-rendered for each mouse event as part of the drag operation. This behavior may be enhanced in the future to allow more flexible configuration of select behavior. In some cases, such as with parallel coordinates, making a selection may cause related marks to change, in which case additional marks may also need to be rendered. This can be accomplished by listening for the select psuedo-events:

For example, to render the parent panel while selecting, thus re-rendering all sibling marks:
    .event("mousedown", pv.Behavior.drag())
    .event("select", function() this.parent)
This behavior may be enhanced in the future to allow more flexible configuration of the selection behavior.
Defined in: Select.js.

Class Summary
Constructor Attributes Constructor Name and Description
 
Returns a new select behavior to be registered on mousedown events.
Class Detail
pv.Behavior.select()
Returns a new select behavior to be registered on mousedown events.
See:
pv.Behavior.drag

Documentation generated by JsDoc Toolkit 2.3.2 on Sun May 30 2010 18:10:23 GMT-0700 (PDT)