DIV CSS 佈局教程網

jQuery Tools Tooltip 提示框使用說明:屬性、事件與 API 完整整理
編輯:JQuery特效代碼     

jQuery Tools 的 Tooltip 是一款靈活的提示框組件,能為表單欄位、按鈕等元素加上精美的浮動提示。本文透過完整範例,系統性地介紹它的用法、屬性、事件與腳本 API。

HTML 範例

<!DOCTYPE html>
<html>
<head>
<title>jQuery Tools standalone demo</title>
<script src="https://cdn.jquerytools.org/1.2.7/full/jquery.tools.min.js"></script>
<link rel="stylesheet" type="text/css" href="./tooltip-generic.css"/>
<style>
#myform {
border:1px outset #ccc;
background:#fff repeat-x;
padding:20px;
margin:20px auto;
width:350px;
font-size:12px;
-moz-border-radius:4px;
}
#myform h3 {
text-align:center;
margin:0 0 10px 0;
}
#inputs label, #inputs input, #inputs textarea, #inputs select {
display: block;
width: 150px;
float: left;
margin-bottom: 20px;
}
#inputs label {
text-align: right;
width: 75px;
padding-right: 20px;
}
#inputs br {
clear: left;
}
</style>
</head>
<body><form id="myform" action="#">
<h3>Registration Form</h3>
<div id="inputs">
<label for="username">Username</label>
<input id="username" title="Must be at least 8 characters."/>
<br />
<label for="password">Password</label>
<input id="password" type="password" title="Make it hard to guess." />
<br />
<label for="email">Email</label>
<input id="email" title="We won't send you any marketing material." />
<br />
<label for="body">Message</label>
<textarea id="body" title="What's on your mind?"></textarea>
<br />
</div>
<button type="button" title="This button won't do anything">Proceed</button>
</form>
<script>
$(function() {
$("#myform :input").tooltip({
position: "center right",
offset: [-2, 10],
effect: "fade",
opacity: 0.7
});
});
</script>
</body>
</html>

CSS 樣式

/* simple css-based tooltip */
.tooltip {
background-color:#000;
border:1px solid #fff;
padding:10px 15px;
width:200px;
display:none;
color:#fff;
text-align:left;
font-size:12px;
-moz-box-shadow:0 0 10px #000;
-webkit-box-shadow:0 0 10px #000;
}

CSS 並非必要,但若不設定,提示框的外觀會相對樸素。

關鍵程式碼

$("#myform :input").tooltip({
position: "center right",
offset: [-2, 10],
effect: "fade",
tipClass:'tooltip', // 預設值:tooltip
opacity: 0.7
});

最簡單的初始化寫法為 $("#myform :input").tooltip();。

可用屬性

  • cancelDefault(預設 true,1.1.0 起):當提示內容取自觸發元素的 title 屬性時,會移除該屬性以取消瀏覽器預設提示。仍可透過 jQuery 的 data('title') 取得原值。
  • effect(預設 'toggle'):指定顯示與隱藏方式,內建有 toggle(顯示/隱藏)與 fade(淡入淡出)兩種。
  • delay(預設 30):滑鼠離開觸發元素後,提示框仍顯示的時間(毫秒),適合互動式內容。設為 0 則滑鼠一離開即消失。
  • events:設定組態物件,指定不同元素類型顯示與隱藏提示的事件。
  • layout(預設 '<div/>',1.2.0 起):產生提示框的 HTML 版面配置,可自訂為複雜結構,例如加入嵌套 span 作為箭頭佔位。
  • offset(預設 [0, 0]):微調提示框的顯示位置。
  • opacity(預設 1):提示框透明度,0 為全透明,1 為完全顯示,0.4 則為 40% 顯示。
  • position(預設 'top center'):指定提示框位置。
  • predelay(預設 0,1.1.0 起):顯示提示框前的延遲(毫秒),預設無延遲。
  • relative(預設 false,1.1.1 起):預設提示框位置相對於文檔決定,啟用後則相對於父元素。
  • tip:指定單一提示框元素的 jQuery 選擇器,僅在你想為多個觸發元素手動定義同一提示框時有效。
  • tipClass(預設 'tooltip',1.2.0 起):產生提示框元素的 CSS 類名。

事件

  • onBeforeShow:提示框顯示前觸發,第二個參數為要使用的位置物件 {top, left}。
  • onShow:提示框顯示時觸發。
  • onBeforeHide:提示框隱藏前觸發。
  • onHide:提示框隱藏時觸發。

以下範例在提示框顯示時,讓觸發元素緩慢淡變至 0.8 透明度:

$("label").tooltip({
onShow: function() {
this.getTrigger().fadeTo("slow", 0.8);
}
});

事件管理

jQuery 提示框讓你能完全掌控顯示與隱藏的時機,並可為不同元素類型指定不同事件,其預設值如下:

events: {
def: "mouseenter,mouseleave", // 元素的預設顯示/隱藏事件
input: "focus,blur", // 所有 input 元素
widget: "focus mouseenter,blur mouseleave", // select、checkbox、radio、button
tooltip: "mouseenter,mouseleave" // 提示框元素
}

腳本 API

  • show():顯示提示框。
  • hide():隱藏提示框。
  • isShown(fully):回傳布林值,表示提示框是否可見;1.2.0 起可傳入布林參數,確保提示框完全可見時才回傳 true。
  • getTip():以 jQuery 物件返回提示框。
  • getTrigger():以 jQuery 物件返回觸發元素。
  • getConf():返回提示框組態。

內建效果:fade

內建的「淡入淡出」效果有專屬的組態選項:

  • fadeInSpeed(預設 400):顯示提示框時的淡入速度(毫秒)。
  • fadeOutSpeed(預設 200):隱藏提示框時的淡出速度(毫秒)。

掌握以上屬性、事件與 API,便能靈活打造各式精美的提示框互動效果。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved