Model组件是一个模态框组件,可以弹出一个对话框,适合需要定制性更大的场景。
它的样子如下:
其html代码为:
<div class="modal-content"> <div class="modal-header"> <h5 class="modal-title">弹窗标题</h5> <button type="button" class="btn-close" aria-label="Close"></button> </div> <div class="modal-body"> <p>弹窗正文</p> </div> <div class="modal-footer"> <Button Color="Color.Secondary" Text="Close" Icon="fa fa-times"></Button> <Button Text="Save" Icon="fa fa-save"></Button> </div> </div>
我们的组件遵循这个样式,组件代码为:
<Modal @ref="Modal" IsKeyboard="@IsKeyboard"> <ModalDialog Title="默认弹窗"> <BodyTemplate> <div>我是弹窗内正文</div> </BodyTemplate> </ModalDialog> </Modal>
可以看到,组件的代码量比直接写弹窗要少得多。
但是这个弹窗默认是不显示的,我们可以使用ref
获取到弹窗实例来显示它,如上面的弹窗,引用为:
[NotNull] private Modal? Modal { get; set; }
然后我们弹窗就可以写为:
await Modal.Toggle()
HeaderTemplate
:模态框的头部组件,为RenderFragment
。
Title
:模态框的标题,此属性与HeaderTemplate
互斥,只能使用一个。
BodyTemplate
:模态框主要内容部分组件,为RenderFragment
。
FooterTemplate
:模态框底部组件,为RenderFragment
。为空则不显示。
IsBackdrop
:是否可以点击弹窗以外的区域关闭弹窗,默认为false
。
IsKeyboard
:是否可以使用键盘ESC关闭弹窗,默认为true
。
IsCentered
:弹窗是否垂直居中,默认为true
。
IsScrolling
:是否对弹窗内超长内容添加滚动条,默认为false
。
IsFade
:是否开启淡入淡出效果,默认为true
。
IsDraggable
:弹窗是否可拖拽,默认为false
。
ShowCloseButton
:是否在右上方显示关闭按钮,默认为true
。
ShowFooter
:是否显示底部,默认为true
。
Size
:弹窗的尺寸,可选值有None / ExtraSmall / Small / Medium / Large / ExtraLarge / ExtraExtraLarge
。
FullScreenSize
:小于指定大小时自动全屏,可选最小值有None / ExtraSmall / Small / Medium / Large / ExtraLarge / ExtraExtraLarge
。
ShowMaximizeButton
:是否显示最大化按钮,默认为false
。