Skip to content
On this page

dialog(弹出框)组件

https://element-plus.org/zh-CN/component/dialog.html

Hidden Title

基础用法:<s-dialog v-model="isShow">内容</s-dialog>

属性事件插槽简介

基础用法

抽屉式用法

设置 type="drawer" 时,s-dialog 会按抽屉方式展示。type 的可选值是 ''drawer,默认值是 ''。设置 width 可以控制抽屉宽度,width 支持 stringnumber,默认值是 ''

drawer 配合 fillSlot

fillSlot 的可选值是 truefalse,默认值是 false

成华样式

设置 theme="chenghua" 可以切换到成华样式。成华主题默认展示底部按钮,和普通 dialog 行为一致。

chenghua主题示例

chenghua 抽屉式用法

设置 theme="chenghua"type="drawer" 时,s-dialog 会按成华主题的抽屉式弹层展示。theme 的可选值是 defaultnormnorm16simplechenghuashijingshan,默认值是 defaulttype 的可选值是 ''drawer,默认值是 ''width 支持 stringnumber,默认值是 '',可用于控制抽屉宽度。

石景山样式

设置 theme="shijingshan" 可以切换到石景山样式。石景山主题默认展示底部按钮,和普通 dialog 行为一致。

shijingshan主题示例

shijingshan 抽屉式用法

设置 theme="shijingshan"type="drawer" 时,s-dialog 会按石景山主题的抽屉式弹层展示。theme 的可选值是 defaultnormnorm16simplechenghuashijingshan,默认值是 defaulttype 的可选值是 ''drawer,默认值是 ''width 支持 stringnumber,默认值是 '',可用于控制抽屉宽度。

通常用法

插槽

全屏

弹框form表单

自动给确认按钮加loading

dialog组件如果把@confirm换成:confirm, 那么子组件会优先处理属性confirm, 如果属性confirm是一个异步请求, 会加载loading; 注意: 如果点击后确认按钮一致有loading, 那说明返回的不是promise

内部高度占满100%: fillSlot

全局默认配置

dialog 支持在 app.use 的第二个参数里配置全局默认值,写法和 Element Plus 的全局配置保持一致。

js
app.use(SybzComponents, {
  theme: 'chenghua',
  dialog: {
    hideHeaderIcon: true,
  },
})
app.use(SybzComponents, {
  theme: 'chenghua',
  dialog: {
    hideHeaderIcon: true,
  },
})

属性

属性名说明类型默认值
title顶部titlestring提示
subTitle顶部二级标题,显示在 title 下方,颜色稍淡string''
width弹框宽度;当 type="drawer" 时用于控制抽屉宽度string / number''
theme弹框样式,可选 default / norm / norm16 / simple / chenghua / shijingshanstringdefault
type弹框类型,可选 drawerstring''
hideHeaderIcon是否隐藏顶部默认iconbooleanfalse
cancelText取消按钮文本string取消
confirmText确认按钮文本string确认
footer是否显示底部操作按钮object-
showFooter是否显示底部操作按钮booleantrue
showCancel是否显示取消按钮boolean true
showConfirm是否显示确认按钮booleantrue
confirmAttrs确认按钮的属性object{}
cancleAttrs取消按钮的属性object{}
destroy-on-close当关闭 Dialog 时,销毁其中的元素booleanfalse
fullscreen是否为全屏Dialogbooleanfalse
enableConfirm是否允许使用enter回车键执行confirm事件booleantrue
closeOnClickModal是否允许点击模态框关闭弹框booleantrue
confirm绑定确认按钮的方法, 与方法的区别是, 可以使用属性绑定异步事件而直接让确认按钮加载loadingFunction-
fillSlot是否让默认slot内容区撑满dialog body高度, 并由slot内部自行处理滚动booleanfalse

方法

属性名说明类型
cancel取消按钮的方法Function
confirm确认按钮的方法Function

Slots

插槽名说明
header对话框标题内容区;只替换标题文字区域,默认 icon 仍保留
headerIcon对话框标题左侧 icon 内容
footerDialog 按钮操作区的内容

思云博智私有前端组件库