API jQuery UI - Resizable Widget
Catégorie
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 les
$( ".selector" ).resizable({ alsoResize: "#mirror" });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ animate: true });
Après l'initialisation, obtenir ou définir // 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 :
Exemple de code : Initialiser avec les
$( ".selector" ).resizable({ animateDuration: "fast" });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ animateEasing: "easeOutBounce" });
Après l'initialisation, obtenir ou définir // 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 :
Exemple de code : Initialiser avec les
$( ".selector" ).resizable({ aspectRatio: true });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ autoHide: true });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ cancel: ".cancel" });
Après l'initialisation, obtenir ou définir // 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 :
Exemple de code : Initialiser avec les
$( ".selector" ).resizable({ containment: "parent" });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ delay: 150 });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ disabled: true });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ distance: 30 });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ ghost: true });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ grid: [ 20, 10 ] });
Après l'initialisation, obtenir ou définir // 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 :
Remarques :Lorsque vous générez vos propres poignées, chaque poignée doit avoir Exemple de code : Initialiser avec les
$( ".selector" ).resizable({ handles: "n, e, s, w" });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ helper: "resizable-helper" });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ maxHeight: 300 });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ maxWidth: 300 });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ minHeight: 150 });
Après l'initialisation, obtenir ou définir // 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 les
$( ".selector" ).resizable({ minWidth: 150 });
Après l'initialisation, obtenir ou définir // 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.
Exemples de code : Invoquer la méthode destroy : $( ".selector" ).resizable( "destroy" ); |
| disable() | jQuery (plugin uniquement) | Désactive le resizable.
Exemples de code : Invoquer la méthode disable : $( ".selector" ).resizable( "disable" ); |
| enable() | jQuery (plugin uniquement) | Active le resizable.
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é.
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.
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é.
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.
Exemples de code : Invoquez la méthode :
$( ".selector" ).resizable( "option", { disabled: true } );
|
| widget() | jQuery | Renvoie unjQueryObjet jQuery contenant l'élément resizable.
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éé.
Remarque : 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.
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.
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.
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