Dialog

对话框.
扩展于 Overlay

Class

Config Attributes

除了 content 配置项外与 Overlay 的配置项完全相同, 其他新增配置项如下:

Properties

除了 Overlay 的所有属性之外还有:

Methods

Events

Class Detail

class overlay.Dialog
Dialog (config)
Parameters:config (Object) – 配置项, 详细见下方 Config Attributes Detail .

对话框的 DOM 结构为:

<div class='dialog'> <!-- 对话框根节点 -->
    <div class='content'> <!-- 对话框内容节点 -->
        <div class='header'> <!-- 对话框标题节点 -->
        </div>

        <div class='body'> <!-- 对话框体节点 -->
        </div>

        <div class='footer'> <!-- 对话框底部节点 -->
        </div>
    </div>
</div>

Note

使用前请加上初始样式

<style>
    .ks-overlay {
        position:absolute;
        left:-9999px;
        top:-9999px;
    }
</style>

Config Attributes Detail

除了 content 配置项外与 Overlay 的配置项完全相同, 但是新增了一些配置项如下所示:
Dialog.config.headerContent

{String|KISSY.Node} - 对话框的标题 html 或标题节点.

Dialog.config.bodyContent

{String|KISSY.Node} - 对话框的体 html 或体节点.

Dialog.config.footerContent

{String|KISSY.Node} - 对话框的底部 html 或底部节点.

Dialog.config.draggable

{Boolean} - 是否允许拖动头部移动, 注意启用时需同时 use("dd") , 例如:

KISSY.use("dd,overlay",function(S,DD,Overlay){
    new Overlay.Dialog({
        draggable : true
    });
});
Dialog.config.aria

{Boolean} - 默认为 false, 是否开启 aria 支持. 开启后, 窗口显示出来时自动获得焦点并且 tab 键只能在窗口内部转移焦点.

Dialog.config.constrain
{Boolean | String} - 和 Draggable 配合, 限制拖动的范围.
  • 取值选择器字符串时, 则在限制拖动范围为根据该选择器字符串取到的第一个节点所在区域.
  • 取值 true 时, 只能在当前视窗范围内拖动.
  • 取值 false 时, 可任意移动, 例如:
KISSY.use("dd,overlay",function(S,DD,Overlay){
    new Overlay.Dialog({
        draggable : true,
        contrain:true // 限制拖动区域为当前视窗范围
    });
});

KISSY.use("dd,overlay",function(S,DD,Overlay){
    new Overlay.Dialog({
        draggable : true,
        contrain:"#container" // 限制拖动区域为 container 节点所占据区域
    });
});

Properties Detail

除了 Overlay 的所有属性之外还有:
Dialog.prototype.header

{KISSY.Node} - 只读, 对话框的头部节点.

Dialog.prototype.body

{KISSY.Node} - 只读, 对话框的体部节点.

Dialog.prototype.footer

{KISSY.Node} - 只读, 对话框的底部节点.

Note

以上三个属性在获取前必须调用过 render() 方法.

Dialog.prototype.draggable

{Boolean} - 头部是否可以拖放.

Dialog.prototype.constrain

{Boolean|String} - 拖放区域范围.

Methods Detail

Overlay .

Events Detail