WinJS.UI.Animation.fadeIn function

Performs an animation that fades an item or set of items into view.

The following video demonstrates the fade in and out animations:


WinJS.UI.Animation.fadeIn(shown).done( /* Your success and error handlers */ );


  • shown
    Type: Object

    Element or elements being faded in.

Return value

Type: Promise**

An object that completes when the animation has finished. Use this object when subsequent actions need this animation to finish before they take place.


The shown parameter 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 JavaScript array (possibly empty), in which each element of the array can be a single element or a JavaScript array of elements.
  • As a NodeList (for example, the result of querySelectorAll)
  • As an HTMLCollection


Minimum WinJS version

WinJS 1.0



See also


Animating fades

Guidelines and checklist for fade animations

HTML animation library sample