artDialog配置參數


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) 定時關閉(單位秒)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM