Alert

theme
view
corners
title
message
import {Alert} from '@gravity-ui/uikit';

主题 (theme)

normal:主要主题(默认使用)。

info:用于任何常规信息。

success:用于积极信息。

warning:用于需要注意的信息。

danger:用于严重错误。

utility:用于有用的提示。

NormalNormal theme
InfoInfo theme
SuccessSuccess theme
WarningWarning theme
DangerDanger theme
UtilityUtility theme
<Alert theme="normal" title="Normal" message="Normal theme" />
<Alert theme="info" title="Info" message="Info theme" />
<Alert theme="success" title="Success" message="Success theme" />
<Alert theme="warning" title="Warning" message="Warning theme" />
<Alert theme="danger" title="Danger" message="Danger theme" />
<Alert theme="utility" title="utility" message="Utility theme" />

视图 (view)

filled:用于调整警告框的背景颜色(默认使用)。

outlined:用于调整警告框的边框颜色。

FilledFilled view
OutlinedOutlined theme
<Alert title="Filled" message="Filled view" view="filled" />
<Alert title="Outlined" message="Outlined theme" view="outlined" />

布局 (layout)

vertical:如果有带按钮的 actions 属性,用于引导用户到内容。它允许在文本下方显示按钮(默认使用)。

horizontal:如果有带按钮的 actions 属性,用于引导用户到内容。它允许在文本右侧显示按钮。

VerticalVertical direction
HorizontalHorizontal direction
<Alert layout="vertical" title="Vertical" message="Vertical direction" actions={<Alert.Action>button</Alert.Action>} />
<Alert layout="horizontal" title="Horizontal" message="Horizontal direction" actions={<Alert.Action>button</Alert.Action>} />

边角 (corners)

rounded:启用警告框窗口的圆角(默认使用)。

square:启用警告框窗口的方角。

RoundedRounded corners
SquareSquare corners
<Alert title="Rounded" message="Rounded corners" corners="rounded"  />
<Alert title="Square" message="Square corners" corners="square" />

警告框标题

title:警告框标题。它的优先级低于 Alert.Title

some text
<Alert title={<Alert.Title className={'some-class'} text="some text"></Alert.Title>} />

警告框消息

message:警告框消息。它应该足够有意义,能够完全解释警告框的内容。

onClose

onClose:当用户点击警告框的关闭按钮时调用的回调函数。当定义了此属性时,关闭按钮将可见。

Alert has closeAlert has close
<Alert onClose={() => alert('Close button pressed')} title="Alert has close" message="Alert has close" />

对齐 (align)

确定 Alert 组件内部内容的垂直对齐方式。

baseline:默认对齐方式。

center:内容在 Alert 组件内垂直居中。如果操作占用的空间比文本多,或者图标必须位于内容中间,这可能很有用。

BaselineBaseline align
CenterCenter align
<Alert align="baseline" theme="info" title="Baseline" message="Baseline align" actions={<Alert.Action>button</Alert.Action>} />
<Alert align="center" theme="info" title="Center" message="Center align" actions={<Alert.Action>button</Alert.Action>} align="center"/>

属性

名称描述类型默认值
theme警告框外观"normal" "info" "success" "warning" "danger" "utility""normal"
view启用/禁用警告框的背景颜色"filled" "outlined""filled"
layout如果有带按钮的 actions 属性,用于引导用户到内容"vertical" "horizontal""vertical"
corners用于警告框窗口的圆角/方角"rounded" "square""rounded"
title警告框标题string
message警告框消息React.ReactNode
onClose当用户点击警告框的关闭按钮时调用的回调函数Function
actions按钮数组或完整的自定义组件React.ReactNode "AlertAction"
align确定 Alert 组件内部内容的垂直对齐方式"center" "baseline""baseline"
styleHTML style 属性React.CSSProperties
className警告框类名string
icon覆盖默认图标React.ReactNode
qaHTML data-qa 属性,用于测试string