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(オプション)メソッド
ツールチップ(オプション)オプション
構文
$(selector, context).tooltip(options);
Javascriptオブジェクトを使用して、一度に1つ以上のオプションを提供できます。 提供する複数のオプションがある場合は、次のようにカンマを使用してそれらを分離します-
$(selector, context).tooltip({option1: value1, option2: value2..... });
次の表は、この方法で使用できるさまざまな_オプション_を示しています-
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()*メソッドにパラメーターを渡さないツールチップ機能の簡単な例を示しています。
<!doctype html>
<html lang = "en">
<head>
<meta charset = "utf-8">
<title>jQuery UI Tooltip functionality</title>
<link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css"
rel = "stylesheet">
<script src = "https://code.jquery.com/jquery-1.10.2.js"></script>
<script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
<!-- Javascript -->
<script>
$(function() {
$("#tooltip-1").tooltip();
$("#tooltip-2").tooltip();
});
</script>
</head>
<body>
<!-- HTML -->
<label for = "name">Name:</label>
<input id = "tooltip-1" title = "Enter You name">
<p><a id = "tooltip-2" href = "#" title = "Nice tooltip">
I also have a tooltip</a></p>
</body>
</html>
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、上のリンクにカーソルを合わせるか、Tabキーを使用して各要素にフォーカスを移動します。
コンテンツの使用、追跡、および無効化
次の例は、JqueryUIのツールヒント関数での3つの重要なオプション*(a)content(b)track および(c)disabled *の使用法を示しています。
<!doctype html>
<html lang = "en">
<head>
<meta charset = "utf-8">
<title>jQuery UI Tooltip functionality</title>
<link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css"
rel = "stylesheet">
<script src = "https://code.jquery.com/jquery-1.10.2.js"></script>
<script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
<!-- Javascript -->
<script>
$(function() {
$( "#tooltip-3" ).tooltip({
content: "<strong>Hi!</strong>",
track:true
}),
$( "#tooltip-4" ).tooltip({
disabled: true
});
});
</script>
</head>
<body>
<!-- HTML -->
<label for = "name">Message:</label>
<input id = "tooltip-3" title = "tooltip"><br><br><br>
<label for = "name">Tooltip disabled for me:</label>
<input id = "tooltip-4" title = "tooltip">
</body>
</html>
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、最初のボックスのツールチップのコンテンツは、_content_オプションを使用して設定されます。 また、ツールチップがマウスに追従していることもわかります。 2番目の入力ボックスのツールチップは無効になっています。
ポジションの使用
次の例は、JqueryUIのツールヒント関数でオプション position を使用する方法を示しています。
<!doctype html>
<html lang = "en">
<head>
<meta charset = "utf-8">
<title>jQuery UI Tooltip functionality</title>
<link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css"
rel = "stylesheet">
<script src = "https://code.jquery.com/jquery-1.10.2.js"></script>
<script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
<!-- CSS -->
<style>
body {
margin-top: 100px;
}
.ui-tooltip-content::after, .ui-tooltip-content::before {
content: "";
position: absolute;
border-style: solid;
display: block;
left: 90px;
}
.ui-tooltip-content::before {
bottom: -10px;
border-color: #AAA transparent;
border-width: 10px 10px 0;
}
.ui-tooltip-content::after {
bottom: -7px;
border-color: white transparent;
border-width: 10px 10px 0;
}
</style>
<!-- Javascript -->
<script>
$(function() {
$( "#tooltip-7" ).tooltip({
position: {
my: "center bottom",
at: "center top-10",
collision: "none"
}
});
});
</script>
</head>
<body>
<!-- HTML -->
<label for = "name">Enter Date of Birth:</label>
<input id = "tooltip-7" title = "Please use MM.DD.YY format.">
</body>
</html>
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザーで開きます。次の出力も表示されるはずです。 今、あなたは結果で遊ぶことができます-
上記の例では、ツールチップの位置は入力ボックスの上に設定されています。
[tooltip_methods]#
$(セレクター、コンテキスト).tooltip( "action"、[params])メソッド
_tooltip(action、params)_メソッドは、ツールチップの無効化など、ツールチップ要素に対してアクションを実行できます。 action は最初の引数で文字列として指定され、オプションで、指定されたアクションに基づいて1つ以上の params を提供できます。
'_基本的に、ここでのアクションは何もありませんが、文字列の形で使用できるjQueryメソッドです。_
構文
$(selector, context).tooltip ("action", [params]);
次の表は、このメソッドのアクションを示しています-
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_の使用方法を示しています。
<!doctype html>
<html lang = "en">
<head>
<meta charset = "utf-8">
<title>jQuery UI Tooltip functionality</title>
<link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css"
rel = "stylesheet">
<script src = "https://code.jquery.com/jquery-1.10.2.js"></script>
<script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
<!-- Javascript -->
<script>
$(function() {
$("#tooltip-8").tooltip({
//use 'of' to link the tooltip to your specified input
position: { of: '#myInput', my: 'left center', at: 'left center' },
}),
$('#myBtn').click(function () {
$('#tooltip-8').tooltip("open");
});
});
</script>
</head>
<body style = "padding:100px;">
<!-- HTML -->
<a id = "tooltip-8" title = "Message" href = "#"></a>
<input id = "myInput" type = "text" name = "myInput" value = "0" size = "7"/>
<input id = "myBtn" type = "submit" name = "myBtn" value = "myBtn" class = "myBtn"/>
</body>
</html>
上記のコードを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_イベントの使用を示しています。
<!doctype html>
<html lang = "en">
<head>
<meta charset = "utf-8">
<title>jQuery UI Tooltip functionality</title>
<link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css"
rel = "stylesheet">
<script src = "https://code.jquery.com/jquery-1.10.2.js"></script>
<script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
<!-- Javascript -->
<script>
$(function() {
$('.tooltip-9').tooltip({
items: 'a.tooltip-9',
content: 'Hello welcome…',
show: "slideDown",//show immediately
open: function(event, ui) {
ui.tooltip.hover(
function () {
$(this).fadeTo("slow", 0.5);
});
}
});
});
$(function() {
$('.tooltip-10').tooltip({
items: 'a.tooltip-10',
content: 'Welcome to finddevguides…',
show: "fold",
close: function(event, ui) {
ui.tooltip.hover(function() {
$(this).stop(true).fadeTo(500, 1);
},
function() {
$(this).fadeOut('500', function() {
$(this).remove();
});
});
}
});
});
</script>
</head>
<body style = "padding:100px;">
<!-- HTML -->
<div id = "target">
<a href = "#" class = "tooltip-9">Hover over me!</a>
<a href = "#" class = "tooltip-10">Hover over me too!</a>
</div>
</body>
</html>
上記のコードをHTMLファイル tooltipexample に保存して、JavaScriptをサポートする標準のブラウザで開きます。次の出力も表示されるはずです-
上記の例では、_Hover over me!_のツールチップはすぐに消えますが、_Hover over me!_のツールチップは1000ミリ秒後に消えます。