1
- artDialog
1
+ # artDialog
2
2
=========
3
3
4
4
优雅的web对话框控件
5
5
6
- artDialog 是一个精心设计的对话框控件,它拥有精致的界面与易用的编程接口。
6
+ artDialog 是一个精心设计的对话框控件,它拥有精致的界面与易用的编程接口。
7
+
8
+ ** 演示与文档:**
9
+
10
+ http://aui.github.com/artDialog/
7
11
8
12
## 概述
9
13
10
14
artDialog 是一个精心设计的 web 对话框控件,它继承与延伸了桌面对话框的特性,拥有细致的用户体验与精致的界面。artDialog 基于 LGPL 协议开源,无论是个人还是商业项目都可免费使用。
11
15
12
16
## 特点
13
17
14
- #### 自适应内容尺寸
18
+ #### 1. 自适应内容尺寸
15
19
16
20
对话框采用特殊UI结构,无论使用AJAX异步填充内容还是类似tabs等控件导致内容变化,对话框均可自动自适应内容尺寸。
17
21
18
- #### 智能文本对齐
22
+ #### 2. 智能文本对齐
19
23
20
24
如果设置了对话框宽度(包括用户通过调节把柄改变了尺寸),对话框中的文本会自动居中或者居左对齐,这些都是使用用CSS实现的。
21
25
22
- #### 黄金比例垂直居中
26
+ #### 3. 黄金比例垂直居中
23
27
24
28
对话框默认会采用黄金比例垂直居中弹出,正如网页中重要的内容会被安排在垂直黄金区域一样,这样更舒适。
25
29
26
- #### 可吸附式弹出
30
+ #### 4. 可吸附式弹出
27
31
28
32
宽屏笔记本用户已经逐渐成为主流,很多时候大幅度的移动鼠标操作也是一个麻烦的事情(尤其是使用触控板),artDialog支持设置在onclick事件触发源弹出,以让用户操作更加便捷。
29
33
30
- #### 支持快捷键与默认焦点
34
+ #### 5. 支持快捷键与默认焦点
31
35
32
36
* ESC快捷键默认触发对话框关闭(除非在输入状态)。
33
37
34
- * 若有确定按钮,焦点默认停留在确定按钮上,否则停留在右上角关闭按钮上,这样用户可以通过回车键进行操作。
38
+ * 若有确定按钮,焦点默认停留在确定按钮上,否则停留在右上角关闭按钮上,这样用户可以通过回车键进行操作。
39
+
40
+ * 对话框关闭后焦点将被恢复(只支持jquery版)
41
+
42
+ ### 6. 支持信息无障碍(ARIA)
43
+
44
+ 支持读屏器操作,让盲人能够平等的获取信息
45
+
35
46
36
- ### 友好的API
47
+ ### 7. 友好的API
37
48
38
49
在保持小巧的程序体积之外,artDialog提供了丰富的可选配置与方法。它的API风格统一,简单易用,稍微阅读文档一个示例即可举一反三。
39
50
@@ -43,8 +54,125 @@ artDialog 是一个精心设计的 web 对话框控件,它继承与延伸了
43
54
* 盛大
44
55
* 中国移动
45
56
* 中国电信
46
- * ...
47
-
48
- ## 演示
49
-
50
- http://aui.github.com/artDialog/
57
+ * ...
58
+
59
+ ## 更新记录
60
+
61
+ ### 5.0.3
62
+
63
+ 1. ** 支持信息无障碍(ARIA): 内容描述、键盘操作(焦点管理)**
64
+ 2. 锁屏可限制焦点元素保持在对话框内
65
+
66
+ ### 5.0.2
67
+
68
+ 1. 修复居中可能导致左边框显示不出的问题
69
+ 2. 取消点击遮罩对话框恢复居中的特性
70
+
71
+ ### 5.0.1
72
+
73
+ 1 . 修正重复调用 close 方法出现的错误
74
+ 2 . 修正设定了follow后再使用content()方法导致其居中的问题
75
+
76
+ ### 5.0.0
77
+
78
+ [ 重新回到当初的理念:简单、优雅]
79
+
80
+ 1 . follow 不再支持 String 类型
81
+ 2 . button 参数只支持 Array 类型
82
+ 3 . button name 成员改成 value
83
+ 4 . button 增加 id 成员
84
+ 5 . okVal 参数更名为 okValue, 默认值由 '确定' 改为 'ok'
85
+ 6 . cancelVal 参数更名为 cancelValue, 默认值由 '取消' 改为 'cancel'
86
+ 6 . close 参数更名为 beforeunload
87
+ 7 . init 参数更名为 initialize
88
+ 8 . title 参数默认值由 '消息' 改为 'message'
89
+ 9 . time 参数与方法参数单位由秒改为毫秒
90
+ 10 . hide 参数方法更名为 hidden
91
+ 11 . 内部为皮肤增加动态样式 d-state-visible 类
92
+ 12 . 给遮罩增添样式 d-mask 类
93
+ 13 . background 参数被取消, 由 CSS 文件定义
94
+ 14 . opacity 参数被取消, 由 CSS 文件定义
95
+ 15 . ** 取消拖动特性,改由插件支持**
96
+ 16 . 取消 left 与 top 参数
97
+ 17 . 取消对 ie6 提供 fixed 支持,自动转换为 absolute
98
+ 18 . 取消对 ie6 提供 alpha png 支持
99
+ 19 . 取消对 ie6 提供 select 标签遮盖支持
100
+ 20 . 增加 focus 参数
101
+ 21 . 取消 position 方法
102
+ 22 . 取消对 <script type =" text/dialog " ></script > 的支持
103
+ 23 . ** 取消对 iframe 的支持**
104
+ 24 . title 方法不支持空参数
105
+ 25 . content 方法不支持空参数
106
+ 26 . button 方法的参数不支持数组类型
107
+ 27 . 判断 DOCTYPE, 对 xhtml1.0 以下的页面报告错误
108
+ 28 . 修复 IE8 动态等新内容时没有撑开对话框高度,特意为 ie8 取消 .d-content { display: inline-block }
109
+ 29 . show 参数与方法更名为 visible
110
+
111
+ ### 4.0.0
112
+
113
+ [ 严谨的跨浏览器支持、对框架应用提供强大的api支持]
114
+
115
+ 源码:http://code.google.com/p/artdialog/
116
+
117
+ 1. 修复刷新框架后脚本报错的问题
118
+ 2. 修复异步加载 artDialog.js 导致锁屏无法使用的问题
119
+ 3. 双击遮罩不再直接关闭,而是等同于关闭按钮与取消按钮
120
+ 4. 修复 IE6 在特殊情况下可能因为 fixed 定位出现 body 背景图片异常
121
+ 5. 修复部分皮肤在 firefox7.0 版下,标题栏出现省略号的问题
122
+ 6. 修复 v4.0.5 之后版本在浏览器窗口调节的时候可能出现对话框变形问题
123
+ 7. top 参数黄金比例不再采用单独的关键字,可使用 '38.2%' 表示
124
+ 8. ** 新增 content 扩展方法写入消息后,让对话框以自身为中心放大的特性**
125
+ 9. 增加高亮按钮的样式:确定按钮默认高亮(自定义按钮可使用focus参数高亮)
126
+ 10. 解决IE浏览器按钮字体模糊问题
127
+ 11. jQuery版本最低兼容jQuery 1.3.2
128
+ 12. 新增artDialog 基本版本;它只拥有核心功能,文件只有常规版本的一半大小,可被客户端快速载入
129
+ 13. 精简内嵌事件系统,进一步减少体积(压缩版比上一版本少近了3kb)
130
+ 14. iframeTools: open方法默认不再强制锁屏
131
+ 15. 增强icon参数自由度,不再依赖对话框样式文件定义。可存入任意图标到“skins/icons/”并使用它们
132
+ 16. iframeTools: 拖拽操作增加透明遮罩,防止鼠标指针落入框架而导致监听失败,提高拖拽流畅性
133
+ 17. iframeTools: 对open方法增加一个私有的iframe扩展方法,用来引用其创建的iframe对象
134
+ 18. 新增点击内容部分也可以如点击标题一样置顶对话框的特性
135
+ 19. iframeTools: 增加父页面刷新与关闭后子对话框也将关闭的特性。(由于iframe注销后其产生的对象会被大多数浏览器在内存中移除,增加此特性可以有效的解决对话框报错)
136
+ 20. ** DOM底层api兼容jQuery api,同步发行jQuery版本**
137
+ 21. ** 消息内容支持传入DOM元素**
138
+ 22. 增加title标题接口
139
+ 23. 增加button自定义按钮接口
140
+ 24. 增加lock与unlock接口
141
+ 25. 新增data方法用来在iframe之间共享数据
142
+ 26. 重定义zIndex配置参数
143
+ 27. 重新支持调节对话框大小
144
+ 28. 支持用第三方框架加载自身
145
+ 29. ** 配置参数全部为可选,如果没有content,它将出现loading动画**
146
+ 30. left与top关键字用百分比代替,同时增加width与height传递百分比参数
147
+ 31. 更好的支持iframe
148
+ 32. 修复若干BUG
149
+
150
+ ### 3.0.0
151
+
152
+ [ 初次支持框架]
153
+
154
+ 1. 修复iPad或iPhone下使用锁屏焦点自动弹出的问题
155
+ 2. 修复移动设备使用手势缩放页面带来的漂移问题
156
+ 3. 修复fixed在移动设备中支持不完整的问题
157
+ 4. 修复window.top是框架集(frameset)页面可能会带来无限循环递归的问题
158
+ 5. 增加art.dialog.get()方法获取指定ID对话框API
159
+ 6. 修复框架集(frameset)页面不能植入artDialog而产生js报错的问题,并增加了其支持
160
+ 7. 公开默认配置的读写
161
+ 8. 重写IE6 fixed实现
162
+
163
+ ### 2.0.0
164
+
165
+ [ 进一步封装]
166
+
167
+ 1. ** 支持多对话框共存**
168
+ 2. 支持返回扩展方法关闭对话框
169
+ 3. 解决v1已知的一些BUG
170
+
171
+ ### 1.0.0
172
+
173
+ [ 诞生]
174
+
175
+ 1. ** 高度与宽度支持原生自适应内容,自适应文本对齐**
176
+ 2. 支持拖动、Esc关闭对话框、坐标定位
177
+ 3. ** 支持自适应位置**
178
+ 4. ** 支持IE6无抖动静止定位**
0 commit comments