jQuery UI API - リサイズ可能ウィジェット(Resizable Widget)
カテゴリ
使用法
説明:マウスを使用して要素のサイズを変更します。
追加されたバージョン:1.0
依存:
注記:jQuery UI のリサイズ(Resizable)プラグインは、選択された要素をリサイズ可能にします(ドラッグ可能なサイズ変更ハンドルを持つことを意味します)。1つまたは複数のハンドルを指定でき、幅と高さの最小値と最大値も指定できます。
補足説明:このウィジェットは機能的なCSSを必要とします。そうでないと動作しません。カスタムテーマを作成する場合は、ウィジェット固有のCSSファイルを出発点として使用してください。
クイックナビゲーション
| オプション | メソッド | イベント |
|---|---|---|
| オプション | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| alsoResize | Selector または jQuery または Element | resizable 要素と同期してサイズ変更される1つ以上の要素。 コード例: 指定の
$( ".selector" ).resizable({ alsoResize: "#mirror" });
初期化後に、 // getter var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" ); // setter $( ".selector" ).resizable( "option", "alsoResize", "#mirror" ); |
false |
| animate | Boolean | サイズ変更後に最終サイズへアニメーションします。 コード例: 指定の
$( ".selector" ).resizable({ animate: true });
初期化後に、 // getter var animate = $( ".selector" ).resizable( "option", "animate" ); // setter $( ".selector" ).resizable( "option", "animate", true ); |
false |
| animateDuration | Number または String | を使用する場合、animateオプションのアニメーションの持続時間。複数の型をサポート:
コード例: 指定の
$( ".selector" ).resizable({ animateDuration: "fast" });
初期化後に、 // getter var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" ); // setter $( ".selector" ).resizable( "option", "animateDuration", "fast" ); |
"slow" |
| animateEasing | String | を使用する場合にanimateオプションで使用するEasings。コード例: 指定の
$( ".selector" ).resizable({ animateEasing: "easeOutBounce" });
初期化後に、 // getter var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" ); // setter $( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" ); |
"swing" |
| aspectRatio | Boolean または Number | 要素を特定のアスペクト比に制限するかどうか。 複数の型をサポート:
コード例: 指定の
$( ".selector" ).resizable({ aspectRatio: true });
初期化後に、 // getter var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" ); // setter $( ".selector" ).resizable( "option", "aspectRatio", true ); |
false |
| autoHide | Boolean | ユーザーのマウスが要素の上にないときにハンドルを非表示にするかどうか。 コード例: 指定の
$( ".selector" ).resizable({ autoHide: true });
初期化後に、 // getter var autoHide = $( ".selector" ).resizable( "option", "autoHide" ); // setter $( ".selector" ).resizable( "option", "autoHide", true ); |
false |
| cancel | Selector | 指定された要素からサイズ変更を開始できないようにします。 コード例: 指定の
$( ".selector" ).resizable({ cancel: ".cancel" });
初期化後に、 // getter var cancel = $( ".selector" ).resizable( "option", "cancel" ); // setter $( ".selector" ).resizable( "option", "cancel", ".cancel" ); |
"input, textarea, button, select, option" |
| containment | Selector または Element または String | 指定された要素または領域の境界内にサイズ変更を制限します。 複数の型をサポート:
コード例: 指定の
$( ".selector" ).resizable({ containment: "parent" });
初期化後に、 // getter var containment = $( ".selector" ).resizable( "option", "containment" ); // setter $( ".selector" ).resizable( "option", "containment", "parent" ); |
false |
| delay | Number | マウスを押してからリサイズが始まるまでの時間(ミリ秒単位)。このオプションを指定すると、マウスを押したまま指定時間が経過した後にのみリサイズが始まります。このオプションにより、要素をクリックしたときの不要なリサイズを防ぐことができます。 コード例: 指定の
$( ".selector" ).resizable({ delay: 150 });
初期化後に、 // getter var delay = $( ".selector" ).resizable( "option", "delay" ); // setter $( ".selector" ).resizable( "option", "delay", 150 ); |
0 |
| disabled | Boolean | に設定すると、trueこの resizable は無効になります。コード例: 指定の
$( ".selector" ).resizable({ disabled: true });
初期化後に、 // getter var disabled = $( ".selector" ).resizable( "option", "disabled" ); // setter $( ".selector" ).resizable( "option", "disabled", true ); |
false |
| distance | Number | マウスを押してからリサイズが始まるまでに移動しなければならない距離(ピクセル単位)。このオプションを指定すると、マウスが指定された距離を超えて移動した後にのみリサイズが始まります。このオプションにより、要素をクリックしたときの不要なリサイズを防ぐことができます。 コード例: 指定の
$( ".selector" ).resizable({ distance: 30 });
初期化後に、 // getter var distance = $( ".selector" ).resizable( "option", "distance" ); // setter $( ".selector" ).resizable( "option", "distance", 30 ); |
1 |
| ghost | Boolean | に設定すると、trueサイズ変更中は半透明のヘルパー要素が表示されます。コード例: 指定の
$( ".selector" ).resizable({ ghost: true });
初期化後に、 // getter var ghost = $( ".selector" ).resizable( "option", "ghost" ); // setter $( ".selector" ).resizable( "option", "ghost", true ); |
false |
| grid | Array | リサイズ可能要素を x および y ピクセルごとのグリッドに揃えます。配列の形式は次のとおりである必要があります:[ x, y ]。コード例: 指定の
$( ".selector" ).resizable({ grid: [ 20, 10 ] });
初期化後に、 // getter var grid = $( ".selector" ).resizable( "option", "grid" ); // setter $( ".selector" ).resizable( "option", "grid", [ 20, 10 ] ); |
false |
| handles | String または Object | リサイズに使用できるハンドル。 複数の型をサポート:
注記:独自のハンドルを作成する場合、各ハンドルには コード例: 指定の
$( ".selector" ).resizable({ handles: "n, e, s, w" });
初期化後に、 // getter var handles = $( ".selector" ).resizable( "option", "handles" ); // setter $( ".selector" ).resizable( "option", "handles", "n, e, s, w" ); |
"e, s, se" |
| helper | String | サイズ変更ハンドルのドラッグ中にサイズ変更の輪郭を描画するためにヘルパー要素に追加される class 名。サイズ変更が完了すると、元の要素がサイズ変更されます。 コード例: 指定の
$( ".selector" ).resizable({ helper: "resizable-helper" });
初期化後に、 // getter var helper = $( ".selector" ).resizable( "option", "helper" ); // setter $( ".selector" ).resizable( "option", "helper", "resizable-helper" ); |
false |
| maxHeight | Number | resizable がリサイズできる最大の高さ。 コード例: 指定の
$( ".selector" ).resizable({ maxHeight: 300 });
初期化後に、 // getter var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" ); // setter $( ".selector" ).resizable( "option", "maxHeight", 300 ); |
null |
| maxWidth | Number | resizable がリサイズできる最大の幅。 コード例: 指定の
$( ".selector" ).resizable({ maxWidth: 300 });
初期化後に、 // getter var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" ); // setter $( ".selector" ).resizable( "option", "maxWidth", 300 ); |
null |
| minHeight | Number | resizable がリサイズできる最小の高さ。 コード例: 指定の
$( ".selector" ).resizable({ minHeight: 150 });
初期化後に、取得または設定 // getter var minHeight = $( ".selector" ).resizable( "option", "minHeight" ); // setter $( ".selector" ).resizable( "option", "minHeight", 150 ); |
10 |
| minWidth | Number | resizable がリサイズ可能な最小幅。 コード例: 指定したオプションを使用して
$( ".selector" ).resizable({ minWidth: 150 });
初期化後、オプションを取得または設定します: // getter var minWidth = $( ".selector" ).resizable( "option", "minWidth" ); // setter $( ".selector" ).resizable( "option", "minWidth", 150 ); |
10 |
| メソッド | 戻り値 | 説明 |
|---|---|---|
| destroy() | jQuery (plugin only) | resizable 機能を完全に削除します。これにより、要素は初期化前の状態に戻ります。
コード例: destroy メソッドを呼び出します: $( ".selector" ).resizable( "destroy" ); |
| disable() | jQuery (plugin only) | resizable を無効にします。
コード例: disable メソッドを呼び出します: $( ".selector" ).resizable( "disable" ); |
| enable() | jQuery (plugin only) | resizable を有効にします。
コード例: enable メソッドを呼び出します: $( ".selector" ).resizable( "enable" ); |
| option( optionName ) | Object | 指定されたオプションに現在関連付けられているoptionName値を取得します。
コード例: このメソッドを呼び出します: var isDisabled = $( ".selector" ).resizable( "option", "disabled" ); |
| option() | PlainObject | 現在の resizable オプションハッシュを表すキーと値のペアを含むオブジェクトを取得します。
コード例: このメソッドを呼び出します: var options = $( ".selector" ).resizable( "option" ); |
| option( optionName, value ) | jQuery (plugin only) | 指定されたオプションに関連付けられているoptionNameresizable オプションの値を設定します。
コード例: このメソッドを呼び出します: $( ".selector" ).resizable( "option", "disabled", true ); |
| option( options ) | jQuery (plugin only) | resizable に 1 つ以上のオプションを設定します。
コード例: このメソッドを呼び出します:
$( ".selector" ).resizable( "option", { disabled: true } );
|
| widget() | jQuery | resizable 要素を含むjQueryオブジェクトを返します。
コード例: widget メソッドを呼び出します: var widget = $( ".selector" ).resizable( "widget" ); |
| イベント | 型 | 説明 |
|---|---|---|
| create( event, ui ) | resizecreate | resizable が作成されたときにトリガーされます。
注: コード例: 指定した create コールバックを使用して resizable を初期化します:
$( ".selector" ).resizable({
create: function( event, ui ) {}
});
resizecreate イベントにイベントリスナーをバインドします:
$( ".selector" ).on( "resizecreate", function( event, ui ) {} );
|
| resize( event, ui ) | resize | リサイズ中にリサイズハンドルがドラッグされたときにトリガーされます。
コード例: 指定した resize コールバックを使用して resizable を初期化します:
$( ".selector" ).resizable({
resize: function( event, ui ) {}
});
resize イベントにイベントリスナーをバインドします:
$( ".selector" ).on( "resize", function( event, ui ) {} );
|
| start( event, ui ) | resizestart | リサイズ操作が開始されたときにトリガーされます。
コード例: 指定した start コールバックを使用して resizable を初期化します:
$( ".selector" ).resizable({
start: function( event, ui ) {}
});
resizestart イベントにイベントリスナーをバインドします:
$( ".selector" ).on( "resizestart", function( event, ui ) {} );
|
| stop( event, ui ) | resizestop | リサイズ操作が停止されたときにトリガーされます。
コード例: 指定した stop コールバックを使用して resizable を初期化します:
$( ".selector" ).resizable({
stop: function( event, ui ) {}
});
resizestop イベントにイベントリスナーをバインドします:
$( ".selector" ).on( "resizestop", function( event, ui ) {} );
|
例
シンプルな 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>
その他の拡張機能