结果
用于反馈一系列操作任务的处理结果。
何时使用
当有重要操作需告知用户处理结果,且反馈内容较为复杂时使用。
代码演示
- Success ·
success - Info ·
info - Warning ·
warning - 403 ·
403 - 404 ·
404 - 500 ·
500 - Error ·
error - 自定义 icon ·
customIcon - 自定义语义结构的样式和类 ·
style-class
API
通用属性参考:通用属性
| 参数 | 说明 | 类型 | 默认值 | 版本 | 全局配置 |
|---|---|---|---|---|---|
| classNames | 自定义组件内部各语义化结构的类名。支持对象或函数 | Record<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string> | - | 6.0.0 | 6.0.0 |
| extra | 操作区 | ReactNode | - | × | |
| icon | 自定义 icon | ReactNode | - | × | |
| status | 结果的状态,决定图标和颜色 | success | error | info | warning | 404 | 403 | 500 | info | × | |
| styles | 自定义组件内部各语义化结构的内联样式。支持对象或函数 | Record<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties> | - | 6.0.0 | 6.0.0 |
| subTitle | subTitle 文字 | ReactNode | - | × | |
| title | title 文字 | ReactNode | - | × |
Semantic DOM
| 语义节点 | 原生说明 | 版本 |
|---|---|---|
root | 根元素,包含文本对齐、布局样式等基础容器样式 | 6.0.0 |
icon | 图标元素,包含外边距、文本对齐、字体大小、状态颜色等图标样式 | 6.0.0 |
title | 标题元素,包含字体大小、文字颜色、行高、对齐方式等文字样式 | 6.0.0 |
subTitle | 副标题元素,包含字体大小、文字颜色、行高等文字样式 | 6.0.0 |
extra | 操作区域元素,包含外边距、文本对齐、内部元素间距等布局样式 | 6.0.0 |
body | 内容元素,包含外边距、内边距、背景色等内容区域样式 | 6.0.0 |
语义说明来源: vendor/components/result/demo/_semantic.tsx
主题变量(Design Token)
类型、继承关系和原生令牌声明保持固定源码原文;默认值由原生主题计算,并可能受 ConfigProvider 覆盖。本表不伪造静态默认值。
| 令牌 | 类型 | 原生说明 |
|---|---|---|
titleFontSize | number | string | 标题字体大小 |
subtitleFontSize | number | 副标题字体大小 |
iconFontSize | number | string | 图标大小 |
extraMargin | CSSProperties['margin'] | 额外区域外间距 |
声明来源: vendor/components/result/style/index.ts
import type { CSSProperties } from 'react';
import type { CSSObject } from '@ant-design/cssinjs';
import { unit } from '@ant-design/cssinjs';
import { isNumber } from '../../_util/is';
import type { FullToken, GenerateStyle, GetDefaultToken } from '../../theme/internal';
import { genStyleHooks, mergeToken } from '../../theme/internal';
export interface ComponentToken {
/**
* @desc 标题字体大小
* @descEN Title font size
*/
titleFontSize: number | string;
/**
* @desc 副标题字体大小
* @descEN Subtitle font size
*/
subtitleFontSize: number;
/**
* @desc 图标大小
* @descEN Icon size
*/
iconFontSize: number | string;
/**
* @desc 额外区域外间距
* @descEN Margin of extra area
*/
extraMargin: CSSProperties['margin'];
}
interface ResultToken extends FullToken<'Result'> {
imageWidth: number | string;
imageHeight: number | string;
resultInfoIconColor: string;
resultSuccessIconColor: string;
resultWarningIconColor: string;
resultErrorIconColor: string;
}
原生通用属性
Tips: 以下通用属性适用于 antd 大部分组件,不支持的组件会单独说明。
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| style | 自定义样式 | CSSProperties | - |
| className | 自定义类名 | string | - |
| rootClassName | 添加在组件最外层的 className | string | - |
| autoFocus | 自动获取焦点,仅对表单类、链接、交互容器等可聚焦元素生效 | boolean | false |
安装并复现示例
npm install antd@6.6.5 @ant-design/icons@6.3.4 dayjs@1.11.23
使用 ConfigProvider 和原生 App,并单独配置 dayjs 语言。每个示例在查看代码中列出完整源码文件和额外固定依赖。示例名称用于选择演示,不是组件通用属性。主题、语言与 SSR 初始化见资源安装指南。
原生类型参考
源码查看器包含未修改的原生实现和以下声明文件,继承类型仍位于原生包中。代码中的英文注释保留为源码参考。
vendor/components/result/index.tsxvendor/components/result/style/index.ts
来源与许可
https://github.com/ant-design/ant-design/tree/4a39f54842eade4e565ab336ef6097cd7e723cdd
保留原生中英文正文与可执行示例;官网专用的嵌入章节和令牌表格在本地展开。Ant Design 使用 MIT 许可,另列依赖的许可证也需保留。上传预览禁止向外发起请求,不提供后端服务。