jQuery UI API - Droppable-Widget
Kategorie
Nutzung
Beschreibung:Erstelle Ziele für draggable-Widgets.
Hinzugefügt in Version:1.0
D:
Hinweise:Das jQuery UI Droppable-Plugin macht ausgewählte Elemente droppable (bedeutet, dass sie das Ablegen akzeptieren, nachdem sie gezogen wurden). Sie können einzeln angeben, welche draggable-Elemente akzeptiert werden.
Schnellnavigation
| Optionen | Methoden | Ereignisse |
|---|---|---|
| Optionen | Type | Beschreibung | Standard |
|---|---|---|---|
| accept | Selector oder Function() | Steuert, welche draggable-Elemente vom Droppable akzeptiert werden können. Unterstützt mehrere Typen:
Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ accept: ".special" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var accept = $( ".selector" ).droppable( "option", "accept" ); // setter $( ".selector" ).droppable( "option", "accept", ".special" ); |
"*" |
| activeClass | String | Wenn angegeben, wird die Klasse dem Droppable hinzugefügt, wenn ein akzeptables Draggable anfängt, gezogen zu werden. Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ activeClass: "ui-state-highlight" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var activeClass = $( ".selector" ).droppable( "option", "activeClass" ); // setter $( ".selector" ).droppable( "option", "activeClass", "ui-state-highlight" ); |
false |
| addClasses | Boolean | Wenn festgelegt auffalse, verhindert,ui-droppabledass die Klasse hinzugefügt wird. Wenn man Hunderte von Elementen aufruft,.droppable()hilft es bei der Leistungsoptimierung.Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ addClasses: false });
Nach der Initialisierung: Abrufen oder Festlegen // getter var addClasses = $( ".selector" ).droppable( "option", "addClasses" ); // setter $( ".selector" ).droppable( "option", "addClasses", false ); |
wahr |
| disabled | Boolean | Wenn festgelegt auftrue, ist das Droppable deaktiviert.Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ disabled: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var disabled = $( ".selector" ).droppable( "option", "disabled" ); // setter $( ".selector" ).droppable( "option", "disabled", true ); |
false |
| greedy | Boolean | Standardmäßig empfängt jedes Droppable das Element, wenn ein Element auf verschachtelte Droppables abgelegt wird. Wenn Sie diese Option jedoch auftrue, erhält das Droppable eines übergeordneten Elements das Element nicht.dropEreignisse werden weiterhin wie gewohnt ausgelöst, aber es wird geprüft,event.targetum zu sehen, welches Droppable das Draggable-Element empfängt.Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ greedy: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var greedy = $( ".selector" ).droppable( "option", "greedy" ); // setter $( ".selector" ).droppable( "option", "greedy", true ); |
false |
| hoverClass | String | Wenn angegeben, wird die Klasse dem Droppable hinzugefügt, wenn ein akzeptables Draggable über dem Droppable ist. Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ hoverClass: "drop-hover" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var hoverClass = $( ".selector" ).droppable( "option", "hoverClass" ); // setter $( ".selector" ).droppable( "option", "hoverClass", "drop-hover" ); |
false |
| 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 Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ scope: "tasks" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var scope = $( ".selector" ).droppable( "option", "scope" ); // setter $( ".selector" ).droppable( "option", "scope", "tasks" ); |
"default" |
| tolerance | String | Gibt den Modus an, der verwendet wird, um zu testen, ob ein Draggable über einem Droppable ist. Mögliche Werte:
Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen
$( ".selector" ).droppable({ tolerance: "fit" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var tolerance = $( ".selector" ).droppable( "option", "tolerance" ); // setter $( ".selector" ).droppable( "option", "tolerance", "fit" ); |
"intersect" |
| Methoden | Gibt zurück | Beschreibung |
|---|---|---|
| destroy() | jQuery (nur Plugin) | Entfernt die Droppable-Funktionalität vollständig. Dadurch wird das Element in seinen Zustand vor der Initialisierung zurückversetzt.
Codebeispiele: Rufen Sie die destroy-Methode auf: $( ".selector" ).droppable( "destroy" ); |
| disable() | jQuery (nur Plugin) | Deaktiviert das Droppable.
Codebeispiele: Rufen Sie die disable-Methode auf: $( ".selector" ).droppable( "disable" ); |
| enable() | jQuery (nur Plugin) | Aktiviert das Droppable.
Codebeispiele: Rufen Sie die enable-Methode auf: $( ".selector" ).droppable( "enable" ); |
| option( optionName ) | Objekt | Ruft den Wert ab, der aktuell dem angegebenen zugeordnet istoptionNameOption.
Codebeispiele: Ruft diese Methode auf: var isDisabled = $( ".selector" ).droppable( "option", "disabled" ); |
| option() | PlainObject | Ruft ein Objekt ab, das Schlüssel/Wert-Paare enthält, die den aktuellen Droppable-Options-Hash repräsentieren.
Codebeispiele: Ruft diese Methode auf: var options = $( ".selector" ).droppable( "option" ); |
| option( optionName, value ) | jQuery (nur Plugin) | Legt den Wert der droppable-Option fest, die mit der angegebenen verknüpft istoptionNameOption.
Codebeispiele: Ruft diese Methode auf: $( ".selector" ).droppable( "option", "disabled", true ); |
| option( options ) | jQuery (nur Plugin) | Legt eine oder mehrere Optionen für das droppable fest.
Codebeispiele: Ruft diese Methode auf:
$( ".selector" ).droppable( "option", { disabled: true } );
|
| widget() | jQuery | Gibt einjQueryObjekt zurück, das das droppable-Element enthält.
Codebeispiele: Die widget-Methode aufrufen: var widget = $( ".selector" ).droppable( "widget" ); |
| Ereignisse | Type | Beschreibung |
|---|---|---|
| activate( event, ui ) | dropactivate | Wird ausgelöst, wenn ein akzeptables draggable zu ziehen beginnt. Diese Option ist nützlich, wenn Sie das droppable "aufleuchten" lassen möchten, wenn darauf abgelegt werden kann.
Codebeispiele: Initialisiert das droppable mit dem angegebenen activate-Callback:
$( ".selector" ).droppable({
activate: function( event, ui ) {}
});
Bindet einen Event-Listener an das dropactivate-Ereignis:
$( ".selector" ).on( "dropactivate", function( event, ui ) {} );
|
| create( event, ui ) | dropcreate | Wird ausgelöst, wenn das Droppable erstellt wird.
Hinweis: Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen create-Callback:
$( ".selector" ).droppable({
create: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dropcreate-Ereignis:
$( ".selector" ).on( "dropcreate", function( event, ui ) {} );
|
| deactivate( event, ui ) | dropdeactivate | Wird ausgelöst, wenn ein akzeptierbares Draggable aufhört zu ziehen.
Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen deactivate-Callback:
$( ".selector" ).droppable({
deactivate: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dropdeactivate-Ereignis:
$( ".selector" ).on( "dropdeactivate", function( event, ui ) {} );
|
| drop( event, ui ) | drop | Wird ausgelöst, wenn ein akzeptierbares Draggable auf das Droppable abgelegt wird (basierend auftoleranceder Option).
Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen Drop-Callback:
$( ".selector" ).droppable({
drop: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das Drop-Ereignis:
$( ".selector" ).on( "drop", function( event, ui ) {} );
|
| out( event, ui ) | dropout | Wird ausgelöst, wenn ein Draggable aus dem Droppable herausgezogen wird (basierend auftoleranceder Option).
Hinweis: Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen Out-Callback:
$( ".selector" ).droppable({
out: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dropout-Ereignis:
$( ".selector" ).on( "dropout", function( event, ui ) {} );
|
| over( event, ui ) | dropover | Wird ausgelöst, wenn ein akzeptables Draggable über das Droppable gezogen wird (basierend auftoleranceder Option).
Codebeispiele: Initialisieren Sie das Droppable mit dem angegebenen Over-Callback:
$( ".selector" ).droppable({
over: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das dropover-Ereignis:
$( ".selector" ).on( "dropover", function( event, ui ) {} );
|
Beispiele
Ein Paar aus ziehbaren und ablegbaren Elementen.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>可放置小部件(Droppable 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;
}
#droppable {
position: absolute;
left: 250px;
top: 0;
width: 125px;
height: 125px;
background: #999;
color: #fff;
padding: 10px;
}
</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="droppable">请放置到这里!</div>
<div id="draggable">请拖拽我!</div>
<script>
$( "#draggable" ).draggable();
$( "#droppable" ).droppable({
drop: function() {
alert( "dropped" );
}
});
</script>
</body>
</html>
Andere Erweiterungen