1. 程式人生 > >jBox 2.3引數列表及關閉方法

jBox 2.3引數列表及關閉方法

關閉方法:window.parent.window.jBox.close();
外掛說明
- jBox
是一款基於 jQuery 的多功能對話方塊外掛,能夠實現網站的整體風格效果,給使用者一個新的視覺享受。
執行環境
-
相容 IE6+、Firefox、Chrome、Safari、Opera 等主流瀏覽器。使用授權
- jBox
永久免費使用,但是必須保留相關的版權資訊。如果有好的建議,可以直接在下面留言。

版本:2.3大小:19.8k下載:點選下載

複製程式碼程式碼如下:


- [
新增] tip方法增加了 opacity 選項,它決定是否顯示隔離層。
- [
新增] 增加了 showScrolling 選項,在顯示jBox視窗時可以隱藏瀏覽器的滾動條。
- [

新增] 多個視窗共存時,點選某個視窗標題時,視窗自動處於最頂層。
- [
調整] id 選項預設改為null,當為null時會自動生成隨機id,一個id只會顯示一個jBox。
- [
調整] loaded 選項增加了個引數h,引數h表示視窗內容的jQuery物件,方便使用者在視窗載入後對內容進行初始化處理。
- [
調整] 把全域性設定放到獨立的js檔案,統一放在目錄 i18n,目前只有jquery.jBox-zh-CN.js。
- [
調整] 按空格鍵可直接執行預設按鈕提交的事件(為保留此功能,按鈕為焦點時不是很好看,但使用者體驗應該優先考慮)。
- [
修復] 修復在IE下多視窗狀態切換時顯示不了的Bug。

使用方法:

複製程式碼程式碼如下:


<script type="text/javascript" src="jBox/jquery-1.4.2.min.js"></script>

<script type="text/javascript"src="jBox/jquery.jBox-2.3.min.js"></script>

<script type="text/javascript"src="jBox/i18n/jquery.jBox-zh-CN.js"></script>

<link type="text/css" rel="stylesheet"href="jBox/Skins/

面板資料夾/jbox.css"/>
//

<link type="text/css" rel="stylesheet"href="jBox/Skins2/
面板資料夾/jbox.css"/>

常見使用問題:
1.
請使用XHTML 1.0標準
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

2.
不想顯示標題?把title設定為null即可,例如: jBox('內容',{ title: null });
3.
不想要按鈕?自定義按鈕?把buttons設定為{}表示不顯示按鈕,例如: jBox('內容', { buttons: {} });自定義按鈕:jBox('內容', { buttons: {'按鈕1':'按鈕1點選返回值','按鈕2':'按鈕2點選返回值'} });還可以設定buttonsFocus要哪個按鈕為預設按鈕,索引從0開始
4.
不顯示隔離層?把opacity設定為0即可,例如: jBox('內容', {opacity: 0 });
5.
視窗自動關閉?把timeout設定為0表示不自動關閉,正數表示多少毫秒後自動關閉,例如3秒後關閉: jBox('內容', { timeout: 3000 });
6.
在不顯示隔離層的情況下,想防止點選按鈕彈出多個一樣的視窗?把id傳進去就可以了,因為一個id只會顯示一個視窗,例如: jBox('內容', { id: 'my-id'});
7.
視窗的高和寬一定要指定值嗎?可以自適應嗎?除了iframe外,其它情況,是可以指定視窗的高和寬是自適應的,例如:jBox('內容', { width: 'auto', height:'auto'});
jbox
的可選引數很多,結合不同的引數可以會有不同的效果,請檢視下面的全域性引數說明(在檔案jquery.jBox-zh-CN.js)。如果你是使用簡體中文,且不想改全域性配置,則不需要載入jquery.jBox-zh-CN.js,因為jquery.jBox-2.3.min.js裡預設的設定和jquery.jBox-zh-CN.js是一樣的,如果只想修改某幾個選項,例如視窗邊框,只需要一行程式碼就可以:jBox.setDefaults({ defaults: { border: 8} });喜歡jBox的朋友別忘了點一下[推薦]哦,3q

複製程式碼程式碼如下:


/* jBox
全域性設定 */
var jBoxConfig = {};

jBoxConfig.defaults = {

id: null, /*
在頁面中的唯一id,如果為null則自動生成隨機id,一個id只會顯示一個jBox */
top: '15%', /*
視窗離頂部的距離,可以是百分比或畫素(如'100px') */
border: 5, /*
視窗的外邊框畫素大小,必須是0以上的整數 */
opacity: 0.1, /*
視窗隔離層的透明度,如果設定為0,則不顯示隔離層 */
timeout: 0, /*
視窗顯示多少毫秒後自動關閉,如果設定為0,則不自動關閉 */
showType: 'fade', /*
視窗顯示的型別,可選值有:show、fade、slide */
showSpeed: 'fast', /*
視窗顯示的速度,可選值有:'slow'、'fast'、表示毫秒的整數 */
showIcon: true, /*
是否顯示視窗標題的圖示,true顯示,false不顯示,或自定義的CSS樣式類名(以為圖示為背景) */
showClose: true, /*
是否顯示視窗右上角的關閉按鈕 */
draggable: true, /*
是否可以拖動視窗 */
dragLimit: true, /*
在可以拖動視窗的情況下,是否限制在可視範圍 */
dragClone: false, /*
在可以拖動視窗的情況下,滑鼠按下時視窗是否克隆視窗 */
persistent: true, /*
在顯示隔離層的情況下,點選隔離層時,是否堅持視窗不關閉 */
showScrolling: true, /*
是否顯示瀏覽的滾動條 */
ajaxData: {}, /*
在視窗內容使用get:或post:字首標識的情況下,ajaxpost的資料,例如:{ id: 1 } 或"id=1" */
iframeScrolling: 'auto', /*
在視窗內容使用iframe:字首標識的情況下,iframe的scrolling屬性值,可選值有:'auto'、'yes'、'no' */
title: 'jBox', /*
視窗的標題 */
width: 350, /*
視窗的寬度,值為'auto'或表示畫素的整數 */
height: 'auto', /*
視窗的高度,值為'auto'或表示畫素的整數 */
bottomText: '', /*
視窗的按鈕左邊的內容,當沒有按鈕時此設定無效 */
buttons: { '
確定':'ok' }, /* 視窗的按鈕 */
buttonsFocus: 0, /*
表示第幾個按鈕為預設按鈕,索引從0開始 */
loaded: function (h) { }, /*
視窗載入完成後執行的函式,需要注意的是,如果是ajax或iframe也是要等載入完http請求才算視窗載入完成,引數h表示視窗內容的jQuery物件 */
submit: function (v, h, f) { return true; }, /*
點選視窗按鈕後的回撥函式,返回true時表示關閉視窗,引數有三個,v表示所點的按鈕的返回值,h表示視窗內容的jQuery物件,f表示視窗內容裡的form表單鍵值 */
closed: function () { } /*
視窗關閉後執行的函式 */
};

jBoxConfig.stateDefaults = {

content: '', /*
狀態的內容,不支援字首標識 */
buttons: { '
確定':'ok' }, /* 狀態的按鈕 */
buttonsFocus: 0, /*
表示第幾個按鈕為預設按鈕,索引從0開始 */
submit: function (v, h, f) { return true; } /*
點選狀態按鈕後的回撥函式,返回true時表示關閉視窗,引數有三個,v表示所點的按鈕的返回值,h表示視窗內容的jQuery物件,f表示視窗內容裡的form表單鍵值 */
};

jBoxConfig.tipDefaults = {

content: '', /*
提示的內容,不支援字首標識 */
icon: 'info', /*
提示的圖示,可選值有'info'、'success'、'warning'、'error'、'loading',預設值為'info',當為'loading'時,timeout值會被設定為0,表示不會自動關閉。 */
top: '40%', /*
提示離頂部的距離,可以是百分比或畫素(如'100px') */
width: 'auto', /*
提示的高度,值為'auto'或表示畫素的整數 */
height: 'auto', /*
提示的高度,值為'auto'或表示畫素的整數 */
opacity: 0, /*
視窗隔離層的透明度,如果設定為0,則不顯示隔離層 */
timeout: 3000, /*
提示顯示多少毫秒後自動關閉,必須是大於0的整數 */
loaded: function (h) { } /*
視窗載入完成後執行的函式,引數h表示視窗內容的jQuery物件 */
};

jBoxConfig.messagerDefaults = {

content: '', /*
資訊的內容,不支援字首標識 */
title: 'jBox', /*
資訊的標題 */
icon: 'none', /*
資訊圖示,值為'none'時為不顯示圖示,可選值有'none'、'info'、'question'、'success'、'warning'、'error' */
width: 350, /*
資訊的高度,值為'auto'或表示畫素的整數 */
height: 'auto', /*
資訊的高度,值為'auto'或表示畫素的整數 */
timeout: 3000, /*
資訊顯示多少毫秒後自動關閉,如果設定為0,則不自動關閉 */
showType: 'slide', /*
資訊顯示的型別,可選值有:show、fade、slide */
showSpeed: 600, /*
資訊顯示的速度,可選值有:'slow'、'fast'、表示毫秒的整數 */
border: 0, /*
資訊的外邊框畫素大小,必須是0以上的整數 */
buttons: {}, /*
資訊的按鈕 */
buttonsFocus: 0, /*
表示第幾個按鈕為預設按鈕,索引從0開始 */
loaded: function () { }, /*
視窗載入完成後執行的函式 */
submit: function (v, h, f) { return true; }, /*
點選資訊按鈕後的回撥函式,返回true時表示關閉視窗,引數有三個,v表示所點的按鈕的返回值,h表示視窗內容的jQuery物件,f表示視窗內容裡的form表單鍵值 */
loaded: function (h) { } /*
視窗載入完成後執行的函式,引數h表示視窗內容的jQuery物件 */
};

jBoxConfig.languageDefaults = {

close: '
關閉',/* 視窗右上角關閉按鈕提示 */
ok: '
確定', /* $.jBox.prompt()系列方法的“確定”按鈕文字 */
yes: '
是', /* $.jBox.warning()方法的“是”按鈕文字 */
no: '
否', /* $.jBox.warning()方法的“否”按鈕文字 */
cancel: '
取消'/* $.jBox.confirm() 和 $.jBox.warning() 方法的“取消”按鈕文字 */
};

$.jBox.setDefaults(jBoxConfig);