[This documentation is preliminary and is subject to change.]
Applies to: Metro style apps only
Performs an animation that fades an item or items in, fading out existing items that occupy the same space.
WinJS.UI.Animation.crossFade(incoming, outgoing).done( /* Your success and error handlers */ );
Element or elements being faded in.
Element or elements being replaced.
Return valueType: Object
An object that completes when the animation has finished.
The parameters of this function can be expressed in several ways:
- As the special value "undefined", which means that the animation has no such target
- As a single object
- As a NodeList (for example, the result of querySelectorAll)
- As an HTMLCollection
If you want to remove an element involved in this animation from the document altogether, doing so before the animation is complete causes the animation to abruptly stop. You should use the Promise to be notified when the animation completes and then remove the element from the document.
Minimum supported client
|Windows 8 Consumer Preview|
Minimum supported server
|Windows Server 8 Beta|
Build date: 2/10/2012