Jqueryui-tooltip
JqueryUI-ツールチップ
jQueryUIのツールチップウィジェットは、ネイティブのツールチップを置き換えます。 このウィジェットは新しいテーマを追加し、カスタマイズを可能にします。 まず、ツールチップが何であるかを理解しましょう。 ツールチップはどの要素にも付けることができます。 ツールチップを表示するには、_title_属性を入力要素に追加するだけで、タイトル属性値がツールチップとして使用されます。 マウスで要素をホバーすると、要素の隣の小さなボックスにタイトル属性が表示されます。
jQueryUIは、ツールチップを表示する任意の要素にツールチップを追加するための* tooltip()*メソッドを提供します。 これは、可視性を切り替えるだけの場合と比較して、ツールチップの表示と非表示を切り替えるフェードアニメーションをデフォルトで提供します。
構文
- tooltip()*メソッドは2つの形式で使用できます-
- link:/jqueryui/jqueryui_tooltip#tooltip_options [$(selector、context).tooltip(options)]メソッド
- link:/jqueryui/jqueryui_tooltip#tooltip_methods [$(selector、context).tooltip( "action"、[params])]メソッド
[tooltip_options]#
$(セレクター、コンテキスト).tooltip(オプション)メソッド
ツールチップ(オプション)オプション
構文
Javascriptオブジェクトを使用して、一度に1つ以上のオプションを提供できます。 提供する複数のオプションがある場合は、次のようにカンマを使用してそれらを分離します-
次の表は、この方法で使用できるさまざまな_オプション_を示しています-
Sr.No. | Option & Description |
---|---|
1 |
このオプションは、ツールチップのコンテンツを表します。 デフォルトでは、その値は* title属性を返す関数*です。 オプション-コンテンツ このオプションは、ツールチップのコンテンツを表します。 デフォルトでは、その値は* title属性を返す関数*です。 これはタイプにすることができます-
構文 |
2 |
このオプションを_true_に設定すると、ツールチップが無効になります。 デフォルトでは、その値は false です。 オプション-無効 このオプションを_true_に設定すると、ツールチップが無効になります。 デフォルトでは、その値は false です。 構文 |
3 |
このオプションは、ツールチップを非表示にするときのアニメーション効果を表します。 デフォルトでは、その値は true です。 オプション-非表示 このオプションは、ツールチップを非表示にするときのアニメーション効果を表します。 デフォルトでは、その値は true です。 これはタイプにすることができます-
構文 |
4 |
このオプションは、ツールチップを表示できるアイテムを示します。 デフォルトでは、その値は [title] です。 オプション-アイテム このオプションは、ツールチップを表示できるアイテムを示します。 デフォルトでは、その値は [title] です。 構文 |
5 |
このオプションは、関連するターゲット要素に対するツールチップの位置を決定します。 デフォルトでは、その値は* title属性を返す関数*です。 可能な値は次のとおりです。my、at、of、collision、using、within. オプション-位置 このオプションは、関連するターゲット要素に対するツールチップの位置を決定します。 デフォルトでは、その値は* title属性を返す関数*です。 可能な値は次のとおりです。my、at、of、collision、using、within. 構文 |
6 |
このオプションは、ツールチップの表示をアニメーション化する方法を表します。 デフォルトでは、その値は true です。 オプション-表示 このオプションは、ツールチップの表示をアニメーション化する方法を表します。 デフォルトでは、その値は true です。 これはタイプにすることができます-
構文 |
7 |
このオプションは、警告やエラーなどのツールチップのツールチップウィジェットに追加できるクラスです。 デフォルトでは、その値は null です。
このオプションは、警告やエラーなどのツールチップのツールチップウィジェットに追加できるクラスです。 デフォルトでは、その値は null です。 構文 |
8 |
このオプションを_true_に設定すると、ツールチップはマウスを追跡/追跡します。 デフォルトでは、その値は false です。 オプション-追跡 このオプションを_true_に設定すると、ツールチップはマウスを追跡/追跡します。 デフォルトでは、その値は false です。 構文 |
次のセクションでは、ツールチップ機能のいくつかの実用例を示します。
デフォルトの機能
次の例は、* tooltip()*メソッドにパラメーターを渡さないツールチップ機能の簡単な例を示しています。
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、上のリンクにカーソルを合わせるか、Tabキーを使用して各要素にフォーカスを移動します。
コンテンツの使用、追跡、および無効化
次の例は、JqueryUIのツールヒント関数での3つの重要なオプション*(a)content(b)track および(c)disabled *の使用法を示しています。
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、最初のボックスのツールチップのコンテンツは、_content_オプションを使用して設定されます。 また、ツールチップがマウスに追従していることもわかります。 2番目の入力ボックスのツールチップは無効になっています。
ポジションの使用
次の例は、JqueryUIのツールヒント関数でオプション position を使用する方法を示しています。
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、ツールチップの位置は入力ボックスの上に設定されています。
[tooltip_methods]#
$(セレクター、コンテキスト).tooltip( "action"、[params])メソッド
_tooltip(action、params)_メソッドは、ツールチップの無効化など、ツールチップ要素に対してアクションを実行できます。 action は最初の引数で文字列として指定され、オプションで、指定されたアクションに基づいて1つ以上の params を提供できます。
'_基本的に、ここでのアクションは何もありませんが、文字列の形で使用できるjQueryメソッドです。_
構文
次の表は、このメソッドのアクションを示しています-
Sr.No. | Action & Description |
---|---|
1 |
このアクションは、ツールチップを閉じます。 このメソッドは引数を取りません。 アクション-close() このアクションは、ツールチップを閉じます。 このメソッドは引数を取りません。 構文 |
2 |
このアクションにより、ツールチップ機能が完全に削除されます。 これにより、要素は初期化前の状態に戻ります。 このメソッドは引数を取りません。 アクション-destroy() このアクションにより、ツールチップ機能が完全に削除されます。 これにより、要素は初期化前の状態に戻ります。 このメソッドは引数を取りません。 構文 |
3 |
このアクションはツールチップを無効にします。 このメソッドは引数を取りません。 アクション-disable() このアクションはツールチップを無効にします。 このメソッドは引数を取りません。 構文 |
4 |
このアクションにより、ツールチップがアクティブになります。 このメソッドは引数を取りません。 アクション-enable() このアクションにより、ツールチップがアクティブになります。 このメソッドは引数を取りません。 構文 |
5 |
このアクションは、プログラムでツールチップを開きます。 このメソッドは引数を取りません。 アクション-open() このアクションは、プログラムでツールチップを開きます。 このメソッドは引数を取りません。 構文 |
6 |
このアクションは、ツールチップの_optionName_に関連付けられた値を取得します。 このメソッドは引数を取りません。 アクション-option(optionName) このアクションは、ツールチップの_optionName_に関連付けられた値を取得します。 このメソッドは引数を取りません。 構文 |
7 |
このアクションは、現在のツールチップオプションハッシュを表すキー/値ペアを含むオブジェクトを取得します。 このメソッドは引数を取りません。 アクション-option() このアクションは、現在のツールチップオプションハッシュを表すキー/値ペアを含むオブジェクトを取得します。 このメソッドは引数を取りません。 構文 |
8 |
このアクションは、指定された_optionName_に関連付けられたツールヒントオプションの値を設定します。 アクション-option(optionName、value) このアクションは、指定された_optionName_に関連付けられたツールヒントオプションの値を設定します。 構文 |
9 |
このアクションは、ツールチップの1つ以上のオプションを設定します。 アクション-オプション(オプション) このアクションは、ツールチップの1つ以上のオプションを設定します。 構文 |
10 |
このアクションは、元の要素を含むjQueryオブジェクトを返します。 このメソッドは引数を取りません。 アクション-ウィジェット() このアクションは、元の要素を含むjQueryオブジェクトを返します。 このメソッドは引数を取りません。 構文 |
例
ここで、上の表のアクションを使用した例を見てみましょう。 次の例は、アクション_disable_および_enable_の使用方法を示しています。
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も表示されるはずです-
上記の例では、_myBtn_ボタンをクリックすると、ツールチップがポップアップ表示されます。
ツールチップ要素のイベント管理
前のセクションで見たツールヒント(オプション)メソッドに加えて、JqueryUIは特定のイベントに対してトリガーされるイベントメソッドを提供します。 これらのイベントメソッドは以下のとおりです-
Sr.No. | Event Method & Description |
---|---|
1 |
ツールチップが作成されたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-create(event、ui) ツールチップが作成されたときにトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 構文 |
2 |
ツールチップが閉じられたときにトリガーされます。 通常、_focusout_または_mouseleave_でトリガーします。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-close(event、ui) ツールチップが閉じられたときにトリガーされます。 通常、_focusout_または_mouseleave_でトリガーします。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 _ui_の可能な値は-
構文 |
3 |
ツールチップが表示または表示されたときにトリガーされます。 通常、_focusin_または_mouseover_でトリガーされます。 ここで、_event_は_Event_型であり、_ui_は_Object_型です。 イベント-open(event、ui) ツールチップが表示または表示されたときにトリガーされます。 通常、_focusin_または_mouseover_でトリガーされます。 _event_は_Event_型であり、_ui_は_Object_型です。_ui_の可能な値は-
構文 |
例
次の例は、ツールチップ機能中のイベントメソッドの使用方法を示しています。 この例は、_open_および_close_イベントの使用を示しています。
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も表示されるはずです-
上記の例では、_Hover over me!_のツールチップはすぐに消えますが、_Hover over me!_のツールチップは1000ミリ秒後に消えます。