Appearance
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 支持 string 和 number,默认值是 ''。
drawer 配合 fillSlot
fillSlot 的可选值是 true 和 false,默认值是 false。
成华样式
设置 theme="chenghua" 可以切换到成华样式。成华主题默认展示底部按钮,和普通 dialog 行为一致。
chenghua主题示例
chenghua 抽屉式用法
设置 theme="chenghua" 和 type="drawer" 时,s-dialog 会按成华主题的抽屉式弹层展示。theme 的可选值是 default、norm、norm16、simple、chenghua 和 shijingshan,默认值是 default;type 的可选值是 '' 和 drawer,默认值是 '';width 支持 string 和 number,默认值是 '',可用于控制抽屉宽度。
石景山样式
设置 theme="shijingshan" 可以切换到石景山样式。石景山主题默认展示底部按钮,和普通 dialog 行为一致。
shijingshan主题示例
shijingshan 抽屉式用法
设置 theme="shijingshan" 和 type="drawer" 时,s-dialog 会按石景山主题的抽屉式弹层展示。theme 的可选值是 default、norm、norm16、simple、chenghua 和 shijingshan,默认值是 default;type 的可选值是 '' 和 drawer,默认值是 '';width 支持 string 和 number,默认值是 '',可用于控制抽屉宽度。
通常用法
插槽
全屏
弹框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 | 顶部title | string | 提示 |
| subTitle | 顶部二级标题,显示在 title 下方,颜色稍淡 | string | '' |
| width | 弹框宽度;当 type="drawer" 时用于控制抽屉宽度 | string / number | '' |
| theme | 弹框样式,可选 default / norm / norm16 / simple / chenghua / shijingshan | string | default |
| type | 弹框类型,可选 drawer | string | '' |
| hideHeaderIcon | 是否隐藏顶部默认icon | boolean | false |
| cancelText | 取消按钮文本 | string | 取消 |
| confirmText | 确认按钮文本 | string | 确认 |
| footer | 是否显示底部操作按钮 | object | - |
| showFooter | 是否显示底部操作按钮 | boolean | true |
| showCancel | 是否显示取消按钮 | boolean | true |
| showConfirm | 是否显示确认按钮 | boolean | true |
| confirmAttrs | 确认按钮的属性 | object | {} |
| cancleAttrs | 取消按钮的属性 | object | {} |
| destroy-on-close | 当关闭 Dialog 时,销毁其中的元素 | boolean | false |
| fullscreen | 是否为全屏Dialog | boolean | false |
| enableConfirm | 是否允许使用enter回车键执行confirm事件 | boolean | true |
| closeOnClickModal | 是否允许点击模态框关闭弹框 | boolean | true |
| confirm | 绑定确认按钮的方法, 与方法的区别是, 可以使用属性绑定异步事件而直接让确认按钮加载loading | Function | - |
| fillSlot | 是否让默认slot内容区撑满dialog body高度, 并由slot内部自行处理滚动 | boolean | false |
方法
| 属性名 | 说明 | 类型 |
|---|---|---|
| cancel | 取消按钮的方法 | Function |
| confirm | 确认按钮的方法 | Function |
Slots
| 插槽名 | 说明 |
|---|---|
| header | 对话框标题内容区;只替换标题文字区域,默认 icon 仍保留 |
| headerIcon | 对话框标题左侧 icon 内容 |
| footer | Dialog 按钮操作区的内容 |