下面就以上配置參數說明描述如下:
屬性 | 默認值 | 描述 |
effect | slideup' |
設置提示框出項和隱藏方式,系統提供提供三種effect:toggle,fade,slideup,當然用戶也可以定制所需的effect。對于系統提供的三種effect,系統也提供了與其對應的配置參數,這里會在下面單獨仔細描述。 |
delay | 30 | 設置鼠標離開觸發提示框的觸發器后提示框顯示時間 |
offset | [0, 0] | 精確的調整提示框的位置,該屬性具體使用將在下面提示框位置說明中詳細描述。 |
opacity | 1 | 設置提示框的透明度,取值為0-1,值越大表示提示框透明度越低,0為完全透明,此時提示框如同不顯示,為1則提示框完全不透明如果背景圖片設置為PNG24圖形格式,則可以設置背景圖片的透明度 |
position | ['top', 'center'] | 初略的設置提示框位置,如需精確控制提示框位置,需配合offset使用,該屬性具體使用將在下面提示框位置說明中詳細描述。 |
tip | 設置存儲提示框信息的頁面元素,tip值格式為jquery選擇器格式.默認情況下,提示框信息存放于觸犯器元素的下一個緊鄰的兄弟節點處,如果該處選擇器選擇的是頁面元素id的話,那么該頁面元素將成為所有觸發器的提示信息;否則,如果選擇器選擇出多個結果,那么,每個觸發器都會找到其后第一個符合的頁面元素作為提示信息.如果沒有的話,就從觸發器父親節點重新檢索。 | |
api | FALSE | 設置當前tooltip所在容器的返回類型類型。如果為false(默認值),以jquery對象返回;否則,以js對象返回。如果存在多個值,返回最后一個值。 |
on |
提示信息出現之前調用該屬性觸發的函數,如果該回調函數返回false,那么就會阻止提示信息顯示。 | |
on |
提示信息顯示后調用該屬性觸發的函數 | |
on |
提示信息顯示后調用該屬性該屬性觸發的函數,如果該回調函數返回false,那么就會阻止提示信息隱藏 | |
on |
提示信息隱藏后調用該屬性該屬性觸發的函數 |
提示框位置說明
提示框位置通過config配置對象的position和offset屬性來設置實現。這兩個屬性都是用js數組進行值存放的。
Position屬性用來設置提示信息相對于它的觸發元素位置。比如說,如果該屬性值為[‘bottom','center'],那么提示信息將會出現在其觸發元素的正下方(垂直位置為下方,水平位置為中間)。下圖能很好的描述觸發元素與提示信息的位置關系:
offset屬性用來進一步精確的調整提示框的位置。比如:[10,-20]表示提示信息向下10px并向左偏移20px。數組的前一個值用于描述提示框距其上邊框向下偏移的值;數組的后一個值 用于描述提示框距其左邊框向右偏移的值。
系統內置effect描述
系統內置的三種effect及其參數設置說明:
toggle:一種簡單的顯示/隱藏效果,這里tooltip沒有提供與之對應的配置參數
fade:一種逐漸顯示/逐漸隱藏的效果,這里tooltip提供了兩個與其對應的配置參數:
fadeInSpeed——默認值為200ms,用于設置提示信息逐漸顯示的速度。
fadeUotSpeed——默認值為200ms,用于設置提示信息逐漸隱藏的速度。
slideup:一種逐漸向上/下滑動的效果,這里tooltip提供了三個與其對應的配置參數:
slideOffset——默認值為10,用于描述提示信息在垂直方向上滑動到距觸發元素的距離,如果為正值,那么就是向上滑動,否則為向下滑動。
slideInSpeed——默認值為200ms。用于設置提示信息滑動顯示的速度(時間)
slideOutSpeed——默認值為200ms。用于設置提示信息滑動消失的速度(時間)
此外,tooltip還提供了一系列獲取tooltip對象的方法,具體實現描述如下: tooltip.onShow=function(){ tooltip.onBeforeHide=function(){ tooltip.onHide=function(){ 下面就以上獲取tooltip對象的方法說明描述如下:
代碼如下:
var tooltip=$("#myform input").tooltip(2);//取第3個tooltip對象
tooltip.show();
tooltip.hide();
//alert(tooltip.isShown());
//alert(tooltip.getTip().html());
//alert(tooltip.getTrigger().next().html());
//alert(tooltip.getConf().effect);
tooltip.onBeforeShow=function()
//alert(this.getTip().html());
}
alert(this.getTip().html());
}
alert(this.getTip().html());
}
alert(this.getTip().html());
}
方法名
返回值
描述
show()
API
顯示提示信息,如果取到多個tooltip對象,默認顯示第一個tooltip對象提示信息
hide()
API
隱藏提示信息
isShown()
boolean
該tooltip對象的提示信息是否處于顯示狀態
getTip()
jQuery
將當前tooltip對象轉換為jquery對象
getTrigger()
jQuery
將當前tooltip的觸發器對象轉換為jquery對象
getConf()
Object
getConf()獲取當前觸發器器配置對象,對于對象內的每個屬性調用只需直接取屬性名即可
on
API
同Config參數配置對象中的on
on
API
同Config參數配置對象中的on
on
API
同Config參數配置對象中的on
on
API
同Config參數配置對象中的on
最后,以jquery tools上幾個demo的截圖為結尾:
聲明:本網頁內容旨在傳播知識,若有侵權等問題請及時與本網聯系,我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com