artDialog配置參數
名稱 | 類型 | 默認值 | 描述 |
---|---|---|---|
內容 | |||
title | String | '消息' | 標題內容 |
content | String | 'loading..' | 消息內容。 1、如果傳入的是HTMLElement類型,如果是隱藏元素會給其設置display:block以顯示該元素,其他屬性與綁定的事件都會完整保留,對話框關閉后此元素又將恢復原來的display屬性,並且重新插入原文檔所在位置 2、如果沒有設定content的值則會有loading的動畫 |
HTMLElement | |||
按鈕 | |||
ok | Function | null | 確定按鈕回調函數。 函數如果返回false將阻止對話框關閉;函數this指針指向內部api;如果傳入true表示只顯示有關閉功能的按鈕 |
Boolean | |||
cancel | Function | null | 取消按鈕回調函數。 函數如果返回false將阻止對話框關閉;函數this指針指向內部api;如果傳入true表示只顯示有關閉功能的按鈕 對話框標題欄的關閉按鈕其實就是取消按鈕,只不過視覺不同罷了,點擊同樣觸發cancel事件 |
Boolean | |||
okVal | String | '確定' | "確定按鈕"文字 |
cancelVal | String | '取消' | "取消按鈕"文字 |
button | Array | null | 自定義按鈕。 配置參數成員:
name —— 按鈕名稱
callback —— 按下后執行的函數
focus —— 是否聚焦點
disabled —— 是否標記按鈕為不可用狀態(后續可使用擴展方法讓其恢復可用狀態)
示例:
參數如:[{name: '登錄', callback: function () {}}, {name: '取消'}] 。注意點擊按鈕默認會觸發按鈕關閉動作,需要阻止觸發關閉請讓回調函數返回false |
尺寸 | |||
width | Number | 'auto' | 設置消息內容寬度,可以帶單位。一般不需要設置此,對話框框架會自己適應內容。 如果設置為百分值單位,將會以根據瀏覽器可視范圍作為基准,此時如果瀏覽器窗口大小被改變其也會進行相應的調整 |
String | |||
height | Number | 'auto' | 設置消息內容高度,可以帶單位。不建議設置此,而應該讓內容自己撐開高度。 如果設置為百分值單位,將會以根據瀏覽器可視范圍作為基准,此時如果瀏覽器窗口大小被改變其也會進行相應的調整 |
String | |||
位置 | |||
fixed | Boolean | false | 開啟靜止定位。靜止定位是css2.1的一個屬性,它靜止在瀏覽器某個地方不動,也不受滾動條拖動影響。(artDialog支持IE6 fixed) |
follow | HTMLElement | null | 讓對話框依附在指定元素附近。 可傳入元素ID名稱,注意ID名稱需要以“#”號作為前綴 |
String | |||
left | Number | '50%' | 相對於可視區域的X軸的坐標。 可以使用'0%' ~ '100%'作為相對坐標,如果瀏覽器窗口大小被改變其也會進行相應的調整 |
String | |||
top | Number | '38.2%' | 相對於可視區域的Y軸的坐標。 可以使用'0%' ~ '100%'作為相對坐標,如果瀏覽器窗口大小被改變其也會進行相應的調整 |
String | |||
視覺 | |||
lock | Boolean | false | 開啟鎖屏。 中斷用戶對話框之外的交互,用於顯示非常重要的操作/消息,所以不建議頻繁使用它,它會讓操作變得繁瑣 |
background | String | '#000' | 鎖屏遮罩顏色 |
opacity | Number | 0.7 | 鎖屏遮罩透明度 |
icon | String | null | 定義消息圖標。可定義“skins/icons/”目錄下的圖標名作為參數名(不包含后綴名) |
padding | String | '20px 25px' | 內容與邊界填充邊距(即css padding) |
交互 | |||
time | Number | null | 設置對話框顯示時間。以秒為單位 |
resize | Boolean | true | 是否允許用戶調節尺寸 |
drag | Boolean | true | 是否允許用戶拖動位置 |
esc | Boolean | true | 是否允許用戶按Esc鍵關閉對話框 |
高級 | |||
id | String | null | 設定對話框唯一標識。用途: 1、防止重復彈出 2、定義id后可以使用art.dialog.list[youID]獲取擴展方法 |
Number | |||
zIndex | Number | 1987 | 重置全局zIndex初始值。 用來改變對話框疊加高度。比如有時候配合外部浮動層UI組件,但是它們可能默認zIndex沒有artDialog高,導致無法浮動到artDialog之上,這個時候你就可以給對話框指定一個較小的zIndex值。 請注意這是一個會影響到全局的配置,后續出現的對話框疊加高度將重新按此累加。 |
init | Function | null | 對話框彈出后執行的函數 |
close | Function | null | 對話框關閉前執行的函數。函數如果返回false將阻止對話框關閉。 請注意這不是關閉按鈕的回調函數,無論何種方式關閉對話框,close都將執行。 |
show | Boolean | true | 是否顯示對話框 |
擴展方法
名稱 | 描述 | ||
---|---|---|---|
close() | 關閉對話框 | ||
show() | 顯示對話框 | ||
hide() | 隱藏對話框 | ||
title(value) | 寫入標題。無參數則返回標題容器元素 | ||
content(value) | 向消息容器中寫入內容。參數支持字符串、DOM對象,無參數則返回內容容器元素 | ||
button(arguments) | 插入一個自定義按鈕。 配置參數成員:
name —— 按鈕名稱
callback —— 按下后執行的函數
focus —— 是否聚焦點
disabled —— 是否標記按鈕為不可用狀態(后續可使用擴展方法讓其恢復可用狀態)
示例:
button({ name: '登錄', focus: true, callback: function () {} }, { name: '取消' }) |
||
follow(element) | 讓對話框吸附到指定元素附近 | ||
position(left, top) | 重新定位對話框 | ||
size(width, height) | 重新設定對話框大小 | ||
lock() | 鎖屏 | ||
unlock() | 解鎖 | ||
time(val) | 定時關閉(單位秒) |