jQuery UI API - Widget Droppable (Droppable Widget)
Categoría
Uso
Descripción:Crea un objetivo para los widgets arrastrables.
Nuevo en la versión:1.0
Dependencias:
Notas:El complemento Droppable de jQuery UI hace que los elementos seleccionados sean droppable (es decir, aceptan que se suelte un elemento sobre ellos después de arrastrarlo). Puede especificar individualmente qué draggable será aceptado.
Navegación rápida
| Opciones | Métodos | Eventos |
|---|---|---|
| Opciones | Tipo | Descripción | Valor por defecto |
|---|---|---|---|
| accept | Selector o Function() | Controla qué elemento draggable (arrastrable) puede ser aceptado por el droppable. Admite múltiples tipos:
Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ accept: ".special" });
Después de la inicialización, obtenga o establezca la // getter var accept = $( ".selector" ).droppable( "option", "accept" ); // setter $( ".selector" ).droppable( "option", "accept", ".special" ); |
"*" |
| activeClass | String | Si se especifica esta opción, cuando un draggable aceptable esté siendo arrastrado, la clase se agregará al droppable. Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ activeClass: "ui-state-highlight" });
Después de la inicialización, obtenga o establezca la // getter var activeClass = $( ".selector" ).droppable( "option", "activeClass" ); // setter $( ".selector" ).droppable( "option", "activeClass", "ui-state-highlight" ); |
false |
| addClasses | Boolean | Si se establece enfalse, se evitará queui-droppablela clase se agregue. Esto, cuando se invoca en cientos de elementos,.droppable()ayuda a optimizar el rendimiento.Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ addClasses: false });
Después de la inicialización, obtenga o establezca la // getter var addClasses = $( ".selector" ).droppable( "option", "addClasses" ); // setter $( ".selector" ).droppable( "option", "addClasses", false ); |
true |
| disabled | Boolean | Si se establece entrue, se deshabilita el droppable.Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ disabled: true });
Después de la inicialización, obtenga o establezca la // getter var disabled = $( ".selector" ).droppable( "option", "disabled" ); // setter $( ".selector" ).droppable( "option", "disabled", true ); |
false |
| greedy | Boolean | De forma predeterminada, cuando un elemento se suelta sobre un droppable anidado, cada droppable recibirá el elemento. Sin embargo, al establecer esta opción entrue, ningún droppable padre podrá recibir el elemento.dropLos eventos se seguirán disparando normalmente, pero se comprobaráevent.targetpara ver qué droppable recibe el elemento draggable.Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ greedy: true });
Después de la inicialización, obtenga o establezca la // getter var greedy = $( ".selector" ).droppable( "option", "greedy" ); // setter $( ".selector" ).droppable( "option", "greedy", true ); |
false |
| hoverClass | String | Si se especifica esta opción, cuando un draggable aceptable se superponga al droppable, la clase se agregará al droppable. Ejemplo de código: Inicialice el droppable con la
$( ".selector" ).droppable({ hoverClass: "drop-hover" });
Después de la inicialización, obtenga o establezca la // getter var hoverClass = $( ".selector" ).droppable( "option", "hoverClass" ); // setter $( ".selector" ).droppable( "option", "hoverClass", "drop-hover" ); |
false |
| scope | String | Se utiliza para agrupar elementos draggable y droppable emparejados, además de laacceptopción del droppable.scopeUn draggable que tenga el mismovalor que el droppable será aceptado por este droppable. Ejemplo de código:
$( ".selector" ).droppable({ scope: "tasks" });
opción especificada: // getter var scope = $( ".selector" ).droppable( "option", "scope" ); // setter $( ".selector" ).droppable( "option", "scope", "tasks" ); |
"default" |
| tolerance | String | opción:
: el draggable se superpone al droppable en cualquier cantidad. Ejemplo de código:
$( ".selector" ).droppable({ tolerance: "fit" });
opción especificada: // getter var tolerance = $( ".selector" ).droppable( "option", "tolerance" ); // setter $( ".selector" ).droppable( "option", "tolerance", "fit" ); |
"intersect" |
| opción: | Métodos | Devuelve |
|---|---|---|
| destroy() | jQuery (plugin only) | Descripción
Este método no acepta ningún argumento. Ejemplo de código: $( ".selector" ).droppable( "destroy" ); |
| disable() | jQuery (plugin only) | Llamar al método destroy:
Este método no acepta ningún argumento. Ejemplo de código: $( ".selector" ).droppable( "disable" ); |
| enable() | jQuery (plugin only) | Llamar al método disable:
Este método no acepta ningún argumento. Ejemplo de código: $( ".selector" ).droppable( "enable" ); |
| option( optionName ) | Object | Llamar al método enable:optionNameObtiene el valor actualmente asociado con la
Descripción: el nombre de la opción que se va a obtener. Ejemplo de código: var isDisabled = $( ".selector" ).droppable( "option", "disabled" ); |
| option() | PlainObject | Llamar a este método:
Este método no acepta ningún argumento. Ejemplo de código: var options = $( ".selector" ).droppable( "option" ); |
| option( optionName, value ) | jQuery (plugin only) | Llamar a este método:optionNameEstablece el valor de la opción droppable asociada con la
Descripción: el valor que se va a establecer para la opción. Ejemplo de código: $( ".selector" ).droppable( "option", "disabled", true ); |
| option( options ) | jQuery (plugin only) | Llamar a este método:
Descripción: pares de opción-valor que se van a establecer. Ejemplo de código:
$( ".selector" ).droppable( "option", { disabled: true } );
|
| widget() | jQuery | Llamar a este método:jQueryDevuelve un
Este método no acepta ningún argumento. Ejemplo de código: var widget = $( ".selector" ).droppable( "widget" ); |
| Llamar al método widget: | Eventos | Tipo |
|---|---|---|
| activate( event, ui ) | dropactivate | Descripción
objeto. Ejemplo de código:
$( ".selector" ).droppable({
activate: function( event, ui ) {}
});
Inicialice el droppable con el callback activate especificado:
$( ".selector" ).on( "dropactivate", function( event, ui ) {} );
|
| create( event, ui ) | dropcreate | Vincule un detector de eventos al evento dropactivate:
Nota: Ejemplo de código: Inicializar un droppable con el callback create especificado:
$( ".selector" ).droppable({
create: function( event, ui ) {}
});
Vincular un detector de eventos al evento dropcreate:
$( ".selector" ).on( "dropcreate", function( event, ui ) {} );
|
| deactivate( event, ui ) | dropdeactivate | Se dispara cuando un draggable aceptable deja de arrastrarse.
Ejemplo de código: Inicializar un droppable con el callback deactivate especificado:
$( ".selector" ).droppable({
deactivate: function( event, ui ) {}
});
Vincular un detector de eventos al evento dropdeactivate:
$( ".selector" ).on( "dropdeactivate", function( event, ui ) {} );
|
| drop( event, ui ) | drop | Se dispara cuando un draggable aceptable se coloca sobre el droppable (según latoleranceopción).
Ejemplo de código: Inicializar un droppable con el callback drop especificado:
$( ".selector" ).droppable({
drop: function( event, ui ) {}
});
Vincular un detector de eventos al evento drop:
$( ".selector" ).on( "drop", function( event, ui ) {} );
|
| out( event, ui ) | dropout | Se dispara cuando un draggable es arrastrado fuera del droppable (según latoleranceopción).
Nota: Ejemplo de código: Inicializar un droppable con el callback out especificado:
$( ".selector" ).droppable({
out: function( event, ui ) {}
});
Vincular un detector de eventos al evento dropout:
$( ".selector" ).on( "dropout", function( event, ui ) {} );
|
| over( event, ui ) | dropover | Se dispara cuando un draggable aceptable es arrastrado sobre el droppable (según latoleranceopción).
Ejemplo de código: Inicializar un droppable con el callback over especificado:
$( ".selector" ).droppable({
over: function( event, ui ) {}
});
Vincular un detector de eventos al evento dropover:
$( ".selector" ).on( "dropover", function( event, ui ) {} );
|
Ejemplos
Un par de elementos draggable y droppable.
<!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>
Otras extensiones