jQuery UI API - リサイズ可能ウィジェット(Resizable Widget)

カテゴリ

インタラクション(Interactions)

使用法

説明:マウスを使用して要素のサイズを変更します。

追加されたバージョン:1.0

依存:

注記:jQuery UI のリサイズ(Resizable)プラグインは、選択された要素をリサイズ可能にします(ドラッグ可能なサイズ変更ハンドルを持つことを意味します)。1つまたは複数のハンドルを指定でき、幅と高さの最小値と最大値も指定できます。

補足説明:このウィジェットは機能的なCSSを必要とします。そうでないと動作しません。カスタムテーマを作成する場合は、ウィジェット固有のCSSファイルを出発点として使用してください。

クイックナビゲーション

オプション メソッド イベント

オプション 型 説明 デフォルト値
alsoResize Selector または jQuery または Element resizable 要素と同期してサイズ変更される1つ以上の要素。

コード例:

指定のalsoResizeオプションで resizable を初期化:

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

初期化後に、alsoResizeオプションを取得または設定:

// getter
var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" );
 
// setter
$( ".selector" ).resizable( "option", "alsoResize", "#mirror" );
    
false
animate Boolean サイズ変更後に最終サイズへアニメーションします。

コード例:

指定のanimateオプションで resizable を初期化:

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

初期化後に、animateオプションを取得または設定:

// getter
var animate = $( ".selector" ).resizable( "option", "animate" );
 
// setter
$( ".selector" ).resizable( "option", "animate", true );
    
false
animateDuration Number または String を使用する場合、animateオプションのアニメーションの持続時間。

複数の型をサポート:

  • Number:ミリ秒単位の持続時間。
  • String:名前付きの持続時間、例:"slow" 或 "fast"。

コード例:

指定のanimateDurationオプションで resizable を初期化:

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

初期化後に、animateDurationオプションを取得または設定:

// getter
var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" );
 
// setter
$( ".selector" ).resizable( "option", "animateDuration", "fast" );
    
"slow"
animateEasing String を使用する場合にanimateオプションで使用するEasings。

コード例:

指定のanimateEasingオプションで resizable を初期化:

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

初期化後に、animateEasingオプションを取得または設定:

// getter
var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" );
 
// setter
$( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" );
    
"swing"
aspectRatio Boolean または Number 要素を特定のアスペクト比に制限するかどうか。

複数の型をサポート:

  • Boolean:に設定すると、true要素は元のアスペクト比を維持します。
  • Number:リサイズ中に要素が特定のアスペクト比を維持するように強制します。

コード例:

指定のaspectRatioオプションで resizable を初期化:

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

初期化後に、aspectRatioオプションを取得または設定:

// getter
var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" );
 
// setter
$( ".selector" ).resizable( "option", "aspectRatio", true );
    
false
autoHide Boolean ユーザーのマウスが要素の上にないときにハンドルを非表示にするかどうか。

コード例:

指定のautoHideオプションで resizable を初期化:

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

初期化後に、autoHideオプションを取得または設定:

// getter
var autoHide = $( ".selector" ).resizable( "option", "autoHide" );
 
// setter
$( ".selector" ).resizable( "option", "autoHide", true );
    
false
cancel Selector 指定された要素からサイズ変更を開始できないようにします。

コード例:

指定のcancelオプションで resizable を初期化:

$( ".selector" ).resizable({ cancel: ".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:リサイズ可能要素は、selector の最初の要素の境界内に含められます。要素が見つからない場合、containment は設定されません。
  • Element:リサイズ可能要素は、要素の境界内に含められます。
  • String:可能な値:"parent"、"document"。

コード例:

指定のcontainmentオプションで resizable を初期化:

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

初期化後に、containmentオプションを取得または設定:

// getter
var containment = $( ".selector" ).resizable( "option", "containment" );
 
// setter
$( ".selector" ).resizable( "option", "containment", "parent" );
    
false
delay Number マウスを押してからリサイズが始まるまでの時間(ミリ秒単位)。このオプションを指定すると、マウスを押したまま指定時間が経過した後にのみリサイズが始まります。このオプションにより、要素をクリックしたときの不要なリサイズを防ぐことができます。

コード例:

指定のdelayオプションで resizable を初期化:

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

初期化後に、delayオプションを取得または設定:

// getter
var delay = $( ".selector" ).resizable( "option", "delay" );
 
// setter
$( ".selector" ).resizable( "option", "delay", 150 );
    
0
disabled Boolean に設定すると、trueこの resizable は無効になります。

コード例:

指定のdisabledオプションで resizable を初期化:

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

初期化後に、disabledオプションを取得または設定:

// getter
var disabled = $( ".selector" ).resizable( "option", "disabled" );
 
// setter
$( ".selector" ).resizable( "option", "disabled", true );
    
false
distance Number マウスを押してからリサイズが始まるまでに移動しなければならない距離(ピクセル単位)。このオプションを指定すると、マウスが指定された距離を超えて移動した後にのみリサイズが始まります。このオプションにより、要素をクリックしたときの不要なリサイズを防ぐことができます。

コード例:

指定のdistanceオプションで resizable を初期化:

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

初期化後に、distanceオプションを取得または設定:

// getter
var distance = $( ".selector" ).resizable( "option", "distance" );
 
// setter
$( ".selector" ).resizable( "option", "distance", 30 );
    
1
ghost Boolean に設定すると、trueサイズ変更中は半透明のヘルパー要素が表示されます。

コード例:

指定のghostオプションで resizable を初期化:

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

初期化後に、ghostオプションを取得または設定:

// getter
var ghost = $( ".selector" ).resizable( "option", "ghost" );
 
// setter
$( ".selector" ).resizable( "option", "ghost", true );
    
false
grid Array リサイズ可能要素を x および y ピクセルごとのグリッドに揃えます。配列の形式は次のとおりである必要があります:[ x, y ]。

コード例:

指定のgridオプションで resizable を初期化:

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

初期化後に、gridオプションを取得または設定:

// getter
var grid = $( ".selector" ).resizable( "option", "grid" );
 
// setter
$( ".selector" ).resizable( "option", "grid", [ 20, 10 ] );
    
false
handles String または Object リサイズに使用できるハンドル。

複数の型をサポート:

  • String:カンマ区切りのリスト。値は以下のいずれか:n, e, s, w, ne, se, sw, nw, all。必要なハンドルはプラグインによって自動的に生成されます。
  • Object:次のキーをサポート:{ n, e, s, w, ne, se, sw, nw }。指定された値は、ハンドルとして使用する resizable の子要素に一致する jQuery セレクターである必要があります。

注記:独自のハンドルを作成する場合、各ハンドルにはui-resizable-handleclass、または適切なappropriate ui-resizable-{direction}class(例:ui-resizable-s)が必要です。

コード例:

指定のhandlesオプションで resizable を初期化:

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

初期化後に、handlesオプションを取得または設定:

// getter
var handles = $( ".selector" ).resizable( "option", "handles" );
 
// setter
$( ".selector" ).resizable( "option", "handles", "n, e, s, w" );
    
"e, s, se"
helper String サイズ変更ハンドルのドラッグ中にサイズ変更の輪郭を描画するためにヘルパー要素に追加される class 名。サイズ変更が完了すると、元の要素がサイズ変更されます。

コード例:

指定のhelperオプションで resizable を初期化:

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

初期化後に、helperオプションを取得または設定:

// getter
var helper = $( ".selector" ).resizable( "option", "helper" );
 
// setter
$( ".selector" ).resizable( "option", "helper", "resizable-helper" );
    
false
maxHeight Number resizable がリサイズできる最大の高さ。

コード例:

指定のmaxHeightオプションで resizable を初期化:

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

初期化後に、maxHeightオプションを取得または設定:

// getter
var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" );
 
// setter
$( ".selector" ).resizable( "option", "maxHeight", 300 );
    
null
maxWidth Number resizable がリサイズできる最大の幅。

コード例:

指定のmaxWidthオプションで resizable を初期化:

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

初期化後に、maxWidthオプションを取得または設定:

// getter
var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" );
 
// setter
$( ".selector" ).resizable( "option", "maxWidth", 300 );
    
null
minHeight Number resizable がリサイズできる最小の高さ。

コード例:

指定のminHeightオプションで resizable を初期化:

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

初期化後に、取得または設定minHeightオプション:

// getter
var minHeight = $( ".selector" ).resizable( "option", "minHeight" );
 
// setter
$( ".selector" ).resizable( "option", "minHeight", 150 );
    
10
minWidth Number resizable がリサイズ可能な最小幅。

コード例:

指定したオプションを使用してminWidthresizable を初期化します:

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

初期化後、オプションを取得または設定します:minWidthオプション:

// 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値を取得します。
  • optionName
    型:String
    説明:取得するオプションの名前。

コード例:

このメソッドを呼び出します:

var isDisabled = $( ".selector" ).resizable( "option", "disabled" );
    
option() PlainObject 現在の resizable オプションハッシュを表すキーと値のペアを含むオブジェクトを取得します。
  • このメソッドは引数を受け付けません。

コード例:

このメソッドを呼び出します:

var options = $( ".selector" ).resizable( "option" );
    
option( optionName, value ) jQuery (plugin only) 指定されたオプションに関連付けられているoptionNameresizable オプションの値を設定します。
  • optionName
    型:String
    説明:設定するオプションの名前。
  • value
    型:Object
    説明:オプションに設定する値。

コード例:

このメソッドを呼び出します:

$( ".selector" ).resizable( "option", "disabled", true );
    
option( options ) jQuery (plugin only) resizable に 1 つ以上のオプションを設定します。
  • options
    型:Object
    説明:設定する option-value ペア。

コード例:

このメソッドを呼び出します:

$( ".selector" ).resizable( "option", { disabled: true } );
    
widget() jQuery resizable 要素を含むjQueryオブジェクトを返します。
  • このメソッドは引数を受け付けません。

コード例:

widget メソッドを呼び出します:

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

イベント 型 説明
create( event, ui ) resizecreate resizable が作成されたときにトリガーされます。
  • event
    型:Event
  • ui
    型:Object

注:uiオブジェクトは空です。これは、他のイベントとの一貫性を保つために含まれています。

コード例:

指定した create コールバックを使用して resizable を初期化します:

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

resizecreate イベントにイベントリスナーをバインドします:

$( ".selector" ).on( "resizecreate", function( event, ui ) {} );
    
resize( event, ui ) resize リサイズ中にリサイズハンドルがドラッグされたときにトリガーされます。
  • event
    型:Event
  • ui
    型:Object
    • element
      型:jQuery
      説明:リサイズされる要素を表す jQuery オブジェクト。
    • helper
      型:jQuery
      説明:リサイズされるヘルパーを表す jQuery オブジェクト。
    • originalElement
      型:jQuery
      説明:ラップされる前の元の要素を表す jQuery オブジェクト。
    • originalPosition
      型:Object
      説明:リサイズ前の resizable の位置。次のように表されます:{ top, left }。
    • originalSize
      型:Object
      説明:リサイズ前の resizable のサイズ。次のように表されます:{ width, height }。
    • position
      型:Object
      説明:現在の位置。次のように表されます:{ top, left }。
    • size
      型:Object
      説明:現在のサイズ。次のように表されます:{ width, height }。

コード例:

指定した resize コールバックを使用して resizable を初期化します:

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

resize イベントにイベントリスナーをバインドします:

$( ".selector" ).on( "resize", function( event, ui ) {} );
    
start( event, ui ) resizestart リサイズ操作が開始されたときにトリガーされます。
  • event
    型:Event
  • ui
    型:Object
    • element
      型:jQuery
      説明:リサイズされる要素を表す jQuery オブジェクト。
    • helper
      型:jQuery
      説明:リサイズされるヘルパーを表す jQuery オブジェクト。
    • originalElement
      型:jQuery
      説明:ラップされる前の元の要素を表す jQuery オブジェクト。
    • originalPosition
      型:Object
      説明:リサイズ前の resizable の位置。次のように表されます:{ top, left }。
    • originalSize
      型:Object
      説明:リサイズ前の resizable のサイズ。次のように表されます:{ width, height }。
    • position
      型:Object
      説明:現在の位置。次のように表されます:{ top, left }。
    • size
      型:Object
      説明:現在の位置。次のように表されます:{ width, height }。

コード例:

指定した start コールバックを使用して resizable を初期化します:

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

resizestart イベントにイベントリスナーをバインドします:

$( ".selector" ).on( "resizestart", function( event, ui ) {} );
    
stop( event, ui ) resizestop リサイズ操作が停止されたときにトリガーされます。
  • event
    型:Event
  • ui
    型:Object
    • element
      型:jQuery
      説明:リサイズされる要素を表す jQuery オブジェクト。
    • helper
      型:jQuery
      説明:リサイズされるヘルパーを表す jQuery オブジェクト。
    • originalElement
      型:jQuery
      説明:ラップされる前の元の要素を表す jQuery オブジェクト。
    • originalPosition
      型:Object
      説明:リサイズ前の resizable の位置。次のように表されます:{ top, left }。
    • originalSize
      型:Object
      説明:リサイズ前の resizable のサイズ。次のように表されます:{ width, height }。
    • position
      型:Object
      説明:現在の位置。次のように表されます:{ top, left }。
    • size
      型:Object
      説明:現在の位置。次のように表されます:{ width, height }。

コード例:

指定した 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>

その他の拡張機能