API jQuery UI - Resizable Widget

Catégorie

Interactions

Utilisation

Description :Utilisez la souris pour modifier la taille d'un élément.

添加于版本:1.0

Dépendances :

Remarques :Le plugin Resizable de jQuery UI rend les éléments sélectionnés redimensionnables (ce qui signifie qu'ils ont des poignées de redimensionnement déplaçables). Vous pouvez spécifier une ou plusieurs poignées, ainsi que la largeur et la hauteur minimales et maximales.

Remarques supplémentaires :Ce widget nécessite du CSS fonctionnel, sinon il ne fonctionnera pas. Si vous créez un thème personnalisé, utilisez le fichier CSS spécifique au widget comme point de départ.

Navigation rapide

Options Méthodes Événements

Options Type Description Default
alsoResize Sélecteur ou jQuery ou Element Un ou plusieurs éléments à redimensionner en synchronisation avec l'élément redimensionnable.

Exemple de code :

Initialiser avec lesalsoResizeoption du redimensionnable :

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

Après l'initialisation, obtenir ou définiralsoResizel'option :

// getter
var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" );
 
// setter
$( ".selector" ).resizable( "option", "alsoResize", "#mirror" );
    
false
animer Boolean Après le redimensionnement, animez vers la taille finale.

Exemple de code :

Initialiser avec lesanimateoption du redimensionnable :

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

Après l'initialisation, obtenir ou définiranimatel'option :

// getter
var animate = $( ".selector" ).resizable( "option", "animate" );
 
// setter
$( ".selector" ).resizable( "option", "animate", true );
    
false
animateDuration Nombre ou chaîne de caractères Lors de l'utilisationanimatel'option, la durée de l'animation.

Prend en charge plusieurs types :

  • Nombre: Durée en millisecondes.
  • Chaîne: Une durée nommée, telle que"slow"ou"fast"。

Exemple de code :

Initialiser avec lesanimateDurationoption du redimensionnable :

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

Après l'initialisation, obtenir ou définiranimateDurationl'option :

// getter
var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" );
 
// setter
$( ".selector" ).resizable( "option", "animateDuration", "fast" );
    
"slow"
animateEasing String Lors de l'utilisationanimatel'option à utiliserEasings。

Exemple de code :

Initialiser avec lesanimateEasingoption du redimensionnable :

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

Après l'initialisation, obtenir ou définiranimateEasingl'option :

// getter
var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" );
 
// setter
$( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" );
    
"swing"
aspectRatio Booléen ou Nombre Indique si l'élément doit être contraint à un rapport d'aspect spécifique.

Prend en charge plusieurs types :

  • Boolean: Lorsqu'il est défini surtrue, l'élément conservera son rapport d'aspect d'origine.
  • Nombre: Force l'élément à conserver un rapport d'aspect spécifique pendant le redimensionnement.

Exemple de code :

Initialiser avec lesaspectRatiooption du redimensionnable :

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

Après l'initialisation, obtenir ou définiraspectRatiol'option :

// getter
var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" );
 
// setter
$( ".selector" ).resizable( "option", "aspectRatio", true );
    
false
autoHide Boolean Indique s'il faut masquer les poignées lorsque la souris de l'utilisateur ne survole pas l'élément.

Exemple de code :

Initialiser avec lesautoHideoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirautoHidel'option :

// getter
var autoHide = $( ".selector" ).resizable( "option", "autoHide" );
 
// setter
$( ".selector" ).resizable( "option", "autoHide", true );
    
false
annulation Sélecteur Empêche le redimensionnement de commencer sur les éléments spécifiés.

Exemple de code :

Initialiser avec lescanceloption du redimensionnable :

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

Après l'initialisation, obtenir ou définircancell'option :

// getter
var cancel = $( ".selector" ).resizable( "option", "cancel" );
 
// setter
$( ".selector" ).resizable( "option", "cancel", ".cancel" );
    
"input, textarea, button, select, option"
containment Sélecteur ou Élément ou Chaîne Limiter le redimensionnement aux limites de l'élément ou de la zone spécifiés.

Prend en charge plusieurs types :

  • Sélecteur: L'élément redimensionnable sera contenu dans les limites du premier élément du sélecteur. Si aucun élément n'est trouvé, le confinement n'est pas défini.
  • Élément: L'élément redimensionnable sera contenu dans les limites de l'élément.
  • Chaîne: Valeurs possibles :"parent"、"document"。

Exemple de code :

Initialiser avec lescontainmentoption du redimensionnable :

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

Après l'initialisation, obtenir ou définircontainmentl'option :

// getter
var containment = $( ".selector" ).resizable( "option", "containment" );
 
// setter
$( ".selector" ).resizable( "option", "containment", "parent" );
    
false
delay Number Le délai en millisecondes après un appui de la souris avant que le redimensionnement ne commence. Si cette option est spécifiée, le redimensionnement ne démarre qu'une fois que la souris a été déplacée pendant une durée supérieure à ce délai. Cette option peut éviter un redimensionnement inutile lors d'un clic sur un élément.

Exemple de code :

Initialiser avec lesdelayoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirdelayl'option :

// getter
var delay = $( ".selector" ).resizable( "option", "delay" );
 
// setter
$( ".selector" ).resizable( "option", "delay", 150 );
    
0
disabled Boolean Si défini surtrue, le redimensionnement est désactivé.

Exemple de code :

Initialiser avec lesdisabledoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirdisabledl'option :

// getter
var disabled = $( ".selector" ).resizable( "option", "disabled" );
 
// setter
$( ".selector" ).resizable( "option", "disabled", true );
    
false
distance Number La distance en pixels que la souris doit parcourir après un appui avant que le redimensionnement ne commence. Si cette option est spécifiée, le redimensionnement ne démarre qu'après que la souris a été déplacée au-delà de cette distance. Cette option peut éviter un redimensionnement inutile lors d'un clic sur un élément.

Exemple de code :

Initialiser avec lesdistanceoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirdistancel'option :

// getter
var distance = $( ".selector" ).resizable( "option", "distance" );
 
// setter
$( ".selector" ).resizable( "option", "distance", 30 );
    
1
ghost Boolean Si défini surtrue, un élément d'assistance semi-transparent est affiché pendant le redimensionnement.

Exemple de code :

Initialiser avec lesghostoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirghostl'option :

// getter
var ghost = $( ".selector" ).resizable( "option", "ghost" );
 
// setter
$( ".selector" ).resizable( "option", "ghost", true );
    
false
grid Tableau Aligner l'élément redimensionnable sur une grille, par pas de x et y pixels. Le tableau doit être de la forme[ x, y ]。

Exemple de code :

Initialiser avec lesgridoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirgridl'option :

// getter
var grid = $( ".selector" ).resizable( "option", "grid" );
 
// setter
$( ".selector" ).resizable( "option", "grid", [ 20, 10 ] );
    
false
poignées Chaîne ou Objet Poignées pouvant être utilisées pour le redimensionnement.

Prend en charge plusieurs types :

  • Chaîne: Une liste séparée par des virgules parmi les valeurs suivantes : n, e, s, w, ne, se, sw, nw, all. Les poignées nécessaires sont automatiquement générées par le plugin.
  • Object: Prend en charge les clés suivantes : { n, e, s, w, ne, se, sw, nw }. Toute valeur spécifiée doit être un sélecteur jQuery qui correspond à un élément enfant du redimensionnable à utiliser comme poignée.

Remarques :Lorsque vous générez vos propres poignées, chaque poignée doit avoirui-resizable-handleclasse, ou la classe appropriéeappropriate ui-resizable-{direction}classe, telle que ui-resizable-s.

Exemple de code :

Initialiser avec leshandlesoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirhandlesl'option :

// getter
var handles = $( ".selector" ).resizable( "option", "handles" );
 
// setter
$( ".selector" ).resizable( "option", "handles", "n, e, s, w" );
    
"e, s, se"
helper String Un nom de classe à ajouter à un élément proxy qui dessine les contours du redimensionnement pendant le glissement d'une poignée de redimensionnement. Une fois le redimensionnement terminé, l'élément d'origine est redimensionné.

Exemple de code :

Initialiser avec leshelperoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirhelperl'option :

// getter
var helper = $( ".selector" ).resizable( "option", "helper" );
 
// setter
$( ".selector" ).resizable( "option", "helper", "resizable-helper" );
    
false
maxHeight Number La hauteur maximale à laquelle le redimensionnable peut être redimensionné.

Exemple de code :

Initialiser avec lesmaxHeightoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirmaxHeightl'option :

// getter
var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" );
 
// setter
$( ".selector" ).resizable( "option", "maxHeight", 300 );
    
null
maxWidth Number La largeur maximale à laquelle le redimensionnable peut être redimensionné.

Exemple de code :

Initialiser avec lesmaxWidthoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirmaxWidthl'option :

// getter
var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" );
 
// setter
$( ".selector" ).resizable( "option", "maxWidth", 300 );
    
null
minHeight Number La hauteur minimale à laquelle le redimensionnable peut être redimensionné.

Exemple de code :

Initialiser avec lesminHeightoption du redimensionnable :

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

Après l'initialisation, obtenir ou définirminHeightOptions :

// getter
var minHeight = $( ".selector" ).resizable( "option", "minHeight" );
 
// setter
$( ".selector" ).resizable( "option", "minHeight", 150 );
    
10
minWidth Number La largeur minimale à laquelle le redimensionnable peut être redimensionné.

Exemples de code :

Initialiser avec lesminWidthoptions pour le redimensionnable :

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

Après l'initialisation, obtenir ou définirminWidthoptions spécifiées :

// getter
var minWidth = $( ".selector" ).resizable( "option", "minWidth" );
 
// setter
$( ".selector" ).resizable( "option", "minWidth", 150 );
    
10

Méthodes Renvoie Description
destroy() jQuery (plugin uniquement) Supprime complètement la fonctionnalité resizable. Cela rétablira l'élément dans son état d'avant initialisation.
  • Cette méthode n'accepte aucun argument.

Exemples de code :

Invoquer la méthode destroy :

$( ".selector" ).resizable( "destroy" );
    
disable() jQuery (plugin uniquement) Désactive le resizable.
  • Cette méthode n'accepte aucun argument.

Exemples de code :

Invoquer la méthode disable :

$( ".selector" ).resizable( "disable" );
    
enable() jQuery (plugin uniquement) Active le resizable.
  • Cette méthode n'accepte aucun argument.

Exemples de code :

Invoquer la méthode enable :

$( ".selector" ).resizable( "enable" );
    
option( optionName ) Object Obtient la valeur actuellement associée au paramètre spécifiéoptionNamed'option spécifié.
  • optionName
    Type : String
    Description : Le nom de l'option à obtenir.

Exemples de code :

Invoquez la méthode :

var isDisabled = $( ".selector" ).resizable( "option", "disabled" );
    
option() PlainObject Récupère un objet contenant des paires clé/valeur qui représentent le hash des options actuelles du resizable.
  • Cette méthode n'accepte aucun argument.

Exemples de code :

Invoquez la méthode :

var options = $( ".selector" ).resizable( "option" );
    
option( optionName, value ) jQuery (plugin uniquement) Définit la valeur de l'option resizable associée à l'option spécifiée.optionNamed'option spécifié.
  • optionName
    Type : String
    Description : Le nom de l'option à définir.
  • value
    Type : Object
    Description : La valeur à définir pour l'option.

Exemples de code :

Invoquez la méthode :

$( ".selector" ).resizable( "option", "disabled", true );
    
option( options ) jQuery (plugin uniquement) Définit une ou plusieurs options pour le resizable.
  • options
    Type : Object
    Description : Les paires option-valeur à définir.

Exemples de code :

Invoquez la méthode :

$( ".selector" ).resizable( "option", { disabled: true } );
    
widget() jQuery Renvoie unjQueryObjet jQuery contenant l'élément resizable.
  • Cette méthode n'accepte aucun argument.

Exemples de code :

Invoquez la méthode widget :

var widget = $( ".selector" ).resizable( "widget" );
    

Événements Type Description
create( event, ui ) resizecreate Déclenché lorsque le resizable est créé.
  • event
    Type : Event
  • ui
    Type : Object

Remarque :uiL'objet est vide, mais il est inclus pour assurer la cohérence avec les autres événements.

Exemples de code :

Initialise le resizable avec le callback create spécifié :

$( ".selector" ).resizable({
  create: function( event, ui ) {}
});
    

Lie un écouteur d'événement à l'événement resizecreate :

$( ".selector" ).on( "resizecreate", function( event, ui ) {} );
    
resize( event, ui ) resize Déclenché pendant que les poignées de redimensionnement sont glissées lors du redimensionnement.
  • event
    Type : Event
  • ui
    Type : Object
    • élément
      Type : jQuery
      Description : Un objet jQuery représentant l'élément à redimensionner.
    • helper
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'aide en cours de redimensionnement.
    • originalElement
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'origine avant qu'il ne soit enveloppé.
    • originalPosition
      Type : Object
      Description : La position de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ top, left }。
    • originalSize
      Type : Object
      Description : La taille de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ width, height }。
    • position
      Type : Object
      Description : La position actuelle, exprimée sous la forme{ top, left }。
    • size
      Type : Object
      Description : La taille actuelle, exprimée sous la forme{ width, height }。

Exemples de code :

Initialisez le redimensionnable avec le callback de redimensionnement spécifié :

$( ".selector" ).resizable({
  resize: function( event, ui ) {}
});
    

Liez un écouteur d'événement à l'événement resize :

$( ".selector" ).on( "resize", function( event, ui ) {} );
    
start( event, ui ) resizestart Déclenché lorsque l'opération de redimensionnement commence.
  • event
    Type : Event
  • ui
    Type : Object
    • élément
      Type : jQuery
      Description : Un objet jQuery représentant l'élément à redimensionner.
    • helper
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'aide en cours de redimensionnement.
    • originalElement
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'origine avant qu'il ne soit enveloppé.
    • originalPosition
      Type : Object
      Description : La position de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ top, left }。
    • originalSize
      Type : Object
      Description : La taille de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ width, height }。
    • position
      Type : Object
      Description : La position actuelle, exprimée sous la forme{ top, left }。
    • size
      Type : Object
      Description : La position actuelle, exprimée sous la forme{ width, height }。

Exemples de code :

Initialisez le redimensionnable avec le callback de démarrage spécifié :

$( ".selector" ).resizable({
  start: function( event, ui ) {}
});
    

Liez un écouteur d'événement à l'événement resizestart :

$( ".selector" ).on( "resizestart", function( event, ui ) {} );
    
stop( event, ui ) resizestop Déclenché lorsque l'opération de redimensionnement s'arrête.
  • event
    Type : Event
  • ui
    Type : Object
    • élément
      Type : jQuery
      Description : Un objet jQuery représentant l'élément à redimensionner.
    • helper
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'aide en cours de redimensionnement.
    • originalElement
      Type : jQuery
      Description : Un objet jQuery représentant l'élément d'origine avant qu'il ne soit enveloppé.
    • originalPosition
      Type : Object
      Description : La position de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ top, left }。
    • originalSize
      Type : Object
      Description : La taille de l'élément redimensionnable avant le redimensionnement, exprimée sous la forme{ width, height }。
    • position
      Type : Object
      Description : La position actuelle, exprimée sous la forme{ top, left }。
    • size
      Type : Object
      Description : La position actuelle, exprimée sous la forme{ width, height }。

Exemples de code :

Initialisez le redimensionnable avec le callback d'arrêt spécifié :

$( ".selector" ).resizable({
  stop: function( event, ui ) {}
});
    

Liez un écouteur d'événement à l'événement resizestop :

$( ".selector" ).on( "resizestop", function( event, ui ) {} );
    

Exemples

Un widget Resizable simple de jQuery UI.

<!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>

Autres extensions