HT 对话框手册

索引


概述

ht.widget.Dialog是一个可灵活配置的模态对话框插件,可配置高度、宽度、内容,样式等,支持在一个页面中创建多个实例, 适合于创建:登录框,注册框,警告对话框等。 在正式使用API之前,您的页面里需要引入相关的js文件:

<script src="ht.js"></script> <!--先引入ht.js-->
<script src="ht-cssanimation.js"></script> <!--依赖cssanimation插件-->
<script src="ht-form.js"></script> <!--依赖form插件-->
<script src="ht-dialog.js"></script>

Dialog提供的API如下:

简单示例

接下来看一个简单的例子:

dialog.setConfig({
    itle: "title",
    titleIcon: 'node_image', //ht内部注册的图片名
    content: graph,
    width: 250,
    height: 250,
    draggable: true,
    closable: true,
    maximizable: true,
    resizeMode: "wh",
    buttons: [{
        label: "Close",
        action: function(button, e) {
            dialog.hide();
        }
    }],
    buttonsAlign: "center",
    action: function(item, e) {
        console.log(item, e);
    }
});

自定义对话框样式

除了概述章节里提到配置参数,面板还支持使用全局的htconfig对象配置整体风格,可配置的参数如下:

<script>
    htconfig = {
        Color: {
            titleBackground: '#076186',
            titleIconBackground: 'white',
            headerBackground: '#DAECF4'
        },
        Default: {
            dialogButtonBackground: 'rgb(231, 76, 60)',
            dialogButtonSelectBackground: 'rgb(196, 65, 51)',
            dialogButtonLabelColor: '#fff'
        }
    };
</script>

与对话框交互

许多场景里,对话框不仅仅用来展示内容,有时也会放置表单收集用户输入的信息。我们可以利用浏览器提供的querySelector方法查询获得对话框中的DOM对象然后进行操作。 下面的例子演示这个交互过程:

实现原理可以查看示例的源代码。


欢迎交流 service@hightopo.com