jQuery UI API - Droppable-Widget

Kategorie

Interaktionen

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:

  • Selector: Ein Selektor, der angibt, welche draggable-Elemente vom Droppable akzeptiert werden können.
  • Function(): Eine Funktion, die für jedes Draggable auf der Seite aufgerufen wird (das der Funktion als erstes Argument übergeben wird). Wenn das Draggable akzeptiert wird, muss die Funktion zurückgebentrue。

Codebeispiele:

Initialisieren Sie das Droppable mit dem angegebenenacceptoption:

$( ".selector" ).droppable({ accept: ".special" });
    

Nach der Initialisierung: Abrufen oder Festlegenacceptder Option:

// 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 angegebenenactiveClassoption:

$( ".selector" ).droppable({ activeClass: "ui-state-highlight" });
    

Nach der Initialisierung: Abrufen oder FestlegenactiveClassder Option:

// 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 angegebenenaddClassesoption:

$( ".selector" ).droppable({ addClasses: false });
    

Nach der Initialisierung: Abrufen oder FestlegenaddClassesder Option:

// 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 angegebenendisabledoption:

$( ".selector" ).droppable({ disabled: true });
    

Nach der Initialisierung: Abrufen oder Festlegendisabledder Option:

// 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 angegebenengreedyoption:

$( ".selector" ).droppable({ greedy: true });
    

Nach der Initialisierung: Abrufen oder Festlegengreedyder Option:

// 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 angegebenenhoverClassoption:

$( ".selector" ).droppable({ hoverClass: "drop-hover" });
    

Nach der Initialisierung: Abrufen oder FestlegenhoverClassder Option:

// 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 angegebenenscopeoption:

$( ".selector" ).droppable({ scope: "tasks" });
    

Nach der Initialisierung: Abrufen oder Festlegenscopeder Option:

// 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:
  • "fit": Das Draggable überlappt das Droppable vollständig.
  • "intersect": Das Draggable überlappt das Droppable um mindestens 50% in beiden Richtungen.
  • "pointer": Der Mauszeiger überlappt das Droppable.
  • "touch": Das Draggable überlappt das Droppable in beliebigem Ausmaß.

Codebeispiele:

Initialisieren Sie das Droppable mit dem angegebenentoleranceoption:

$( ".selector" ).droppable({ tolerance: "fit" });
    

Nach der Initialisierung: Abrufen oder Festlegentoleranceder Option:

// 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.
  • Diese Methode akzeptiert keine Argumente.

Codebeispiele:

Rufen Sie die destroy-Methode auf:

$( ".selector" ).droppable( "destroy" );
    
disable() jQuery (nur Plugin) Deaktiviert das Droppable.
  • Diese Methode akzeptiert keine Argumente.

Codebeispiele:

Rufen Sie die disable-Methode auf:

$( ".selector" ).droppable( "disable" );
    
enable() jQuery (nur Plugin) Aktiviert das Droppable.
  • Diese Methode akzeptiert keine Argumente.

Codebeispiele:

Rufen Sie die enable-Methode auf:

$( ".selector" ).droppable( "enable" );
    
option( optionName ) Objekt Ruft den Wert ab, der aktuell dem angegebenen zugeordnet istoptionNameOption.
  • optionName
    Typ: String
    Beschreibung: Der Name der Option, die abgerufen werden soll.

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.
  • Diese Methode akzeptiert keine Argumente.

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.
  • optionName
    Typ: String
    Beschreibung: Der Name der Option, die festgelegt werden soll.
  • value
    Typ: Object
    Beschreibung: Der Wert, der für die Option festgelegt werden soll.

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.
  • options
    Typ: Object
    Beschreibung: Die Options-Wert-Paare, die festgelegt werden sollen.

Codebeispiele:

Ruft diese Methode auf:

$( ".selector" ).droppable( "option", { disabled: true } );
    
widget() jQuery Gibt einjQueryObjekt zurück, das das droppable-Element enthält.
  • Diese Methode akzeptiert keine Argumente.

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.
  • event
    Typ: Event
  • ui
    Typ: Object
    • draggable
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das draggable-Element repräsentiert.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den gezogenen Helper repräsentiert.
    • position
      Typ: Object
      Beschreibung: Die aktuelle CSS-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.
    • offset
      Typ: Object
      Beschreibung: Die aktuelle Offset-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.

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.
  • event
    Typ: Event
  • ui
    Typ: Object

Hinweis:uiDas Objekt ist leer; es wird hier aus Gründen der Konsistenz mit anderen Ereignissen aufgeführt.

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.
  • event
    Typ: Event
  • ui
    Typ: Object
    • draggable
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das draggable-Element repräsentiert.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Draggable-Helper repräsentiert.
    • position
      Typ: Object
      Beschreibung: Die aktuelle CSS-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.
    • offset
      Typ: Object
      Beschreibung: Die aktuelle Offset-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.

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).
  • event
    Typ: Event
  • ui
    Typ: Object
    • draggable
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das draggable-Element repräsentiert.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Draggable-Helper repräsentiert.
    • position
      Typ: Object
      Beschreibung: Die aktuelle CSS-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.
    • offset
      Typ: Object
      Beschreibung: Die aktuelle Offset-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.

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).
  • event
    Typ: Event
  • ui
    Typ: Object

Hinweis:uiDas Objekt ist leer; es wird hier aus Gründen der Konsistenz mit anderen Ereignissen aufgeführt.

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).
  • event
    Typ: Event
  • ui
    Typ: Object
    • draggable
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das draggable-Element repräsentiert.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Draggable-Helper repräsentiert.
    • position
      Typ: Object
      Beschreibung: Die aktuelle CSS-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.
    • offset
      Typ: Object
      Beschreibung: Die aktuelle Offset-Position des draggable-Helpers, wie z. B.{ top, left }Objekt.

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