dojo/fx::wipeIn()¶
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/_base/fx::animateProperty() function to provide an easy interface to wiping a node into view on the page. While
this can be done with the animateProperty()
function, this function is simpler to use and will handle 99% of the
cases a wipe-in is desired.
NOTE: The wipe end wipes from a height of 0px
to the full height of the target DOMNode.
Usage¶
Basic usage requires just the node to be wiped-in to be passed:
require(["dojo/fx"], function(coreFx){
coreFx.wipeIn({
node: "someNode"
}).play();
});
The function configuration hash can take the other properties of dojo/_base/fx::animateProperty().
The wipeIn()
function returns an instance of dojo/_base/fx::Animation. To start the
wipe-in, 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¶
This example does a simple wipe-in of a DOMNode
require(["dojo/fx", "dojo/dom", "dojo/dom-style", "dojo/on", "dojo/domReady!"],
function(coreFx, dom, style, on){
on(dom.byId("basicWipeButton"), "click", function(){
style.set("basicWipeNode", "display", "none");
coreFx.wipeIn({
node: "basicWipeNode"
}).play();
});
});
<button type="button" id="basicWipeButton">Wipe It In!</button>
<div id="basicWipeNode" style="width: 200px; background-color: red; display: none;">
<b>This is a container of random content to wipe in!</b>
</div>
This example adds a custom duration to the wipe-in animation
require(["dojo/fx", "dojo/dom", "dojo/dom-style", "dojo/on", "dojo/domReady!"],
function(coreFx, dom, style, on){
on(dom.byId("basicWipeButton1"), "click", function(){
style.set("basicWipeNode1", "display", "none");
coreFx.wipeIn({
node: "basicWipeNode1",
duration: 5000
}).play();
});
});
<button type="button" id="basicWipeButton1">Wipe It In!</button>
<div id="basicWipeNode1" style="width: 200px; background-color: red; display: none;">
<b>This is a container of random content to wipe in slowly!</b>
</div>
Wipe-in a node with an easing function.
require(["dojo/fx", "dojo/fx/easing", "dojo/dom", "dojo/dom-style", "dojo/on", "dojo/domReady!"],
function(coreFx, easing, dom, style, on){
on(dom.byId("basicWipeButton2"), "click", function(){
style.set("basicWipeNode2", "display", "none");
coreFx.wipeIn({
node: "basicWipeNode2",
duration: 5000,
easing: easing.expoOut
}).play();
});
});
<button type="button" id="basicWipeButton2">Wipe It In!</button>
<div id="basicWipeNode2" style="width: 200px; background-color: red; display: none;">
<b>This is a container of random content to wipe in slowly with the expoOut easing!</b>
</div>
See Also¶
- dojo/fx::wipeOut() - The companion to
wipeIn()
- dojo/_base/fx::animateProperty() - Details around the other options possible
- Animation Tutorial - The tutorial to find out about Dojo’s FX API