Aplicativos do Windows
Recolher sumário
Expandir sumário
EN
Este conteúdo não está disponível em seu idioma, mas aqui está a versão em inglês.

WinJS.UI.Animation.dragSourceStart function

Applies to Windows and Windows Phone

Performs an animation when the user begins to drag an object.

The following video demonstrates the drag animations:

Syntax


WinJS.UI.Animation.dragSourceStart(dragSource, affected).done( /* Your success and error handlers */ );

Parameters

dragSource

Type: Object

Element or elements being dragged.

affected [optional]

Type: Object

Element or elements whose position is affected by the movement of the dragged object. Typically, this is all other items in a reorderable list.

Return value

Type: Promise

An object that completes when the animation is finished.

Remarks

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 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

The position of the dragged item is normally updated through the CSS -ms-transform property. However, dragSourceStart overwrites that -ms-transform property. Therefore, to see expected behavior, you should wrap the dragged element in a second element which acts as a new parent. Apply dragSourceStart to the original element and -ms-transform to the new parent element.

Requirements

Minimum WinJS version

WinJS 1.0

Namespace

WinJS.UI.Animation

See also

dragSourceEnd
Animating drag-and-drop sequences
Guidelines and checklist for drag-and-drop animations
HTML animation library sample

 

 

Mostrar:
© 2017 Microsoft