jQuery UI API - Resizable Widget

Kategorie

Interaktionen

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 angegebenenalsoResizeOption des Resizable:

$( ".selector" ).resizable({ alsoResize: "#mirror" });
    

Nach der Initialisierung: Abrufen oder FestlegenalsoResizeder Option:

// 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 angegebenenanimateOption des Resizable:

$( ".selector" ).resizable({ animate: true });
    

Nach der Initialisierung: Abrufen oder Festlegenanimateder Option:

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

  • Number: Dauer in Millisekunden.
  • String: Eine benannte Dauer, wie z. B."slow"oder"fast"。

Codebeispiel:

Initialisieren mit den angegebenenanimateDurationOption des Resizable:

$( ".selector" ).resizable({ animateDuration: "fast" });
    

Nach der Initialisierung: Abrufen oder FestlegenanimateDurationder Option:

// 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 angegebenenanimateEasingOption des Resizable:

$( ".selector" ).resizable({ animateEasing: "easeOutBounce" });
    

Nach der Initialisierung: Abrufen oder FestlegenanimateEasingder Option:

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

  • Boolean: Wenn gesetzt auftrue, behält das Element sein ursprüngliches Seitenverhältnis bei.
  • Number: Erzwingt, dass das Element beim Ändern der Größe ein bestimmtes Seitenverhältnis beibehält.

Codebeispiel:

Initialisieren mit den angegebenenaspectRatioOption des Resizable:

$( ".selector" ).resizable({ aspectRatio: true });
    

Nach der Initialisierung: Abrufen oder FestlegenaspectRatioder Option:

// 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 angegebenenautoHideOption des Resizable:

$( ".selector" ).resizable({ autoHide: true });
    

Nach der Initialisierung: Abrufen oder FestlegenautoHideder Option:

// 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 angegebenencancelOption des Resizable:

$( ".selector" ).resizable({ cancel: ".cancel" });
    

Nach der Initialisierung: Abrufen oder Festlegencancelder Option:

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

  • Selektor: Das größenveränderbare Element wird innerhalb der Grenzen des ersten Elements des Selektors gehalten. Wenn kein Element gefunden wird, wird containment nicht gesetzt.
  • Element: Das größenveränderbare Element wird innerhalb der Grenzen des Elements gehalten.
  • String: Mögliche Werte:"parent"、"document"。

Codebeispiel:

Initialisieren mit den angegebenencontainmentOption des Resizable:

$( ".selector" ).resizable({ containment: "parent" });
    

Nach der Initialisierung: Abrufen oder Festlegencontainmentder Option:

// 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 angegebenendelayOption des Resizable:

$( ".selector" ).resizable({ delay: 150 });
    

Nach der Initialisierung: Abrufen oder Festlegendelayder Option:

// 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 angegebenendisabledOption des Resizable:

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

Nach der Initialisierung: Abrufen oder Festlegendisabledder Option:

// 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 angegebenendistanceOption des Resizable:

$( ".selector" ).resizable({ distance: 30 });
    

Nach der Initialisierung: Abrufen oder Festlegendistanceder Option:

// 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 angegebenenghostOption des Resizable:

$( ".selector" ).resizable({ ghost: true });
    

Nach der Initialisierung: Abrufen oder Festlegenghostder Option:

// 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 angegebenengridOption des Resizable:

$( ".selector" ).resizable({ grid: [ 20, 10 ] });
    

Nach der Initialisierung: Abrufen oder Festlegengridder Option:

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

  • String: Eine durch Kommas getrennte Liste beliebiger der folgenden Werte: n, e, s, w, ne, se, sw, nw, all. Die erforderlichen Handles werden automatisch vom Plugin generiert.
  • Object: Unterstützt die folgenden Schlüssel: { n, e, s, w, ne, se, sw, nw }. Jeder angegebene Wert sollte ein jQuery-Selektor sein, der auf ein untergeordnetes Element des Resizable passt, das als Handle verwendet werden soll.

Hinweise:Wenn Sie Ihre eigenen Handles erzeugen, muss jedes Handle Folgendes haben:ui-resizable-handleclass, oder die entsprechendeappropriate ui-resizable-{direction}class, wie ui-resizable-s.

Codebeispiel:

Initialisieren mit den angegebenenhandlesOption des Resizable:

$( ".selector" ).resizable({ handles: "n, e, s, w" });
    

Nach der Initialisierung: Abrufen oder Festlegenhandlesder Option:

// 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 angegebenenhelperOption des Resizable:

$( ".selector" ).resizable({ helper: "resizable-helper" });
    

Nach der Initialisierung: Abrufen oder Festlegenhelperder Option:

// 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 angegebenenmaxHeightOption des Resizable:

$( ".selector" ).resizable({ maxHeight: 300 });
    

Nach der Initialisierung: Abrufen oder FestlegenmaxHeightder Option:

// 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 angegebenenmaxWidthOption des Resizable:

$( ".selector" ).resizable({ maxWidth: 300 });
    

Nach der Initialisierung: Abrufen oder FestlegenmaxWidthder Option:

// 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 angegebenenminHeightOption des Resizable:

$( ".selector" ).resizable({ minHeight: 150 });
    

Nach der Initialisierung: Abrufen oder FestlegenminHeightOptionen:

// 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 angegebenenminWidthOptionen für das Resizable:

$( ".selector" ).resizable({ minWidth: 150 });
    

Nach der Initialisierung: Abrufen oder FestlegenminWidthOptionen:

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

Codebeispiele:

Rufen Sie die destroy-Methode auf:

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

Codebeispiele:

Rufen Sie die disable-Methode auf:

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

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.
  • optionName
    Typ: String
    Beschreibung: Der Name der Option, die abgerufen werden soll.

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

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.
  • 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:

Methode aufrufen:

$( ".selector" ).resizable( "option", "disabled", true );
    
option( options ) jQuery (nur Plugin) Legt eine oder mehrere Optionen für das Resizable fest.
  • options
    Typ: Object
    Beschreibung: Die Options-Wert-Paare, die festgelegt werden sollen.

Codebeispiele:

Methode aufrufen:

$( ".selector" ).resizable( "option", { disabled: true } );
    
widget() jQuery Gibt einjQueryjQuery-Objekt, das das Resizable-Element enthält.
  • Diese Methode akzeptiert keine Argumente.

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

Hinweis:uiDas Objekt ist leer, wird aber aus Konsistenzgründen mit anderen Ereignissen einbezogen.

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.
  • event
    Typ: Event
  • ui
    Typ: Object
    • element
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das Element repräsentiert, dessen Größe geändert werden soll.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Helfer repräsentiert, dessen Größe geändert wird.
    • originalElement
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das ursprüngliche Element repräsentiert, bevor es umschlossen wird.
    • originalPosition
      Typ: Object
      Beschreibung: Die Position des Resizable vor der Größenänderung, ausgedrückt als{ top, left }。
    • originalSize
      Typ: Object
      Beschreibung: Die Größe des Resizable vor der Größenänderung, ausgedrückt als{ width, height }。
    • position
      Typ: Object
      Beschreibung: Die aktuelle Position, ausgedrückt als{ top, left }。
    • size
      Typ: Object
      Beschreibung: Die aktuelle Größe, ausgedrückt als{ width, height }。

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.
  • event
    Typ: Event
  • ui
    Typ: Object
    • element
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das Element repräsentiert, dessen Größe geändert werden soll.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Helfer repräsentiert, dessen Größe geändert wird.
    • originalElement
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das ursprüngliche Element repräsentiert, bevor es umschlossen wird.
    • originalPosition
      Typ: Object
      Beschreibung: Die Position des Resizable vor der Größenänderung, ausgedrückt als{ top, left }。
    • originalSize
      Typ: Object
      Beschreibung: Die Größe des Resizable vor der Größenänderung, ausgedrückt als{ width, height }。
    • position
      Typ: Object
      Beschreibung: Die aktuelle Position, ausgedrückt als{ top, left }。
    • size
      Typ: Object
      Beschreibung: Die aktuelle Position, ausgedrückt als{ width, height }。

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.
  • event
    Typ: Event
  • ui
    Typ: Object
    • element
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das Element repräsentiert, dessen Größe geändert werden soll.
    • helper
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das den Helfer repräsentiert, dessen Größe geändert wird.
    • originalElement
      Typ: jQuery
      Beschreibung: Ein jQuery-Objekt, das das ursprüngliche Element repräsentiert, bevor es umschlossen wird.
    • originalPosition
      Typ: Object
      Beschreibung: Die Position des Resizable vor der Größenänderung, ausgedrückt als{ top, left }。
    • originalSize
      Typ: Object
      Beschreibung: Die Größe des Resizable vor der Größenänderung, ausgedrückt als{ width, height }。
    • position
      Typ: Object
      Beschreibung: Die aktuelle Position, ausgedrückt als{ top, left }。
    • size
      Typ: Object
      Beschreibung: Die aktuelle Position, ausgedrückt als{ width, height }。

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