Jqueryui-resizable
JqueryUI-サイズ変更可能
jQueryUIは、DOM要素のサイズを変更するresizable()メソッドを提供します。 このメソッドは、要素のサイズ変更を簡単にします。そうしないと、HTMLで時間と大量のコーディングが必要になります。 resizable()メソッドは、サイズを変更するアイテムの右下にアイコンを表示します。
構文
- resizable()*メソッドは2つの形式で使用できます-
- link:/jqueryui/jqueryui_resizable#resizable_options [$(selector、context).resizable(options)]メソッド
- link:/jqueryui/jqueryui_resizable#resizable_methods [$(selector、context).resizable( "action"、params)]メソッド
[resizable_options]#
$(セレクター、コンテキスト).resizable(オプション)メソッド
_resizable(options)_メソッドは、HTML要素のサイズを変更できることを宣言します。 _options_パラメーターは、サイズ変更時に関連する要素の動作を指定するオブジェクトです。
構文
Javascriptオブジェクトの使用時に、1つ以上のオプションを提供できます。 提供する複数のオプションがある場合は、次のようにカンマを使用してそれらを分離します-
次の表は、この方法で使用できるさまざまな_オプション_を示しています-
Sr.No. | Option & Description |
---|---|
1 |
このオプションのタイプは、Selector _、 jQuery_、または任意のDOM _Element_です。 元のオブジェクトのサイズを変更するときにサイズ変更する要素も表します。 デフォルトでは、その値は false です。
このオプションは、Selector _、 jQuery_、または任意のDOM _Element_タイプにすることができます。 元のオブジェクトのサイズを変更するときにサイズ変更する要素も表します。 デフォルトでは、その値は false です。 これはタイプにすることができます-
構文 |
2 |
このオプションを true に設定すると、マウスボタンを放したときにサイズ変更中に視覚効果が有効になります。 デフォルト値は false (効果なし)です。 オプション-アニメーション このオプションを true に設定すると、マウスボタンを放したときにサイズ変更中に視覚効果が有効になります。 デフォルト値は false (効果なし)です。 構文 |
3 |
このオプションは、サイズ変更効果の持続時間(ミリ秒単位)を設定するために使用されます。 このオプションは、 animate オプションが_true_の場合にのみ使用されます。 デフォルトでは、値は "slow" です。
このオプションは、サイズ変更効果の持続時間(ミリ秒単位)を設定するために使用されます。 このオプションは、 animate オプションが_true_の場合にのみ使用されます。 デフォルトでは、値は "slow" です。 これはタイプにすることができます-
構文 |
4 |
このオプションは、 animate オプションを使用するときに適用する_easing_を指定するために使用されます。 デフォルトでは、その値は "swing" です。
このオプションは、 animate オプションを使用するときに適用する_easing_を指定するために使用されます。 デフォルトでは、その値は "swing" です。 イージング関数は、アニメーション内のさまざまなポイントでアニメーションが進行する速度を指定します。 構文 |
5 |
このオプションは、アイテムの縦横比(高さと幅)を維持するかどうかを示すために使用されます。 デフォルトでは、その値は false です。
このオプションは、アイテムの縦横比(高さと幅)を維持するかどうかを示すために使用されます。 デフォルトでは、その値は false です。 これはタイプにすることができます-
構文 |
6 |
このオプションは、マウスがアイテム上にある場合を除き、拡大アイコンまたはハンドルを非表示にするために使用されます。 デフォルトでは、その値は false です。
このオプションは、マウスがアイテム上にある場合を除き、拡大アイコンまたはハンドルを非表示にするために使用されます。 デフォルトでは、その値は false です。 構文 |
7 |
このオプションは、指定された要素のサイズ変更を防ぐために使用されます。 デフォルトでは、その値は input、textarea、button、select、option です。 オプション-キャンセル このオプションは、指定された要素のサイズ変更を防ぐために使用されます。 デフォルトでは、その値は input、textarea、button、select、option です。 構文 |
8 |
このオプションは、指定された要素または領域内の要素のサイズ変更を制限するために使用されます。 デフォルトでは、その値は false です。 オプション-封じ込め このオプションは、指定された要素または領域内の要素のサイズ変更を制限するために使用されます。 デフォルトでは、その値は false です。 これはタイプにすることができます-
構文 |
9 |
このオプションは、許容値または遅延をミリ秒単位で設定するために使用されます。 その後、サイズ変更または移動が開始されます。 デフォルトでは、その値は 0 です。 オプション-遅延 このオプションは、許容値または遅延をミリ秒単位で設定するために使用されます。 その後、サイズ変更または移動が開始されます。 デフォルトでは、その値は 0 です。 構文 |
10 |
このオプションは、_true_に設定されている場合、サイズ変更メカニズムを無効にします。 マウスは、サイズ変更可能(「有効化」)を使用してメカニズムが有効になるまで、要素のサイズを変更しません。 デフォルトでは、その値は false です。 オプション-無効 このオプションは、_true_に設定されている場合、サイズ変更メカニズムを無効にします。 マウスは、サイズ変更可能(「有効化」)を使用してメカニズムが有効になるまで、要素のサイズを変更しません。 デフォルトでは、その値は false です。 構文 |
11 |
このオプションを使用すると、マウスが距離(ピクセル)を移動したときにのみサイズ変更が開始されます。 デフォルトでは、その値は* 1ピクセル*です。 これにより、要素をクリックしたときに意図しないサイズ変更を防ぐことができます。 オプション-距離 このオプションを使用すると、マウスが距離(ピクセル)を移動したときにのみサイズ変更が開始されます。 デフォルトでは、その値は* 1ピクセル*です。 これにより、要素をクリックしたときに意図しないサイズ変更を防ぐことができます。 構文 |
12 |
このオプションを_true_に設定すると、サイズ変更のために半透明のヘルパー要素が表示されます。 このゴーストアイテムは、マウスを離すと削除されます。 デフォルトでは、その値は false です。 オプション-ゴースト このオプションを_true_に設定すると、サイズ変更のために半透明のヘルパー要素が表示されます。 このゴーストアイテムは、マウスを離すと削除されます。 デフォルトでは、その値は false です。 構文 |
13 |
このオプションのタイプは配列[x、y]で、マウスの移動中に要素が水平および垂直に拡大するピクセル数を示します。 デフォルトでは、その値は false です。 オプション-グリッド このオプションのタイプは配列[x、y]で、マウスの移動中に要素が水平および垂直に拡大するピクセル数を示します。 デフォルトでは、その値は false です。 構文 |
14 |
このオプションは、要素のどの側面または角度をサイズ変更できるかを示す文字列です。 デフォルトでは、その値は e、s、se です。 オプション-ハンドル このオプションは、要素のどの側面または角度をサイズ変更できるかを示す文字列です。 可能な値は次のとおりです。4つの辺は_n、e、s、、 w_、4つの角は_ne、se、nw、、 sw_です。 文字_n、e、s、_、および_w_は、4つの基本ポイント(北、南、東、および西)を表します。 デフォルトでは、その値は e、s、se です。 構文 |
15 |
このオプションは、サイズ変更する要素のスタイルを設定するCSSクラスを追加するために使用されます。 要素のサイズが変更されると、新しい<div>要素が作成されます。これは、スケーリングされる要素(ui-resizable-helperクラス)です。 サイズ変更が完了すると、元の要素のサイズが変更され、<div>要素が消えます。 デフォルトでは、その値は false です。 オプション-ヘルパー このオプションは、サイズ変更する要素のスタイルを設定するCSSクラスを追加するために使用されます。 要素のサイズが変更されると、新しい<div>要素が作成されます。これは、スケーリングされる要素(ui-resizable-helperクラス)です。 サイズ変更が完了すると、元の要素のサイズが変更され、<div>要素が消えます。 デフォルトでは、その値は false です。 構文 |
16 |
このオプションは、サイズ変更可能なサイズの最大高さを設定するために使用されます。 デフォルトでは、その値は null です。
このオプションは、サイズ変更可能なサイズの最大高さを設定するために使用されます。 デフォルトでは、その値は null です。 構文 |
17 |
このオプションは、サイズ変更可能なサイズ変更可能な最大幅を設定するために使用されます。 デフォルトでは、その値は null です。
このオプションは、サイズ変更可能なサイズ変更可能な最大幅を設定するために使用されます。 デフォルトでは、その値は null です。 構文 |
18 |
このオプションは、サイズ変更可能なサイズ変更の最小高さを設定するために使用されます。 デフォルトでは、その値は 10 です。
このオプションは、サイズ変更可能なサイズ変更の最小高さを設定するために使用されます。 デフォルトでは、その値は 10 です。 構文 |
19 |
このオプションを使用して、サイズ変更可能なサイズの最小幅を設定します。 デフォルトでは、その値は 10 です。
このオプションを使用して、サイズ変更可能なサイズの最小幅を設定します。 デフォルトでは、その値は 10 です。 これはタイプにすることができます- 構文 |
次のセクションでは、サイズ変更機能のいくつかの実例を示します。
デフォルトの機能
次の例は、* resizable()*メソッドにパラメーターを渡さない、サイズ変更可能な機能の簡単な例を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力が表示されます。 今、あなたは結果で遊ぶことができます-
サイズを変更するには、正方形の境界線をドラッグします。
アニメートとゴーストの使用
次の例は、JqueryUIのサイズ変更関数で2つのオプション animate および ghost を使用する方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
正方形の境界線をドラッグしてサイズを変更し、アニメーションオプションとゴーストオプションの効果を確認します。
包含、minHeight、およびminWidthの使用
次の例は、JqueryUIのサイズ変更関数で3つのオプション containment 、 minHeight および minWidth を使用する方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力が表示されます。 今、あなたは結果で遊ぶことができます-
四角い境界線をドラッグしてサイズを変更します。メインコンテナを超えてサイズを変更することはできません。
遅延、距離、および自動非表示の使用
次の例は、JqueryUIのサイズ変更関数で3つのオプション delay 、 distance および autoHide を使用する方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力が表示されます。 今、あなたは結果で遊ぶことができます-
サイズを変更するには正方形の境界線をドラッグし、あなたがそれに気づくことができます-
- 最初の四角いボックスは、1000msの遅延後にサイズ変更され、
- マウスが40px移動すると、2番目の四角いボックスのサイズが変更されます。
- 3番目の四角いボックスにマウスを合わせると、拡大アイコンが表示されます。
alsoResizeの使用
次の例は、JqueryUIのサイズ変更関数でオプション alsoResize を使用する方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力が表示されます。 今、あなたは結果で遊ぶことができます-
四角形の境界線をドラッグしてサイズを変更すると、2番目の四角形ボックスも最初の四角形ボックスと同じサイズに変更されます。
AspectRatio、Gridの使用
次の例は、JqueryUIのサイズ変更関数でオプション aspectRatio および grid を使用する方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力が表示されます。 今、あなたは結果で遊ぶことができます-
正方形の境界線をドラッグしてサイズを変更します。最初の正方形のボックスは10/3のアスペクト比でサイズ変更され、2番目のボックスは[50,20]のグリッドでサイズ変更されます。
[resizable_methods]#
$(セレクター、コンテキスト).resizable( "action"、params)メソッド
_resizable( "action"、params)_メソッドは、サイズ変更機能の許可または禁止など、サイズ変更可能な要素に対してアクションを実行できます。 アクションは、最初の引数で文字列として指定されます(サイズ変更を防ぐために「無効」など)。 次の表で、渡すことができるアクションを確認してください。
構文
次の表は、このメソッドで使用できるさまざまな_アクション_を示しています-
Sr.No. | Action & Description |
---|---|
1 |
このアクションは、要素のサイズ変更可能な機能を完全に破壊します。 これにより、要素は初期化前の状態に戻ります。 アクション-破壊 このアクションは、要素のサイズ変更可能な機能を完全に破壊します。 これにより、要素は初期化前の状態に戻ります。 このメソッドは引数を取りません。 構文 |
2 |
このアクションは、要素のサイズ変更機能を無効にします。 このメソッドは引数を取りません。 アクション-無効 このアクションは、要素のサイズ変更機能を無効にします。 このメソッドは引数を取りません。 構文 |
3 |
このアクションにより、要素のサイズ変更機能が有効になります。 このメソッドは引数を取りません。 アクション-有効 このアクションにより、要素のサイズ変更機能が有効になります。 このメソッドは引数を取りません。 構文 |
4 |
このアクションは、指定された_optionName_の値を取得します。 このオプションは、サイズ変更可能(オプション)で使用されるオプションの1つに対応します。 アクション-option(optionName) このアクションは、指定された_optionName_の値を取得します。 このオプションは、サイズ変更可能(オプション)で使用されるオプションの1つに対応します。 構文 |
5 |
現在のサイズ変更可能なオプションのハッシュを表すキー/値のペアを含むオブジェクトを取得します。 これは引数を受け入れません。 アクション-option() 現在のサイズ変更可能なオプションのハッシュを表すキー/値のペアを含むオブジェクトを取得します。 これは引数を受け入れません。 構文 |
6 |
このアクションは、指定された_optionName_を使用して、サイズ変更可能なオプションの値を設定します。 このオプションは、サイズ変更可能(オプション)で使用されるオプションの1つに対応します。 アクション-option(optionName、value) このアクションは、指定された_optionName_を使用して、サイズ変更可能なオプションの値を設定します。 このオプションは、サイズ変更可能(オプション)で使用されるオプションの1つに対応します。 構文 |
7 |
このアクションは、サイズ変更可能なオプションを1つ以上設定します。 アクション-オプション(オプション) このアクションは、サイズ変更可能なオプションを1つ以上設定します。 構文 |
8 |
このアクションは、サイズ変更可能な要素を含む_jQuery_オブジェクトを返します。 このメソッドは引数を取りません。 アクション-ウィジェット() このアクションは、サイズ変更可能な要素を含む_jQuery_オブジェクトを返します。 このメソッドは引数を取りません。 構文 |
例
ここで、上の表のアクションを使用した例を見てみましょう。 次の例は、_destroy()_および_disable()_メソッドの使用方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力が表示されます-
最初の四角いボックスは無効になっているためサイズを変更できず、2番目の四角いボックスは破棄されます。
サイズ変更可能な要素のイベント管理
前のセクションで見たサイズ変更可能な(オプション)メソッドに加えて、JqueryUIは特定のイベントに対してトリガーされるイベントメソッドを提供します。 これらのイベントメソッドは以下のとおりです-
Sr.No. | Event Method & Description |
---|---|
1 |
このイベントは、サイズ変更可能な要素が作成されたときにトリガーされます。 イベント-create(event、ui) このイベントは、サイズ変更可能な要素が作成されたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
2 |
このイベントは、サイズ変更可能な要素のハンドラーがドラッグされるとトリガーされます。 イベント-resize(event、ui) このイベントは、サイズ変更可能な要素のハンドラーがドラッグされるとトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
3 |
このイベントは、サイズ変更操作の開始時にトリガーされます。 イベント-start(event、ui) このイベントは、サイズ変更操作の開始時にトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
4 |
このイベントは、サイズ変更操作の最後にトリガーされます。 イベント-停止(イベント、UI) このイベントは、サイズ変更操作の最後にトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
例
次の例は、サイズ変更機能中のイベントメソッドの使用方法を示しています。 この例は、_create_および_resize_イベントの使用方法を示しています。
上記のコードをHTMLファイル resizeexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力が表示されるはずです-
四角いボックスをドラッグすると、サイズ変更イベントで出力が表示されます。