# artDialog™ basic

"artDialog basic" artDialog 的子项目；它只拥有核心功能，体积较小，可被客户端快速载入。

导航： 皮肤 | 配置参数 | 控制接口

## 1.应用到你的项目

在页面head引入artDialog:

    <link href="artDialog/skins/default.css" rel="stylesheet" />
    <script src="artDialog/basic/artDialog.basic.js"></script>

## 2.配置参数

名称 | 类型 | 默认值 | 描述
--- | --- | --- | ---
内容
title | String | '消息' | 标题内容
content | String | 'loading..' | 消息内容。 如果传入的是HTMLElement类型，如果是隐藏元素会给其设置display:block以显示该元素，其他属性与绑定的事件都会完整保留，对话框关闭后此元素又将恢复原来的display属性，并且重新插入原文档所在位置。
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的一个属性，它静止在浏览器某个地方不动，也不受滚动条拖动影响。(只限现代浏览器)
follow | HTMLElement | null | 让对话框依附在指定元素附近。 可传入元素ID名称，注意ID名称需要以“#”号作为前缀
String
视觉
lock | Boolean | false | 开启锁屏。 中断用户对话框之外的交互，用于显示非常重要的操作/消息，所以不建议频繁使用它
background | String | '#000' | 锁屏遮罩颜色
opacity | Number | 0.7 | 锁屏遮罩透明度
padding | String | '20px 25px' | 内容与边界填充边距(即css padding)
交互
time | Number | null | 设置对话框显示时间。以秒为单位
esc | Boolean | true | 是否允许用户按Esc键关闭对话框
高级
id | String | null | 设定对话框唯一标识。用途： 1、防止重复弹出 2、可后续使用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 | 是否显示对话框

配置全局默认设置:

    (function (config) {
        config['lock'] = true;
        config['fixed'] = true;
        config['okVal'] = 'yes';
        config['cancelVal'] = 'no';
        // [more..]
    })(art.dialog.defaults);

### 内容 [content]

#### 1. 传入字符串

    art.dialog({
    	content: '我支持HTML'
    });

#### 2. 传入HTMLElement

备注：1、元素不是复制而是完整移动到对话框中，所以原有的事件与属性都将会保留 2、如果隐藏元素被传入到对话框，会设置display:block属性显示该元素 3、对话框关闭的时候元素将恢复到原来在页面的位置，style display属性也将恢复

    art.dialog({
        content: document.getElementById('demoCode_content_DOM'),
        id: 'EF893L'
    });

### 标题 [title]

    art.dialog({
    	title: 'hello world!'
    });

### 确定取消按钮 [ok & cancel]

备注：回调函数this指向扩展接口，如果返回false将阻止对话框关闭

    art.dialog({
        content: '如果定义了回调函数才会出现相应的按钮',
        ok: function () {
        	this.title('改变标题');
            return false;
        },
        cancelVal: '关闭',
        cancel: true //为true等价于function(){}
    });

### 自定义按钮 [button]

备注：回调函数this指向扩展接口，如果返回false将阻止对话框关闭；button参数对应的控制接口名称也是"button"

    art.dialog({
        id: 'testID',
        content: 'hello world!',
        button: [
            {
                name: '同意',
                callback: function () {
                    this.content('你同意了');
                    return false;
                },
                focus: true
            },
            {
                name: '不同意',
                callback: function () {
                    alert('你不同意')
                }
            },
            {
                name: '无效按钮',
                disabled: true
            },
            {
                name: '关闭我'
            }
        ]
    });

### 定时关闭的消息 [time]

    art.dialog({
        time: 2,
    	content: '两秒后关闭'
    });

### 防止重复弹出 [id]

    art.dialog({
        id: 'testID',
    	content: '再次点击运行看看'
    });
    art.dialog({id: 'testID'}).title('8888888888');

### 内容与边界填充边距 [padding]

有时候并不需要默认的内容填充边距，如展示图片与视频

    art.dialog({
    	padding: 0,
        title: '照片',
    	content: '<img src="_doc/images/photo.jpg" width="379" height="501" />',
        lock: true
    });

### 锁屏 [lock & background & opacity]

    art.dialog({
    	lock: true,
        background: '#600', // 背景色
        opacity: 0.7,	// 透明度
    	content: '中断用户在对话框以外的交互，展示重要操作与消息',
        icon: 'error',
    	ok: function () {
    		art.dialog({content: '再来一个锁屏', lock: true});
            return false;
    	},
        cancel: true
    });

### 跟随元素 [follw]

#### 1、标准形式

    art.dialog({
    	follow: document.getElementById('followTestBtn'),
    	content: '让对话框跟着某个元素，一个元素同时只能出现一个对话框'
    });

#### 2、使用简写形式 （已经绑定onclick事件，注意此返回值不再是对话框控制接口）

    art('#demoCode_follow_a').dialog({
    	content: '让对话框跟着某个元素，一个元素同时只能出现一个对话框'
    });

元素触发

### 设置大小 [width & height]

    art.dialog({
    	width: '20em',
        height: 55,
    	content: '尺寸可以带单位'
    });

### 静止定位 [fixed]

    art.dialog({
    	fixed: true,
    	content: '请拖动滚动条查看'
    });

## 3.控制接口

名称 | 描述
--- | ---
close() | 关闭对话框
show() | 显示对话框
hide() | 隐藏对话框
title(value) | 写入标题，无参数则返回标题容器元素
content(value) | 向消息容器中写入内容。参数支持字符串、DOM对象，无参数则返回内容容器元素
button(arguments) | 插入一个自定义按钮。 如：button({name: '登录', callback: function () {_form.submit();}) 更多用法请见范例文档
follow(element) | 让对话框吸附到指定元素附近
size(width, height) | 重新设定对话框大小
lock() | 锁屏
unlock() | 解锁
time(val) | 定时关闭（单位秒）

备注：控制接口返回值都是this，因此你可以使用链式编程风格。

控制接口可以在对话框初始化后控制对话框，需要有一定的javascript基础，这里不做过多演示。

### 演示一

直接引用控制接口

    var dialog = art.dialog({
    	title: '我是对话框',
        content: '我是初始化的内容'
    });

    dialog.content('对话框内容被控制接口改变了').title('提示');

### 演示二

通过ID获取控制接口

    art.dialog({
        id: 'KDf435',
        title: '警告',
        content: '我是初始化的内容'
    });

    art.dialog.list['KDf435'].content('对话框内容被控制接口改变了');

### 演示三

在回调函数中使用this引用控制接口

    art.dialog({
        title: '警告',
        content: '我是初始化的内容',
        ok: function () {
        	this.content('你点了确定按钮').lock();
            return false;
        },
        init: function () {
        	this.content('对话框内容被控制接口改变了');
        }
    });

### 演示四

关闭页面所有对话框

    var list = art.dialog.list;
    for (var i in list) {
    	list[i].close();
    };

### 按钮接口演示

备注：回调函数如果返回false将阻止对话框关闭

    var dialog = art.dialog({
        title: '警告',
        content: '点击管理按钮将让删除按钮可用',
        width: '20em',
        button: [{
        	name: '管理',
            callback: function () {
                this.content('我更改了删除按钮').button({
                    name: '删除',
                    disabled: false
                });
                return false;
            },
            focus: true
        }]
    });

    dialog.button(
        {
            name: '删除',
            callback: function () {
                alert('remove')
            },
            disabled: true
        }
    )

### 改变关闭方式

    art.dialog({
    	id: 'show-hide',
    	content: '关闭后阻止对话框被删除，只隐藏对话框',
    	close: function () {
    		this.hide();
    		return false;
    	}
    }).show();