例を使用して、ツールチップをドキュメントのHTML要素に追加する方法を示します。
注意:
これらのツールチップサンプルをページに配置しても機能しない場合は、別の問題があります。次のようなものを確認する必要があります。
- 含まれるスクリプトの順序
- 削除されたHTML要素を初期化しようとしているかどうかを確認します
- 含まれていないJSファイルのメソッドを呼び出そうとしているのかどうかを確認します
必要な機能を提供するJSファイルを含めているかどうかを確認します(ツールチップだけでなく、ページで使用するコンポーネントも)。
<head>
<link rel="stylesheet" href="/Content/bootstrap.css" />
<link rel="stylesheet" href="/Content/animate.css" />
<link rel="stylesheet" href="/Content/style.css" />
</head>
<body>
... your HTML code ...
<script src="/Scripts/jquery-2.1.1.js"></script>
<script src="/Scripts/bootstrap.min.js"></script>
<script src="/Scripts/app/inspinia.js"></script> <!-- if using INSPINIA -->
... your JavaScript initializers ...
</body>
上記の項目のいずれかが失敗すると、JavaScriptの読み込みや実行が妨げられ(多くの場合そうなります)、すべてが適切に機能し、壊れたままになります。
使用例
たとえば、バッジがあり、ユーザーがバッジにカーソルを合わせたときにツールチップを表示したいとします。
元のHTML:
<span class="badge badge-sm badge-plain">Admin Mode</span>
プレーンブートストラップのツールチップ
HTML要素のツールチップを作成していて、プレーンブートストラップのツールチップを使用している場合は、独自のJavaScriptコードでツールチップ初期化子を呼び出す必要があります。
前
<span class="badge badge-sm badge-plain">Admin Mode</span>
後
<span
class="badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
イニシャライザ
<script>
// Initialize any Tooltip on this page
$(document).ready(function ()
{
$('[data-toggle="tooltip"]').tooltip();
}
);
</script>
ブートストラップテンプレートツールチップ(INSPINIAなど)
ブートストラップテンプレート(INSPINIAなど)を使用している場合は、テンプレート機能をサポートするためのサポートスクリプトを含めます。
<script src="/Scripts/app/inspinia.js" />
INSPINIAの場合、含まれているスクリプトは、ドキュメントの読み込みが完了すると、次のJavaScriptコードを実行することにより、すべてのツールチップを自動的に初期化します。
// Tooltips demo
$('.tooltip-demo').tooltip({
selector: "[data-toggle=tooltip]",
container: "body"
});
このため、INSPINIAスタイルのツールチップを自分で初期化する必要はありません。ただし、要素を特定の方法でフォーマットする必要があります。イニシャライザtooltip-demo
は、class
属性内でHTML要素を探し、tooltip()
メソッドを呼び出して、属性を持つ子要素を初期化しますdata-toggle="tooltip"
定義され。
この例のバッジでは、の外側の要素(<div>
またはなど<span>
)をclass="tooltip-demo"
配置しdata-toggle
、次に、、data-placement
およびtitle
、バッジである要素内に実際のツールチップの、、属性を配置します。上記の元のHTMLを次のように変更します。
前
<span class="badge badge-sm badge-plain">Admin Mode</span>
後
<span class="tooltip-demo">
<span
class="badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
</span>
イニシャライザ
None
内の子要素は <span class="tooltip-demo">
は、ツールチップが適切に準備されていることに。ツールチップが必要な3つの子要素を1つのコンテナに配置できます。
それぞれがツールチップを持つ複数のアイテム
<span class="tooltip-demo">
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="A Tooltip">Text 001</span>
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="Another Tooltip">Text 002</span>
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="Third Tooltip">Text 003</span>
</span>
これの最良の使用法は、class="tooltip-demo"
を、<td>
または最も外側の<div>
またはに追加すること<span>
です。
テンプレート使用中の単純なブートストラップツールチップ
INSPINIAを使用しているが、外部<div>
または<span>
タグを追加してツールチップを作成したくない場合は、テンプレートに干渉することなく標準のブートストラップツールチップを使用できます。この場合、自分でツールチップを初期化する必要があります。ただし、class
ツールチップアイテムを識別するには、属性でカスタム値を使用する必要があり ます。これにより、ツールチップ初期化子がINSPINIAの影響を受ける要素を妨害するのを防ぎます。この例では、次のように使用しますstandalone-tt
。
前
<span class="badge badge-sm badge-plain">Admin Mode</span>
後
<span
class="standalone-tt badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
イニシャライザ
<script>
// Initialize MY standalone tooltips, ignoring INSPINIA-affected elements
$(document).ready(function ()
{
$('.standalone-tt').tooltip();
}
);
</script>