展示类

模态对话框

模态对话框用于等待用户响应、告知用户重要信息或在不丢失上下文的情况下展示更多信息

代码演示

如何引入

<script lang="ts">
    import { Modal } from '@fibrae/semi-ui-svelte';
</script>

基本

对话框用 bind:visible 控制显示。bind:visible 只在取消路径写回 false:取消按钮、关闭按钮、遮罩和 Esc;onCancel 返回 Promise 时,在 fulfill 后写回,reject 则保持打开。点击确定只调用 onOk,由使用方把 visible 设为 false。onCancel 回调执行时,visible 仍为 true。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const handleOk = () => {
        visible = false;
        console.log('Ok button clicked');
    };
    const handleCancel = () => {
        console.log('Cancel button clicked');
    };
    const handleAfterClose = () => {
        console.log('After Close callback executed');
    };
</script>

<Button onclick={() => (visible = true)}>打开弹窗</Button>
<Modal afterClose={handleAfterClose} bind:visible closeOnEsc onCancel={handleCancel} onOk={handleOk} title="基本对话框">
    This is the content of a basic modal.
    <br />
    More content...
</Modal>

底部撑满

设置 footerFill 为 true 可使 Modal footer 底部按钮撑满排列

点击遮罩层不可关闭

修改 maskClosable 为 false 则不可通过点击遮罩层来关闭对话框。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const close = () => {
        visible = false;
    };
</script>

<Button onclick={() => (visible = true)}>点击遮罩层不可关闭</Button>
<Modal bind:visible maskClosable={false} onOk={close} title="对话框标题">
    <p>This is a modal that cannot be closed by clicking on the mask.</p>
    <p>More content...</p>
</Modal>

自定义按钮文字

通过设置 okText 与 cancelText 属性可自定义按钮显示的文字。

注意:命令式调用的 Modal 渲染在组件树之外,读不到 ConfigProvider、LocaleProvider 提供的语言包,需要通过这两个属性来设置文本,或者使用 Modal.useModal。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const close = () => {
        visible = false;
    };
</script>

<Button onclick={() => (visible = true)}>自定义按钮文字</Button>
<Modal bind:visible cancelText="No, thanks." okText="Sounds great!" onOk={close} title="自定义按钮文字">
    <p>This is a modal with customized button texts.</p>
    <p>More content...</p>
</Modal>

自定义按钮属性

通过设置 okButtonProps 与 cancelButtonProps 属性可自定义按钮的属性。其中的 onClick 先于内置处理调用,不会替换内置处理。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const close = () => {
        visible = false;
    };
</script>

<Button onclick={() => (visible = true)}>自定义按钮属性</Button>
<Modal bind:visible cancelButtonProps={{ size: 'small', disabled: true }} okButtonProps={{ size: 'small', type: 'warning' }} onOk={close} title="自定义按钮属性">
    <p>This is a modal with customized button props.</p>
    <p>More content...</p>
</Modal>

自定义对话框头部和页脚

如果需要实现更丰富的个性化需求,可以通过 header snippet 自定义头部,footer snippet 自定义页脚的按钮。写一个空的 header snippet({#snippet header()}{/snippet})或把 header 设为 null 时不展示头部区域;不需要显示任何按钮时,同样可以写空的 footer snippet 或把 footer 设为 null。

自定义对话框的样式

通过设置 style 可以自定义样式及位置如 style.top,也可以通过 centered 使对话框居中显示。也可以通过设置 maskStyle 自定义遮罩样式,及 bodyStyle 自定义对话框内容样式。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const close = () => {
        visible = false;
    };
</script>

<Button onclick={() => (visible = true)}>自定义对话框样式</Button>
<Modal bind:visible bodyStyle="overflow: auto; height: 200px" centered onOk={close} title="自定义样式">
    <p style="line-height: 1.8">Semi Design 是由抖音前端团队与 UED 团队共同设计开发并维护的设计系统。设计系统包含设计语言以及一整套可复用的前端组件,帮助设计师与开发者更容易地打造高质量的、用户体验一致的、符合设计规范的 Web 应用。</p>
    <p style="line-height: 1.8">区别于其他的设计系统而言,Semi Design 以用户中心、内容优先、设计人性化为设计理念,具有以下优势:</p>
    <ul>
        <li>
            <p>Semi Design 以内容优先进行设计。</p>
        </li>
        <li>
            <p>更容易地自定义主题。</p>
        </li>
        <li>
            <p>适用国际化场景。</p>
        </li>
        <li>
            <p>效率场景加入人性化关怀</p>
        </li>
    </ul>
</Modal>

自定义的对话框

通过灵活使用 header、footer 等 snippet 可以实现一个完全自定义的对话框。

代码
<script lang="ts">
    import { IconSemiLogo, IconVigoLogo } from '@fibrae/semi-icons-svelte';
    import { Button, List, ListItem, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const data = [
        {
            icon: IconSemiLogo,
            title: 'Boost new feature adoption with Integration',
            content: 'Sample data is prepared for you to demonstrate how Integration may be useful for your team',
        },
        {
            icon: IconVigoLogo,
            title: 'Introducing Dark Mode',
            content: 'Sample data is prepared for you to demonstrate how Integration may be useful for your team',
        },
        {
            icon: IconSemiLogo,
            title: 'New List Component',
            content: 'Sample data is prepared for you to demonstrate how Integration may be useful for your team',
        },
    ];
    const btnStyle = 'width: 240px; margin: 4px 50px';
</script>

<Button onclick={() => (visible = true)}>自定义对话框</Button>
<Modal bind:visible>
    {#snippet header()}{/snippet}
    <h3 style="text-align: center; font-size: 24px; margin: 40px">Semi Design New Features</h3>
    <List dataSource={data} split={false}>
        {#snippet item({ item: entry })}
            <ListItem>
                {#snippet header()}
                    <entry.icon style="font-size: 48px" />
                {/snippet}
                {#snippet main()}
                    <div>
                        <h6 style="margin: 0; font-size: 16px">{entry.title}</h6>
                        <p style="margin-top: 4px; color: var(--semi-color-text-1)">{entry.content}</p>
                    </div>
                {/snippet}
            </ListItem>
        {/snippet}
    </List>
    {#snippet footer()}
        <div style="text-align: center">
            <Button style={btnStyle} theme="solid" type="primary" onclick={() => (visible = false)}>Continue</Button>
            <Button style={btnStyle} theme="borderless" type="primary" onclick={() => (visible = false)}>Learn more features</Button>
        </div>
    {/snippet}
</Modal>

全屏 Modal

使用 fullScreen 可以开启全屏对话框

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
    const close = () => {
        visible = false;
    };
</script>

<Button onclick={() => (visible = true)}>打开全屏弹窗</Button>
<Modal bind:visible fullScreen onOk={close} title="全屏对话框标题">
    <p>This is a full screen modal</p>
    <p>More content...</p>
</Modal>

命令式调用

使用 confirm() 可以设置一个确认框。支持各种类型的信息提示。命令式调用的 title、content、icon、closeIcon、header、footer 接收 ModalNode:字符串,或 snippet;icon 传 null 则不显示图标。其他 Modal 支持的选项都可以传入。











代码
<script lang="ts">
    import { IconSend } from '@fibrae/semi-icons-svelte';
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    const success = () => Modal.success({ title: 'This is a success message', content: 'bla bla bla...' });
    const info = () => Modal.info({ title: 'Here is some info', content: 'bla bla bla...' });
    const error = () => Modal.error({ title: 'Unfortunately, there is an error', content: 'bla bla bla...' });
    const warning = () => Modal.warning({ title: 'Warning: be cautious ahead', content: 'bla bla bla...' });
    const confirm = () => Modal.confirm({ title: 'Are you sure ?', content: 'bla bla bla...' });
    const custom = () =>
        Modal.info({
            title: 'This is a custom modal',
            content: 'bla bla bla...',
            icon: sendIcon,
            cancelButtonProps: { theme: 'borderless' },
            okButtonProps: { theme: 'solid' },
        });
</script>

{#snippet sendIcon()}
    <IconSend />
{/snippet}

<div>
    <Button onclick={info}>Info</Button>
    <br />
    <br />
    <Button onclick={success}>Success</Button>
    <br />
    <br />
    <Button type="danger" onclick={error}>Error</Button>
    <br />
    <br />
    <Button type="warning" onclick={warning}>Warning</Button>
    <br />
    <br />
    <Button type="primary" onclick={confirm}>Confirm</Button>
    <br />
    <br />
    <Button onclick={custom}>Custom</Button>
</div>

Hooks 用法

Modal.useModal() 返回 { info, success, error, warning, confirm },没有 Holder。它在调用时读取所在组件的 context、ConfigProvider 与语言包,所以要在组件初始化时调用,并且放在需要读取这些上下文的组件里(通常是 ConfigProvider 的子组件);组件销毁时它打开的对话框一并移除。

代码
<script lang="ts">
    import { Button, Modal } from '@fibrae/semi-ui-svelte';

    // Reads the contexts (ConfigProvider, LocaleProvider) of this component, so call it during initialization
    const modal = Modal.useModal();
</script>

<div>
    <Button onclick={() => modal.confirm({ title: 'This is a success message', content: 'Context consumer' })}>Confirm Modal</Button>
</div>

可拖拽 Modal

Svelte 的 DragMove 是 attachment dragMove。把 {@attach dragMove(options)} 直接写在 <Modal> 上,attachment 会挂到 role="dialog" 元素上,对话框就能拖动。需要自己摆放对话框时,也可以用 modal snippet(参数 { modal },用 {@render modal()} 放置)。

代码
<script lang="ts">
    import { Button, dragMove, Modal } from '@fibrae/semi-ui-svelte';

    let visible = $state(false);
</script>

<div>
    <Button onclick={() => (visible = true)}>Open Modal</Button>
    <Modal {@attach dragMove({ positionStrategy: 'relative' })} bind:visible centered title="可拖拽Modal">
        <p>This is the content of a basic sidesheet.</p>
        <p>Here is more content...</p>
    </Modal>
</div>

API 参考

Props

属性说明类型默认值
afterClose对话框完全关闭后触发;显示期间被卸载时也会触发一次。Type() => void-
bodyStyle对话框内容区的样式,字符串。string-
cancelButtonProps取消按钮的属性。autoFocus 为 true 时打开后聚焦该按钮;class、style 落在按钮上;onclick 先于内置的取消处理调用,不会替换内置处理。ModalButtonProps-
cancelLoading取消按钮是否加载中;不传时跟随 onCancel 返回的 Promise,显式传入 false 关闭该行为。boolean-
cancelText取消按钮文字,缺省取语言包 Modal.cancel。string-
centered是否垂直居中显示。booleanfalse
children对话框的正文,写在标签内。Snippet-
closable是否显示右上角的关闭按钮。booleantrue
closeIcon关闭按钮中图标的 snippet。Snippet-
closeOnEsc是否允许按 Esc 取消对话框。booleantrue
confirmLoading确认按钮是否加载中;不传时跟随 onOk 返回的 Promise,显式传入 false 关闭该行为。boolean-
footer完全替换默认页脚按钮的 snippet。写一个空 snippet 或传 null 时不渲染页脚区域。Snippet | null-
footerFill默认页脚的两个按钮是否撑满排列。boolean-
fullScreen是否全屏显示,开启后 width、height 不再生效。booleanfalse
getPopupContainer指定弹层渲染到的父级 DOM。自定义容器需要设置 position: relative;这会改变浮层的 DOM 位置,不改变视图位置。Type() => HTMLElement-
hasCancel默认页脚是否显示取消按钮。booleantrue
header完全替换默认头部(图标、标题与关闭按钮)的 snippet。写一个空 snippet 或传 null 时不渲染头部区域。Snippet | null-
height对话框高度,数字按像素处理,字符串为合法 CSS 长度。string | number-
icon标题前图标的 snippet。Snippet-
keepDOM关闭时是否保留对话框内部节点而不销毁。booleanfalse
lazyRender配合 keepDOM 使用;为 true 时,首次显示之前不渲染对话框。booleantrue
mask是否显示遮罩。booleantrue
maskClosable是否允许点击遮罩取消对话框。booleantrue
maskFixed遮罩限定在自定义容器内时,是否仍以 fixed 定位覆盖整个视口并按模态处理(aria-modal、页面 inert、Tab 锁定、body 滚动锁定)。booleanfalse
maskStyle遮罩的样式,字符串。string-
modal自定义渲染对话框本身的 snippet,参数为 { modal },modal 是 role=dialog 元素对应的 snippet,用 {@render modal()} 放置。TypeSnippet<[{ modal: Snippet }]>-
modalContentClass对话框内容元素的类名。string-
motion是否启用进出场动画。booleantrue
okButtonProps确认按钮的属性。autoFocus 为 true 时打开后聚焦该按钮;class、style 落在按钮上;onclick 先于内置的确认处理调用,不会替换内置处理。ModalButtonProps-
okText确认按钮文字,缺省取语言包 Modal.confirm。string-
okType确认按钮的类型。OKType"primary"
onCancel取消按钮、关闭按钮、遮罩和 Esc 触发;按 Esc 时参数为原生 KeyboardEvent。返回 Promise 时取消按钮保持加载,fulfill 后才写回 visible,reject 时保持打开;回调执行时 visible 仍为 true。Type(event: MouseEvent | KeyboardEvent) => unknown-
onOk点击确认按钮时调用;返回 Promise 时确认按钮保持加载直到落定。组件不会自行关闭,由使用方把 visible 设为 false。Type(event: MouseEvent) => unknown-
preventScroll组件内部调用 focus 时是否阻止浏览器滚动到被聚焦元素,不影响使用方自己的 focus 调用。boolean-
role对话框元素的 role,可选 dialog 或 alertdialog。'dialog' | 'alertdialog'-
size对话框宽度档位:small 为 448px,medium 为 684px,large 为 920px,full-width 为 100vw - 64px。Size"small"
title标题,纯文本或 snippet,同时作为对话框的可访问名称。声明为 prop,不会作为原生 title 属性落到元素上。string | Snippet-
visible对话框是否可见,配合 bind:visible 使用。取消按钮、关闭按钮、遮罩和 Esc 在 onCancel 返回后写回 false;确认只调用 onOk,由使用方把 visible 设为 false。boolean-
width对话框宽度,数字按像素处理,字符串为合法 CSS 长度;不传时由 size 决定。string | number-
zIndex弹层外层的 z-index。number1000

Methods

方法说明类型
getRoot返回 Portal 内的最外层元素,未渲染时为 null。Type() => any

role 与全部 aria-* 属性落在 role="dialog" 元素上,style 落在 .semi-modal 对话框盒子上,class 与其他原生属性落在 portal 内最外层元素上;写在 <Modal> 上的 {@attach} 落在 role="dialog" 元素上。组件版 Modal 没有 content 属性,对话框内容写在标签内;content 选项只用于下面的命令式方法。

  • Modal.info
  • Modal.success
  • Modal.error
  • Modal.warning
  • Modal.confirm

ModalNode 为 string | Snippet。

属性说明类型默认值
afterClose对话框完全关闭后的回调函数() => void-
bodyStyle对话框内容的样式string-
cancelButtonProps取消按钮的属性,其中的 onclick 先于内置处理调用,不会替换内置处理ModalButtonProps-
cancelText取消按钮的文字string-
centered是否居中显示booleanfalse
class可用于设置样式类名ClassValue-
closable是否显示右上角的关闭按钮booleantrue
closeIcon关闭按钮的 iconModalNode<IconClose />
confirmLoading确认按钮 loading;未设置时跟随 onOk 返回 Promise 的 pending 状态,显式传 false 关闭该行为boolean-
content对话框内容ModalNode-
direction文字方向。静态方法在任何 ConfigProvider 之外渲染,需要自行传入;useModal 的方法默认跟随所在位置的 ConfigProvider'ltr' | 'rtl'-
footer对话框底部,null 时隐藏底部区域ModalNode | null-
footerFill底部按钮是否撑满booleanfalse
header对话框头部,null 时隐藏头部区域ModalNode | null-
height高度string | number-
icon自定义 icon,null 时不显示图标ModalNode | null-
mask是否显示遮罩booleantrue
maskClosable是否允许通过点击遮罩来关闭对话框booleantrue
maskStyle遮罩的样式string-
modalContentClass可用于设置对话框内容的样式类名string-
motion动画效果开关,update 中修改同样生效booleantrue
okButtonProps确认按钮的属性,其中的 onclick 先于内置处理调用,不会替换内置处理ModalButtonProps-
okText确认按钮的文字string-
okType确认按钮的类型OKTypeprimary
style可用于设置样式string-
title对话框的标题ModalNode-
width宽度,未设置时由 size 决定(small 为 448)string | number-
zIndex遮罩的 z-index 值number1000
onCancel取消回调,返回 Promise 时 fulfill 后自动关闭,reject 则保持打开;按 Esc 关闭时参数为原生 KeyboardEvent(event: MouseEvent | KeyboardEvent) => void | Promise<unknown>-
onOk点击确定回调,参数是点击事件,返回 Promise 时 fulfill 后自动关闭,reject 则保持打开(event: MouseEvent) => void | Promise<unknown>-

aria-* 与 data-* 选项落在对话框上。以上函数调用后,会返回一个引用,可以通过该引用更新和关闭弹窗。update 接收与以上函数相同的选项(ModalConfirmProps),合并到当前配置,不接收 type。

const modal = Modal.info({ title: '标题' });

modal.update({
    title: '更新的标题',
    content: '更新的内容',
});

modal.destroy();
  • Modal.destroyAll

使用 Modal.destroyAll() 可以销毁命令式及以上.info()等创建的弹窗。

  • Modal.useModal 当你需要读取上下文时,可以在组件初始化时通过 const modal = Modal.useModal() 得到 modal 对象,没有 Holder 组件。通过 modal 创建的对话框将得到调用它的组件所在位置的所有上下文(context、ConfigProvider、语言包)。modal 对象拥有与 Modal.method 相同的创建方法。

Accessibility

ARIA

WAI-ARIA: https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/

  • 组件版 Modal 的 role 为 dialog,遵循 APG Dialog (Modal)
  • 确认框(Modal.confirm、info、success、warning、error,以及 useModal 的同名方法)的 role 为 alertdialog,aria-describedby 指向正文,遵循 APG Alert Dialog
  • aria-modal 在对话框是模态时设置为 true。模态的判定是:有遮罩(mask),且挂载在 body 中(以实际容器判断,ConfigProvider 的 getPopupContainer 同样计入)或设置了 maskFixed。mask={false},或遮罩限定在自定义容器内时背景保持可用,不输出 aria-modal
  • aria-labelledby 对应对话框标题;传入 aria-label 或自定义头部时不生成该引用
  • 组件版 Modal 默认不设置 aria-describedby:正文含表单、列表或多段内容时,整段正文被读出反而干扰;需要时由使用方传入
  • 使用方传入的 role 与全部 aria-* 属性落在 role 所在的元素上
  • 关闭按钮的 aria-label 来自当前语言包(简体中文为「关闭」,英文为 'Close')

键盘和焦点

  • Modal 在弹出时自动获得焦点。对话框内带 autoFocus(Vue、Svelte 中为 autofocus)的元素优先获得焦点,没有时默认聚焦到取消按钮,可通过在 cancelButtonProps 或 okButtonProps 传入 autoFocus 来控制该行为。keepDOM 时再次打开,结果相同;keepDOM 加 lazyRender={false} 且初始隐藏时,autoFocus 元素在 display: none 下无法获得焦点,之后的打开落到默认按钮。
  • 模态对话框关闭时,焦点自动回归到打开前元素。键盘用户可以使用 Tab 键和 Shift + Tab,将焦点在 Modal 内循环移动,包括 Modal 自带的关闭按钮和确定取消按钮,此时 Modal 背后的页面不可交互,也不可被 tab 聚焦。
  • 非模态对话框(mask={false},或遮罩限定在自定义容器内且未设置 maskFixed)打开时同样移入焦点,但不锁定 Tab,页面其余部分保持可用。关闭时只在焦点仍在对话框内或已落到 body 时归还,用户已移到页面其他位置的焦点不动。挂载在 body 中且 mask={false} 的 Modal 不锁定 body 滚动。
  • 修改 closeOnEsc 默认值为 true,允许用户通过键盘直接关闭 Modal 带来更好的体验

文案规范

  • 命令式 Modal 与 默认 Modal 两种模态对话框的标题使用 动词 + 名词 的格式,无论是陈述句还是问句
✅ 推荐用法❌ 不推荐用法
Edit ticketEdit
Delete form?Are you sure you want to delete form?
  • 两种模态对话框的操作按钮在保证标题描述清楚的前提下,只需要使用标题内的动词即可
✅ 推荐用法❌ 不推荐用法
EditEdit ticket
  • 命令式 Modal 的正文规范
    • 对标题进行具体的解释说明,不要重复标题的信息
    • 确保用户知道在必要时如何采取行动

设计变量

下表是组件内部的 Sass 变量,不能覆写。定制样式请覆写 --semi-* CSS 变量(见 Design Token 页),或写不分层的 CSS 规则。
Sass 变量值用法
$animation_duration-modal-show120ms弹窗打开-动画持续时间
$animation_function-modal-showcubic-bezier(0.215, 0.61, 0.355, 1)弹窗打开-过渡曲线
$animation_delay-modal-show0ms弹窗打开-延迟时间
$animation_duration-modal-hide120ms弹窗关闭-动画持续时间
$animation_function-modal-hidecubic-bezier(0.215, 0.61, 0.355, 1)弹窗关闭-过渡曲线
$animation_delay-modal-hide0ms弹窗关闭-延迟时间
$animation_duration-modal_mask-show90ms弹窗打开时-蒙层颜色-动画持续时间
$animation_function-modal_mask-showcubic-bezier(0.215, 0.61, 0.355, 1)弹窗打开时-蒙层颜色-过渡曲线
$animation_delay-modal_mask-show0ms弹窗打开时-蒙层颜色-延迟时间
$animation_duration-modal_mask-hide90ms弹窗关闭时-蒙层颜色-动画持续时间
$animation_function-modal_mask-hidecubic-bezier(0.215, 0.61, 0.355, 1)弹窗关闭时-蒙层颜色-过渡曲线
$animation_delay-modal_mask-hide0ms弹窗关闭时-蒙层颜色-延迟时间
$animation_transform_scale-modal_content-open0.7弹窗打开时-缩放比例
$animation_opacity-modal_content-open0弹窗打开时-起始透明度
$animation_transform_scale-modal_content-close0.7弹窗关闭时-缩放比例
$animation_opacity-modal_content-close0弹窗关闭时-起始透明度
$animation_opacity-modal_mask-open0弹窗打开时-蒙层起始透明度
$animation_opacity-modal_mask-close0弹窗关闭时-蒙层起始透明度
$color-modal-bgvar(--semi-color-bg-2)模态框背景颜色
$color-modal_mask-bgvar(--semi-color-overlay-bg)模态框蒙层颜色
$color-modal_main-textvar(--semi-color-text-0)模态框文字颜色
$color-modal_info-iconvar(--semi-color-info)模态框信息图标颜色
$color-modal_primary-iconvar(--semi-color-primary)模态框主要图标颜色
$color-modal_success-iconvar(--semi-color-success)模态框成功图标颜色
$color-modal_danger-iconvar(--semi-color-danger)模态框危险图标颜色
$color-modal_warning-iconvar(--semi-color-warning)模态框警告图标颜色
$color-modal_content-bordervar(--semi-color-border)模态框描边颜色
$color-modal_header-bgtransparent模态框 header 背景填充色
$color-modal_footer-bgtransparent模态框 footer 背景填充色
$spacing-modal-marginY80px模态框距容器顶部外边距
$spacing-modal-marginXauto模态框水平外边距(默认居中)
$spacing-modal_mask-top0模态框蒙层顶部位置
$spacing-modal_mask-right0模态框蒙层右侧位置
$spacing-modal_mask-bottom0模态框蒙层底部位置
$spacing-modal_mask-left0模态框蒙层左侧位置
$spacing-modal_content_withicon-marginLeft36px模态框蒙层左侧位置
$spacing-modal_icon_wrapper-marginRight$spacing-base-tight模态框图标右侧外边距
$spacing-modal_wrap-top0
$spacing-modal_wrap-right0
$spacing-modal_wrap-bottom0
$spacing-modal_wrap-left0
$spacing-modal_title-margin0模态框标题外边距
$spacing-modal_content-paddingY0模态框内容垂直内边距
$spacing-modal_content-paddingX24px模态框内容水平内边距
$spacing-modal_header-marginY24px模态框标题垂直外边距
$spacing-modal_header-marginX0模态框标题水平外边距
$spacing-modal_header-paddingY0
$spacing-modal_header-paddingX0
$spacing-modal_body_wrapper-marginY24px
$spacing-modal_body_wrapper-marginX0
$spacing-modal_body-margin0模态框 body 外边距
$spacing-modal_body-padding0模态框 内容外Padding
$spacing-modal_footer-marginY24px模态框 footer 垂直外边距
$spacing-modal_footer-marginX0模态框 footer 水平外边距
$spacing-modal_footer-paddingY0
$spacing-modal_footer-paddingX0
$spacing-modal_footer_button-marginLeft$spacing-base-tight模态框 footer 按钮左侧外边距
$spacing-modal_confirm_header-marginBottom8px命令式调用模态框 header 底部外边距
$spacing-modal_confirm_icon_wrapper-marginRight$spacing-base-tight命令式调用模态框图标右侧外边距
$spacing-modal_content_fullscreen-top0px模态框内容全屏顶部位置
$width-modal_title100%模态框标题宽度
$width-modal_content100%模态框内容宽度
$height-modal_contentmax-content模态框内容高度
$width-modal_content-border1px模态框内容描边宽度
$width-modal_small448px模态框宽度 - 小
$width-modal_medium684px模态框宽度 - 中
$width-modal_large920px模态框宽度 - 大
$width-modal_full_widthcalc(100vw - 64px)模态框宽度 - 全屏
$radius-modal_contentvar(--semi-border-radius-large)模态框圆角大小
$radius-modal_content_fullscreen0模态框圆角大小 - 全屏
$radius-modal_footer0 0 5px 5px模态框 footer 圆角大小
$font-modal_header-fontSize$font-size-regular模态框 title 字号
$font-modal_header-fontWeight$font-weight-bold模态框 title 字重
$color-modal_header-bordertransparent模态框 header 底部描边颜色
$width-modal_header-border0模态框 header 底部描边宽度
$color-modal_footer-bordertransparent模态框 footer 顶部描边颜色
$width-modal_footer-border0模态框 footer 顶部描边宽度
$shadow-modal_contentvar(--semi-shadow-elevated)
$filter-modal_mask-bgnone
$filter-modal_content-bgnone

FAQ

  • 为什么使用 LocaleProvider 后, Modal.confirm 确认、取消按钮的文本没有国际化?

    命令式的 Modal 渲染在组件树之外,读不到 ConfigProvider、LocaleProvider 的配置,因此内置文本无法自动适配国际化。你可以通过 okText 和 cancelText 这两个属性来根据 Locale 重新设置文本,也可以在组件初始化时调用 Modal.useModal(),让它在 ConfigProvider 或者 LocaleProvider 的子组件里创建对话框,即可使 Modal 获取到对应的配置。

  • 为什么 title 和 content 的间距在命令式调用和非命令式调用下不同?

    命令式调用场景下,标题和内容的相关性更强,所以用更近的距离表达这种强相关性,符合预期。用户如果不想要这种效果,可以自己做样式覆盖。