jQuery UI API - Draggable Widget
Kategorie
Nutzung
Beschreibung:Ermöglicht das Verschieben von Elementen mit der Maus.
添加版本:1.0
D:
Hinweise:Macht die ausgewählten Elemente mit der Maus ziehbar. Wenn Sie nicht nur ziehen, sondern Drag & Drop verwenden möchten, siehe dasjQuery UI Droppable-Plugin, das ein Drop-Ziel für ziehbare Elemente bereitstellt.
Schnellnavigation
| Optionen | Methoden | Ereignisse |
|---|---|---|
| Optionen | Type | Beschreibung | Standard |
|---|---|---|---|
| addClasses | Boolean | Wenn festgelegt auffalse, es wird verhindernui-draggabledass die Klasse hinzugefügt wird. Beim Aufruf auf Hunderten von Elementen,.draggable()Diese Einstellung ist vorteilhaft für die Leistungsoptimierung.Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ addClasses: false });
Nach der Initialisierung abrufen oder festlegen // getter var addClasses = $( ".selector" ).draggable( "option", "addClasses" ); // setter $( ".selector" ).draggable( "option", "addClasses", false ); |
wahr |
| appendTo | jQuery oder Element oder Selector oder String | An welches Element der Draggable-Helfer während des Ziehens angehängt werden soll. Mehrere Typen werden unterstützt:
Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ appendTo: "body" });
Nach der Initialisierung abrufen oder festlegen // getter var appendTo = $( ".selector" ).draggable( "option", "appendTo" ); // setter $( ".selector" ).draggable( "option", "appendTo", "body" ); |
"parent" |
| axis | String | Beschränkt das Ziehen auf die horizontale (x) oder vertikale (y) Achse. Mögliche Werte:"x", "y"。Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ axis: "x" });
Nach der Initialisierung abrufen oder festlegen // getter var axis = $( ".selector" ).draggable( "option", "axis" ); // setter $( ".selector" ).draggable( "option", "axis", "x" ); |
false |
| Abbruch | Selektor | Verhindert, dass das Ziehen auf den angegebenen Elementen beginnt. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ cancel: ".title" });
Nach der Initialisierung abrufen oder festlegen // getter var cancel = $( ".selector" ).draggable( "option", "cancel" ); // setter $( ".selector" ).draggable( "option", "cancel", ".title" ); |
"input, textarea, button, select, option" |
| connectToSortable | Selektor | Ermöglicht, dass das Draggable auf das angegebene Sortable abgelegt werden kann. Wenn diese Option verwendet wird, kann ein Draggable auf eine Sortable-Liste abgelegt werden und Teil davon werden. Hinweis:helperDie Option muss gesetzt werden auf"clone", damit es besser funktioniert. MussSortable Widget enthalten.。Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ connectToSortable: "#my-sortable" });
Nach der Initialisierung abrufen oder festlegen // getter var connectToSortable = $( ".selector" ).draggable( "option", "connectToSortable" ); // setter $( ".selector" ).draggable( "option", "connectToSortable", "#my-sortable" ); |
false |
| containment | Selector oder Element oder String oder Array | Beschränkt das Ziehen auf die Grenzen des angegebenen Elements oder Bereichs. Mehrere Typen werden unterstützt:
Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ containment: "parent" });
Nach der Initialisierung abrufen oder festlegen // getter var containment = $( ".selector" ).draggable( "option", "containment" ); // setter $( ".selector" ).draggable( "option", "containment", "parent" ); |
false |
| cursor | String | Der CSS-Cursor während des Ziehvorgangs. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ cursor: "crosshair" });
Nach der Initialisierung abrufen oder festlegen // getter var cursor = $( ".selector" ).draggable( "option", "cursor" ); // setter $( ".selector" ).draggable( "option", "cursor", "crosshair" ); |
"auto" |
| cursorAt | Objekt | Legt den Versatz des Drag-Helfers relativ zum Mauszeiger fest. Koordinaten können als Hash unter Verwendung einer Kombination aus einem oder zwei Schlüsseln angegeben werden:{ top, left, right, bottom }。Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ cursorAt: { left: 5 } });
Nach der Initialisierung abrufen oder festlegen
// getter
var cursorAt = $( ".selector" ).draggable( "option", "cursorAt" );
// setter
$( ".selector" ).draggable( "option", "cursorAt", { left: 5 } );
|
false |
| delay | Number | Die Zeit in Millisekunden nach mousedown, bis das Ziehen beginnen soll. Diese Option kann unerwünschtes Ziehen beim Klicken auf ein Element verhindern. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ delay: 300 });
Nach der Initialisierung abrufen oder festlegen // getter var delay = $( ".selector" ).draggable( "option", "delay" ); // setter $( ".selector" ).draggable( "option", "delay", 300 ); |
0 |
| disabled | Boolean | Wenn festgelegt auftrue, deaktiviert dann das Draggable.Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ disabled: true });
Nach der Initialisierung abrufen oder festlegen // getter var disabled = $( ".selector" ).draggable( "option", "disabled" ); // setter $( ".selector" ).draggable( "option", "disabled", true ); |
false |
| distance | Number | Die Entfernung in Pixeln, die die Maus nach mousedown zurücklegen muss, bevor das Ziehen beginnt. Diese Option kann ungewolltes Ziehen verhindern, wenn auf ein Element geklickt wird. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ distance: 10 });
Nach der Initialisierung abrufen oder festlegen // getter var distance = $( ".selector" ).draggable( "option", "distance" ); // setter $( ".selector" ).draggable( "option", "distance", 10 ); |
1 |
| grid | Array | Rastet den Drag-Helfer an einem Raster aus, jeweils um x und y Pixel. Das Array muss die Form haben[ x, y ]。Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ grid: [ 50, 20 ] });
Nach der Initialisierung abrufen oder festlegen // getter var grid = $( ".selector" ).draggable( "option", "grid" ); // setter $( ".selector" ).draggable( "option", "grid", [ 50, 20 ] ); |
false |
| handle | Selektor oder Element | Falls angegeben, wird verhindert, dass das Ziehen beginnt, es sei denn, mousedown tritt auf dem angegebenen Element auf. Nur Nachfahren des ziehbaren Elements dürfen gezogen werden. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ handle: "h2" });
Nach der Initialisierung abrufen oder festlegen // getter var handle = $( ".selector" ).draggable( "option", "handle" ); // setter $( ".selector" ).draggable( "option", "handle", "h2" ); |
false |
| helper | String oder Function() | Erlaubt die Verwendung eines Hilfselements für die Drag-Anzeige. Mehrere Typen werden unterstützt:
Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ helper: "clone" });
Nach der Initialisierung abrufen oder festlegen // getter var helper = $( ".selector" ).draggable( "option", "helper" ); // setter $( ".selector" ).draggable( "option", "helper", "clone" ); |
"original" |
| iframeFix | Boolean oder Selektor | Verhindert, dass iframes während eines Drags mousemove-Ereignisse abfangen. Nützlich in Kombination mit dercursorAtOption oder wenn sich der Mauszeiger nicht über dem Helper befindet.Mehrere Typen werden unterstützt:
Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ iframeFix: true });
Nach der Initialisierung abrufen oder festlegen // getter var iframeFix = $( ".selector" ).draggable( "option", "iframeFix" ); // setter $( ".selector" ).draggable( "option", "iframeFix", true ); |
false |
| opacity | Number | Die Deckkraft des Helpers während des Ziehens. Codebeispiele: Initialisieren Sie das Draggable mit der angegebenen
$( ".selector" ).draggable({ opacity: 0.35 });
Nach der Initialisierung abrufen oder festlegen // getter var opacity = $( ".selector" ).draggable( "option", "opacity" ); // setter $( ".selector" ).draggable( "option", "opacity", 0.35 ); |
false |
| refreshPositions | Boolean | Wenn festgelegt auftrue, werden alle droppable-Positionen bei jedem mousemove berechnet. Hinweis: Dies löst hochdynamische Szenarien, reduziert jedoch die Leistung erheblich.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ refreshPositions: true });
Abrufen oder Festlegen der // getter var refreshPositions = $( ".selector" ).draggable( "option", "refreshPositions" ); // setter $( ".selector" ).draggable( "option", "refreshPositions", true ); |
false |
| revert | Boolean oder String oder Function() | Gibt an, ob das Element an seine Ausgangsposition zurückkehrt, wenn das Ziehen beendet wird. Unterstützt mehrere Typen:
Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ revert: true });
Abrufen oder Festlegen der // getter var revert = $( ".selector" ).draggable( "option", "revert" ); // setter $( ".selector" ).draggable( "option", "revert", true ); |
false |
| revertDuration | Number | Die Dauer der Rückkehr-Animation in Millisekunden. Wenn dierevertOption istfalse, wird sie ignoriert.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ revertDuration: 200 });
Abrufen oder Festlegen der // getter var revertDuration = $( ".selector" ).draggable( "option", "revertDuration" ); // setter $( ".selector" ).draggable( "option", "revertDuration", 200 ); |
500 |
| scope | String | Wird verwendet, um zusammengehörige Draggable- und Droppable-Elemente zu gruppieren, zusätzlich zuracceptOption des Droppable. Ein Draggable mit derselbenscopeWert als Droppable wird von diesem Droppable akzeptiert.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ scope: "tasks" });
Abrufen oder Festlegen der // getter var scope = $( ".selector" ).draggable( "option", "scope" ); // setter $( ".selector" ).draggable( "option", "scope", "tasks" ); |
"default" |
| scroll | Boolean | Wenn festgelegt auftrue, scrollt der Container während des Ziehens automatisch.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ scroll: false });
Abrufen oder Festlegen der // getter var scroll = $( ".selector" ).draggable( "option", "scroll" ); // setter $( ".selector" ).draggable( "option", "scroll", false ); |
wahr |
| scrollSensitivity | Number | Der Abstand in Pixeln vom Rand des Viewports, ab dem gescrollt werden soll. Der Abstand ist relativ zum Zeiger, nicht zum Draggable. Wenn derscrollOption istfalse, wird sie ignoriert.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ scrollSensitivity: 100 });
Abrufen oder Festlegen der // getter var scrollSensitivity = $( ".selector" ).draggable( "option", "scrollSensitivity" ); // setter $( ".selector" ).draggable( "option", "scrollSensitivity", 100 ); |
20 |
| scrollSpeed | Number | Wenn der Mauszeiger innerhalb vonscrollSensitivityAbstand, die Geschwindigkeit, mit der das Fenster scrollt. Wenn derscrollOption istfalse, wird sie ignoriert.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ scrollSpeed: 100 });
Abrufen oder Festlegen der // getter var scrollSpeed = $( ".selector" ).draggable( "option", "scrollSpeed" ); // setter $( ".selector" ).draggable( "option", "scrollSpeed", 100 ); |
20 |
| snap | Boolean oder Selektor | Ob das Element an anderen Elementen einrastet. Unterstützt mehrere Typen:
Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ snap: true });
Abrufen oder Festlegen der // getter var snap = $( ".selector" ).draggable( "option", "snap" ); // setter $( ".selector" ).draggable( "option", "snap", true ); |
false |
| snapMode | String | Bestimmt, an welcher Kante des Snap-Ziels das Draggable einrastet. Wenn dersnapOption istfalsewird es ignoriert. Mögliche Werte:"inner"、"outer"、"both"。Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ snapMode: "inner" });
Abrufen oder Festlegen der // getter var snapMode = $( ".selector" ).draggable( "option", "snapMode" ); // setter $( ".selector" ).draggable( "option", "snapMode", "inner" ); |
"both" |
| snapTolerance | Number | Der Abstand in Pixeln vom Rand des Snap-Ziels, bei dem das Einrasten erfolgt. Wenn dersnapOption istfalse, wird sie ignoriert.Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ snapTolerance: 30 });
Abrufen oder Festlegen der // getter var snapTolerance = $( ".selector" ).draggable( "option", "snapTolerance" ); // setter $( ".selector" ).draggable( "option", "snapTolerance", 30 ); |
20 |
| stack | Selektor | Steuert den z-index der Menge von Elementen, die dem Selektor entsprechen, immer vor dem aktuell gezogenen Element. Nützlich für Dinge wie Fenstermanager. Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ stack: ".products" });
Abrufen oder Festlegen der // getter var stack = $( ".selector" ).draggable( "option", "stack" ); // setter $( ".selector" ).draggable( "option", "stack", ".products" ); |
false |
| zIndex | Number | Der z-index des Helpers während des Ziehens. Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).draggable({ zIndex: 100 });
Abrufen oder Festlegen der // getter var zIndex = $( ".selector" ).draggable( "option", "zIndex" ); // setter $( ".selector" ).draggable( "option", "zIndex", 100 ); |
false |
| Methoden | Gibt zurück | Beschreibung |
|---|---|---|
| destroy() | jQuery (nur Plugin) | Entfernt die draggable-Funktionalität vollständig. Dadurch wird das Element in seinen Zustand vor der Initialisierung zurückversetzt.
Codebeispiele: Rufen Sie die destroy-Methode auf: $( ".selector" ).draggable( "destroy" ); |
| disable() | jQuery (nur Plugin) | Deaktiviert das draggable.
Codebeispiele: Rufen Sie die disable-Methode auf: $( ".selector" ).draggable( "disable" ); |
| enable() | jQuery (nur Plugin) | Aktiviert das draggable.
Codebeispiele: Rufen Sie die enable-Methode auf: $( ".selector" ).draggable( "enable" ); |
| option( optionName ) | Objekt | Ruft den Wert ab, der derzeit dem angegebenen zugeordnet istoptionNameOption.
Codebeispiele: Methode aufrufen: var isDisabled = $( ".selector" ).draggable( "option", "disabled" ); |
| option() | PlainObject | Ruft ein Objekt ab, das Schlüssel-Wert-Paare enthält, die den aktuellen draggable-Options-Hash repräsentieren.
Codebeispiele: Methode aufrufen: var options = $( ".selector" ).draggable( "option" ); |
| option( optionName, value ) | jQuery (nur Plugin) | Legt den Wert der draggable-Option fest, die mit dem angegebenenoptionNameOptionsnamen verknüpft ist.
Codebeispiele: Methode aufrufen: $( ".selector" ).draggable( "option", "disabled", true ); |
| option( options ) | jQuery (nur Plugin) | Legt eine oder mehrere Optionen für das draggable fest.
Codebeispiele: Methode aufrufen:
$( ".selector" ).draggable( "option", { disabled: true } );
|
| widget() | jQuery | Gibt einjQueryObjekt, das das draggable-Element enthält.
Codebeispiele: Die widget-Methode aufrufen: var widget = $( ".selector" ).draggable( "widget" ); |
| Ereignisse | Type | Beschreibung |
|---|---|---|
| create( event, ui ) | dragcreate | Wird ausgelöst, wenn das draggable erstellt wird.
Hinweis: Codebeispiele: Initialisiert das draggable mit dem angegebenen create-Callback:
$( ".selector" ).draggable({
create: function( event, ui ) {}
});
Bindet einen Event-Listener an das dragcreate-Ereignis:
$( ".selector" ).on( "dragcreate", function( event, ui ) {} );
|
| drag( event, ui ) | drag | Wird ausgelöst, wenn sich die Maus während des Ziehens bewegt.
Codebeispiele: Initialisiert das draggable mit dem angegebenen drag-Callback:
$( ".selector" ).draggable({
drag: function( event, ui ) {}
});
Bindet einen Event-Listener an das drag-Ereignis:
$( ".selector" ).on( "drag", function( event, ui ) {} );
|
| start( event, ui ) | dragstart | Wird ausgelöst, wenn das Ziehen beginnt.
Codebeispiele: Initialisieren Sie das draggable mit dem angegebenen start-Callback:
$( ".selector" ).draggable({
start: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dragstart-Ereignis:
$( ".selector" ).on( "dragstart", function( event, ui ) {} );
|
| stop( event, ui ) | dragstop | Wird ausgelöst, wenn das Ziehen beendet wird.
Codebeispiele: Initialisieren Sie das draggable mit dem angegebenen stop-Callback:
$( ".selector" ).draggable({
stop: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dragstop-Ereignis:
$( ".selector" ).on( "dragstop", function( event, ui ) {} );
|
Beispiele
Ein einfaches jQuery UI Draggable Widget.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>可拖拽小部件(Draggable Widget)演示</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
<style>
#draggable {
width: 100px;
height: 100px;
background: #ccc;
}
</style>
<script src="//code.jquery.com/jquery-1.10.2.js"></script>
<script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
<div id="draggable">请拖拽我!</div>
<script>
$( "#draggable" ).draggable();
</script>
</body>
</html>
Weitere Erweiterungen