dojox.widget.rotator.Pan

Authors:Chris Barber
Project owner:Chris Barber
since:V1.4

A pan and continuous pan transition for a dojox.widget.Rotator or dojox.widget.AutoRotator.

Usage

The pan rotator transition is not an instantiated object, but rather a series of functions which consist of:

  • pan() - Returns a dojo.Animation that either pans left or right to the next pane.
  • panDown() - Returns a dojo.Animation that pans in the next rotator pane from the top.
  • panRight() - Returns a dojo.Animation that pans in the next rotator pane from the right.
  • panUp() - Returns a dojo.Animation that pans in the next rotator pane from the bottom.
  • panLeft() - Returns a dojo.Animation that pans in the next rotator pane from the left.

These functions are invoked by the rotator and may be different per pane.

Each function is passed an object containing the “transitionParams” along with the rotator’s current and next pane which are to be panned, then returns a dojo.Animation object describing the animated sequence.

pan()

pan() will only allow you to pan left to right and right to left and the direction is based on the current pane, the destination pane, and whether or not continuous panning and wrapping is enabled.

If panning forward from index 1 to 3, it will perform a pan left. If panning backwards from 5 to 1, then it will perform a pan right.

If the parameter “continuous” is set to true, it will return an animation chain of several pan animations of each intermediate pane panning. For example, if you pan forward from 1 to 3, it will return an animation panning left from 1 to 2 and then 2 to 3.

If an easing is specified, it will be applied to each pan transition. For example, if you are panning from pane 1 to pane 5 and you set the easing to “dojo.fx.easing.elasticInOut”, then it will “wobble” 5 times, once for each pan transition.

If the parameter “wrap” is set to true, it will pan to the next pane using the shortest distance in the array of panes. For example, if there are 6 panes, then panning from 5 to 1 will pan forward (left) from pane 5 to 6 and 6 to 1. If the distance is the same either going forward or backwards, then it will always pan forward (left).

A continuous pan will use the target pane’s duration to pan all intermediate panes. To use the target’s pane duration for each intermediate pane, then set the “quick” parameter to “false”.

Examples

Programmatic example

Example of a continuous pan.

.rotator{
    background-color:#fff;
    border:solid 1px #e5e5e5;
    width:400px;
    height:180px;
    overflow:hidden;
}
.pane{
    background-color:#fff;
    width:400px;
    height:180px;
    overflow:hidden;
    padding: 10px;
}
.pane0{
    background-color:#fff79e;
}
.pane1{
    background-color:#ffd4a0;
}
.pane2{
    background-color:#ffa0a0;
}
dojo.require("dojox.widget.AutoRotator");
dojo.require("dojox.widget.rotator.Pan");
dojo.ready(function(){
    new dojox.widget.AutoRotator(
        {
            transition: "dojox.widget.rotator.pan",
            transitionParams: "quick:true,continuous:true",
            duration: 2500,
            panes: [
                { className: "pane pane0", innerHTML: "<h3>Dojo</h3><p>Tons of features like CSS-based queries, event handling, animations, Ajax, class-based programming, and a package system</p>" },
                { className: "pane pane1", innerHTML: "<h3>Dijit</h3><p>Dojo's themeable, accessible, easy-to-customize UI Library</p>" },
                { className: "pane pane2", innerHTML: "<h3>DojoX</h3><p>Dojo eXtensions</p>" }
            ]

        },
        dojo.byId("myAutoRotator1")
    );
});
<div id="myAutoRotator1" class="rotator"></div>

<button onclick="dojo.publish('myAutoRotator1/rotator/control', ['prev']);">Prev</button>
<button onclick="dojo.publish('myAutoRotator1/rotator/control', ['go', 0]);">Go 1</button>
<button onclick="dojo.publish('myAutoRotator1/rotator/control', ['go', 1]);">Go 2</button>
<button onclick="dojo.publish('myAutoRotator1/rotator/control', ['go', 2]);">Go 3</button>
<button onclick="dojo.publish('myAutoRotator1/rotator/control', ['next']);">Next</button>

Declarative example

Example using different pan directions for each pane.

.rotator{
    background-color:#fff;
    border:solid 1px #e5e5e5;
    width:400px;
    height:100px;
    overflow:hidden;
}
.pane{
    background-color:#fff;
    width:400px;
    height:100px;
    overflow:hidden;
}
.pane0{
    background-color:#fff79e;
}
.pane1{
    background-color:#ffd4a0;
}
.pane2{
    background-color:#ffa0a0;
}
dojo.require("dojox.widget.AutoRotator");
dojo.require("dojox.widget.rotator.Pan");
<div data-dojo-type="dojox.widget.AutoRotator" class="rotator" id="myAutoRotator2" data-dojo-id="myAutoRotatorInstance2" data-dojo-props="transition:'dojox.widget.rotator.panLeft', duration:2500">
    <div class="pane pane0">Pane 0<br/>Panning down to Pane 1</div>
    <div class="pane pane1" transition="dojox.widget.rotator.panDown">Pane 1<br/>Panning right to Pane 2</div>
    <div class="pane pane2" transition="dojox.widget.rotator.panRight">Pane 2<br/>Using default transition to pan left to Pane 0</div>
</div>

<button onclick="dojo.publish('myAutoRotator2/rotator/control', ['prev']);">Prev</button>
<button onclick="dojo.publish('myAutoRotator2/rotator/control', ['go', 0]);">Go 1 (pan left)</button>
<button onclick="dojo.publish('myAutoRotator2/rotator/control', ['go', 1]);">Go 2 (pan down)</button>
<button onclick="dojo.publish('myAutoRotator2/rotator/control', ['go', 2]);">Go 3 (pan right)</button>
<button onclick="dojo.publish('myAutoRotator2/rotator/control', ['next']);">Next</button>

See also

Error in the documentation? Can’t find what you are looking for? Let us know!