EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

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

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1

Namespace

WinJS.UI.Animation

Library

Ui.js

See also

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

 

 

Anzeigen:
© 2014 Microsoft