jQuery UI API - Resizable Widget
Kategorie
Nutzung
Beschreibung:Verwenden Sie die Maus, um die Größe eines Elements zu ändern.
Hinzugefügt in Version:1.0
D:
Hinweise:Das jQuery UI Resizable-Plugin macht ausgewählte Elemente größenveränderbar (d. h. sie verfügen über ziehbare Griffe zur Größenänderung). Sie können einen oder mehrere Griffe angeben sowie die minimale und maximale Breite und Höhe.
Zusätzliche Hinweise:Dieses Widget benötigt funktionales CSS, sonst funktioniert es nicht. Wenn Sie ein eigenes Theme erstellen, verwenden Sie die widgetspezifische CSS-Datei als Ausgangspunkt.
Schnellnavigation
| Optionen | Methoden | Ereignisse |
|---|---|---|
| Optionen | Type | Beschreibung | Standard |
|---|---|---|---|
| alsoResize | Selektor oder jQuery oder Element | Ein oder mehrere Elemente, die synchron mit dem größenveränderbaren Element in der Größe geändert werden. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ alsoResize: "#mirror" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" ); // setter $( ".selector" ).resizable( "option", "alsoResize", "#mirror" ); |
false |
| animate | Boolean | Nach der Größenänderung zur endgültigen Größe animieren. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ animate: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var animate = $( ".selector" ).resizable( "option", "animate" ); // setter $( ".selector" ).resizable( "option", "animate", true ); |
false |
| animateDuration | Number oder String | Bei Verwendunganimatedie Option, die Dauer der Animation.Unterstützt mehrere Typen:
Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ animateDuration: "fast" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" ); // setter $( ".selector" ).resizable( "option", "animateDuration", "fast" ); |
"slow" |
| animateEasing | String | Bei Verwendunganimatedie zu verwendende OptionEasings。Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ animateEasing: "easeOutBounce" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" ); // setter $( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" ); |
"swing" |
| aspectRatio | Boolean oder Number | Ob das Element auf ein bestimmtes Seitenverhältnis beschränkt werden soll. Unterstützt mehrere Typen:
Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ aspectRatio: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" ); // setter $( ".selector" ).resizable( "option", "aspectRatio", true ); |
false |
| autoHide | Boolean | Ob die Griffe ausgeblendet werden sollen, wenn sich die Maus des Benutzers nicht über dem Element befindet. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ autoHide: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var autoHide = $( ".selector" ).resizable( "option", "autoHide" ); // setter $( ".selector" ).resizable( "option", "autoHide", true ); |
false |
| Abbruch | Selektor | Verhindert, dass die Größenänderung auf den angegebenen Elementen beginnt. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ cancel: ".cancel" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var cancel = $( ".selector" ).resizable( "option", "cancel" ); // setter $( ".selector" ).resizable( "option", "cancel", ".cancel" ); |
"input, textarea, button, select, option" |
| containment | Selektor oder Element oder String | Beschränkt die Größenänderung auf die Grenzen des angegebenen Elements oder Bereichs. Unterstützt mehrere Typen:
Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ containment: "parent" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var containment = $( ".selector" ).resizable( "option", "containment" ); // setter $( ".selector" ).resizable( "option", "containment", "parent" ); |
false |
| delay | Number | Die Zeit in Millisekunden nach dem Drücken der Maustaste, bis die Größenänderung beginnt. Wenn diese Option angegeben ist, beginnt die Größenänderung erst, nachdem die Maus länger als diese Zeit bewegt wurde. Diese Option kann unnötige Größenänderungen beim Klicken auf ein Element verhindern. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ delay: 150 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var delay = $( ".selector" ).resizable( "option", "delay" ); // setter $( ".selector" ).resizable( "option", "delay", 150 ); |
0 |
| disabled | Boolean | Wenn festgelegt auftrue, ist das Resizable deaktiviert.Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ disabled: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var disabled = $( ".selector" ).resizable( "option", "disabled" ); // setter $( ".selector" ).resizable( "option", "disabled", true ); |
false |
| distance | Number | Die Entfernung in Pixeln, um die die Maus nach dem Drücken der Maustaste bewegt werden muss, bevor die Größenänderung beginnt. Wenn diese Option angegeben ist, beginnt die Größenänderung erst, nachdem die Maus über diese Entfernung hinaus bewegt wurde. Diese Option kann unnötige Größenänderungen beim Klicken auf ein Element verhindern. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ distance: 30 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var distance = $( ".selector" ).resizable( "option", "distance" ); // setter $( ".selector" ).resizable( "option", "distance", 30 ); |
1 |
| ghost | Boolean | Wenn festgelegt auftrue, wird während der Größenänderung ein halbtransparentes Hilfselement angezeigt.Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ ghost: true });
Nach der Initialisierung: Abrufen oder Festlegen // getter var ghost = $( ".selector" ).resizable( "option", "ghost" ); // setter $( ".selector" ).resizable( "option", "ghost", true ); |
false |
| grid | Array | Richtet das größenveränderbare Element an einem Raster aus, in Schritten von x und y Pixeln. Das Array muss die Form haben[ x, y ]。Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ grid: [ 20, 10 ] });
Nach der Initialisierung: Abrufen oder Festlegen // getter var grid = $( ".selector" ).resizable( "option", "grid" ); // setter $( ".selector" ).resizable( "option", "grid", [ 20, 10 ] ); |
false |
| handles | String oder Object | Handles, die zum Ändern der Größe verwendet werden können. Unterstützt mehrere Typen:
Hinweise:Wenn Sie Ihre eigenen Handles erzeugen, muss jedes Handle Folgendes haben: Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ handles: "n, e, s, w" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var handles = $( ".selector" ).resizable( "option", "handles" ); // setter $( ".selector" ).resizable( "option", "handles", "n, e, s, w" ); |
"e, s, se" |
| helper | String | Ein Klassenname, der einem Proxy-Element hinzugefügt wird, das die Größenänderung während des Ziehens eines Resize-Handles umreißt. Sobald die Größenänderung abgeschlossen ist, wird die Größe des ursprünglichen Elements geändert. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ helper: "resizable-helper" });
Nach der Initialisierung: Abrufen oder Festlegen // getter var helper = $( ".selector" ).resizable( "option", "helper" ); // setter $( ".selector" ).resizable( "option", "helper", "resizable-helper" ); |
false |
| maxHeight | Number | Die maximale Höhe, auf die die Größe des Resizable geändert werden kann. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ maxHeight: 300 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" ); // setter $( ".selector" ).resizable( "option", "maxHeight", 300 ); |
null |
| maxWidth | Number | Die maximale Breite, auf die die Größe des Resizable geändert werden kann. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ maxWidth: 300 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" ); // setter $( ".selector" ).resizable( "option", "maxWidth", 300 ); |
null |
| minHeight | Number | Die minimale Höhe, auf die die Größe des Resizable geändert werden kann. Codebeispiel: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ minHeight: 150 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var minHeight = $( ".selector" ).resizable( "option", "minHeight" ); // setter $( ".selector" ).resizable( "option", "minHeight", 150 ); |
10 |
| minWidth | Number | Die minimale Breite, auf die die Größe des Resizable geändert werden kann. Codebeispiele: Initialisieren mit den angegebenen
$( ".selector" ).resizable({ minWidth: 150 });
Nach der Initialisierung: Abrufen oder Festlegen // getter var minWidth = $( ".selector" ).resizable( "option", "minWidth" ); // setter $( ".selector" ).resizable( "option", "minWidth", 150 ); |
10 |
| Methoden | Gibt zurück | Beschreibung |
|---|---|---|
| destroy() | jQuery (nur Plugin) | Entfernt die Resizable-Funktionalität vollständig. Dadurch wird das Element in seinen Zustand vor der Initialisierung zurückversetzt.
Codebeispiele: Rufen Sie die destroy-Methode auf: $( ".selector" ).resizable( "destroy" ); |
| disable() | jQuery (nur Plugin) | Deaktiviert das Resizable.
Codebeispiele: Rufen Sie die disable-Methode auf: $( ".selector" ).resizable( "disable" ); |
| enable() | jQuery (nur Plugin) | Aktiviert das Resizable.
Codebeispiele: Rufen Sie die enable-Methode auf: $( ".selector" ).resizable( "enable" ); |
| option( optionName ) | Objekt | Ruft den Wert ab, der derzeit dem angegebenen zugeordnet istoptionNameOptionsnamen verknüpft ist.
Codebeispiele: Methode aufrufen: var isDisabled = $( ".selector" ).resizable( "option", "disabled" ); |
| option() | PlainObject | Ruft ein Objekt ab, das Schlüssel/Wert-Paare enthält, die den aktuellen Options-Hash des Resizable repräsentieren.
Codebeispiele: Methode aufrufen: var options = $( ".selector" ).resizable( "option" ); |
| option( optionName, value ) | jQuery (nur Plugin) | Legt den Wert der Resizable-Option fest, die der angegebenen zugeordnet istoptionNameOptionsnamen verknüpft ist.
Codebeispiele: Methode aufrufen: $( ".selector" ).resizable( "option", "disabled", true ); |
| option( options ) | jQuery (nur Plugin) | Legt eine oder mehrere Optionen für das Resizable fest.
Codebeispiele: Methode aufrufen:
$( ".selector" ).resizable( "option", { disabled: true } );
|
| widget() | jQuery | Gibt einjQueryjQuery-Objekt, das das Resizable-Element enthält.
Codebeispiele: Die widget-Methode aufrufen: var widget = $( ".selector" ).resizable( "widget" ); |
| Ereignisse | Type | Beschreibung |
|---|---|---|
| create( event, ui ) | resizecreate | Wird ausgelöst, wenn das Resizable erstellt wird.
Hinweis: Codebeispiele: Initialisiert das Resizable mit dem angegebenen create-Callback:
$( ".selector" ).resizable({
create: function( event, ui ) {}
});
Bindet einen Event-Listener an das resizecreate-Ereignis:
$( ".selector" ).on( "resizecreate", function( event, ui ) {} );
|
| resize( event, ui ) | resize | Wird ausgelöst, während die Größenänderungsgriffe während der Größenänderung gezogen werden.
Codebeispiele: Initialisieren Sie das Resizable mit dem angegebenen resize-Callback:
$( ".selector" ).resizable({
resize: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das resize-Ereignis:
$( ".selector" ).on( "resize", function( event, ui ) {} );
|
| start( event, ui ) | resizestart | Wird ausgelöst, wenn der Resize-Vorgang beginnt.
Codebeispiele: Initialisieren Sie das Resizable mit dem angegebenen Start-Callback:
$( ".selector" ).resizable({
start: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das resizestart-Ereignis:
$( ".selector" ).on( "resizestart", function( event, ui ) {} );
|
| stop( event, ui ) | resizestop | Wird ausgelöst, wenn der Resize-Vorgang stoppt.
Codebeispiele: Initialisieren Sie das Resizable mit dem angegebenen Stop-Callback:
$( ".selector" ).resizable({
stop: function( event, ui ) {}
});
Binden Sie einen Event-Listener an das resizestop-Ereignis:
$( ".selector" ).on( "resizestop", function( event, ui ) {} );
|
Beispiele
Ein einfaches jQuery UI Resizable Widget.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>可调整尺寸小部件(Resizable Widget)演示</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
<style>
#resizable {
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="resizable"></div>
<script>
$( "#resizable" ).resizable();
</script>
</body>
</html>
Weitere Erweiterungen