dojo.fadeIn¶
| Authors: | Peter Higgins, Nikolai Onken, Marcus Reimann, Jared Jurkiewicz |
|---|---|
| Developers: | Bryan Forbes, Peter Higgins, Eugene Lazutkin, Bill Keese, Adam Peller, Alex Russell, Dylan Schiemann, sjmiles |
| since: | V1.0 |
Contents
This function is a helper function that wraps the dojo.animateProperty function to provide an easy interface to fading a node into view on the page. While this can be done with the dojo.animateProperty function, this function is simpler to use and will handle 99% of the cases a fade-in is desired.
Parameters¶
The dojo.fadeIn takes an object as its parameter. This object defines what dom node to act on, how long the fade in should take (in milliseconds, and an optional easing function. As with all dojo apis, refer to the API docs for the most up to date information on parameters. These are listed for convenience.
FIXME: just inline API signature
Return value¶
The dojo.fadeIn function returns an instance of dojo._Animation. To execute the fadeIn, call the play() function on the animation. This object can be used with other dojo animation functions, such as dojo.fx.chain and dojo.fx.combine to link it with other effects to perform complex animations.
Examples¶
Example 1: Fade in a dom node¶
dojo.require("dijit.form.Button");
function basicFadeinSetup(){
// Style the dom node to opacity 0;
dojo.style("basicFadeNode", "opacity", "0");
// Function linked to the button to trigger the fade.
function fadeIt(){
dojo.style("basicFadeNode", "opacity", "0");
var fadeArgs = {
node: "basicFadeNode"
};
dojo.fadeIn(fadeArgs).play();
}
dojo.connect(dijit.byId("basicFadeButton"), "onClick", fadeIt);
}
dojo.ready(basicFadeinSetup);
<button data-dojo-type="dijit.form.Button" id="basicFadeButton">Fade It In!</button>
<div id="basicFadeNode" style="width: 100px; height: 100px; background-color: red;"></div>
Example 2: Fade in a dom node with a custom duration¶
dojo.require("dijit.form.Button");
function basicFadeinSetup2(){
// Style the dom node to opacity 0;
dojo.style("basicFadeNode2", "opacity", "0");
// Function linked to the button to trigger the fade.
function fadeIt(){
dojo.style("basicFadeNode2", "opacity", "0");
var fadeArgs = {
node: "basicFadeNode2",
duration: 5000,
};
dojo.fadeIn(fadeArgs).play();
}
dojo.connect(dijit.byId("basicFadeButton2"), "onClick", fadeIt);
}
dojo.ready(basicFadeinSetup2);
<button data-dojo-type="dijit.form.Button" id="basicFadeButton2">Fade It In Slow!</button>
<div id="basicFadeNode2" style="width: 100px; height: 100px; background-color: red;"></div>
Example 3: Fade in a dom node with an easing function¶
dojo.require("dijit.form.Button");
dojo.require("dojo.fx.easing");
function basicFadeinSetup3(){
// Style the dom node to opacity 0;
dojo.style("basicFadeNode3", "opacity", "0");
// Function linked to the button to trigger the fade.
function fadeIt(){
dojo.style("basicFadeNode3", "opacity", "0");
var fadeArgs = {
node: "basicFadeNode3",
duration: 8000,
easing: dojo.fx.easing.expoOut
};
dojo.fadeIn(fadeArgs).play();
}
dojo.connect(dijit.byId("basicFadeButton3"), "onClick", fadeIt);
}
dojo.ready(basicFadeinSetup3);
<button data-dojo-type="dijit.form.Button" id="basicFadeButton3">Fade It In Slow with Expo Easing!</button>
<div id="basicFadeNode3" style="width: 100px; height: 100px; background-color: red;"></div>