Skip to content

aralejs/dialog

Repository files navigation

Dialog


Build Status Coverage Status

基础对话框组件,提供对话框显示隐藏、dom 结构自定义、定位、select 遮挡、确定取消关闭等功能特性。

本模块分为两个子组件:Dialog 和 ConfirmBox,前者提供抽象的基础容器功能,无绑定 UI 样式,后者在前者的基础上提供模态对话框的功能并提供完善的 UI 样式。

Dialog 组件提供了默认样式,请单独引用 dialog.css

Dialog 继承了 overlay,可使用其中包括 widgetbaseclasseventsattributeaspect 的属性和方法。


组件演示

npm run doc

访问 http://localhost:8002/

最佳实践

见 examples

配置说明

trigger element

对话框触发元素,可传递选择器。

content string|element

容器的内容,可以是纯字符串、dom对象、jQuery对象、html标签字符串、以及 URL 地址。当 content 为 URL 地址时,本组件将内嵌目标页面的 Iframe。

hasMask boolean

是否有背景遮罩层。默认为 true

classPrefix string

统一样式前缀,默认为 ui-dialog

closeTpl string

右上角的关闭链接,默认为×

width number|string

对话框宽度,默认 500px。

height number|string

对话框高度。当设置了这个属性时,对话框高度会固定, 下面的 autoFit 强制为 false,initialHeight 失效。

zIndex number

对话框 z-index 层级,默认 999。

effect string

简单的动画效果,none 为无动画,fade 为渐入效果。默认为 none。

autoFit boolean

内嵌 Iframe 页面时是否自适应高度,默认为 true。iframe 类型时有效

initialHeight number|string

内嵌 Iframe 页面时对话框的初始高度(onload 后会发生变化),默认为 300px 。只有当对话框是 iframe 类型时有效

其他配置如定位参数 align 等请参照 overlay

实例方法

主要有 show、hide、render 等方法,请参照 overlay